@ finanzfluss/ 计算器
Finanzfluss网站使用的一些财务计算器: https://www.finanzfluss.de/rechner/ (中文(简体) )
🎯 类型安全: 使用 TypeScript 和 Zod 验证构建
🔍 真实世界测试:数百万Finanzflus用户使用
🏛️ 德国税收制度支助: 正确的税收和保险计算
安装
# pnpm
pnpm add -D @finanzfluss/calculators
# npm
npm install -D @finanzfluss/calculators
# yarn
yarn add -D @finanzfluss/calculators
计算器
复合利息计算器
辛辛斯雷克纳人https://finanzfluss.de/rechner/zinseszinsrechner 页面存档备份,存于互联网档案馆) 证明长期财富建设的复合利息的力量. 它计算了投资在回报被再投资后如何随着时间增长,帮助用户可视化复合效应对其储蓄的影响.
关键特性 :
- 灵活启动资本 支持一次总付投资和零初始资本设想
- 定期储蓄计划 可配置的每月付款额,用于系统投资模式
- 多个复合间隔 每月、季度和年度复合期
- 长期预测 从短期投资到十年投资期限
- 利率敏感性分析 显示收益的微小变化对最终财富的重大影响
- 视觉数据输出 提供资本增长与复合利息积累的详细细目
- 真实的返回模型 合理利率范围验证(-10000%至10000%)
import { compoundInterest } from '@finanzfluss/calculators'
const input = {
startCapital: 5000,
monthlyPayment: 100,
durationYears: 10,
yearlyInterest: 7,
type: 'monthly', // 'monthly', 'quarterly', or 'yearly'
}
// Validate input and calculate compound interest result
const result = compoundInterest.validateAndCalculate(input)
console.log(result.finalCapital) // Total capital after compound growth
console.log(result.totalPayments) // Sum of all payments made
console.log(result.totalInterest) // Total interest earned through compounding
console.log(result.diagramData) // Detailed growth data for visualization
节省计算器
斯帕雷克纳https://finanzfluss.de/rechner/sparrechner 页面存档备份,存于互联网档案馆)是一个多功能的财务规划工具,在提供所有其他变量时计算储蓄计划中的任何未知变量。 它通过解决最终价值、启动资本、利率、期限或支付金额等问题,帮助用户规划储蓄目标.
关键特性 :
- 弹性计算模式 解决五个变量中的任何一个:最终价值、启动资本、利率、持续时间或支付额
- 税收优化计算 支持分配和积累有资本收益税考虑的投资类型
- 部分免税 模拟德国对资金的部分豁免(Teilfreistellung)
- 多个保存间隔 支持每月和年度付款时间表
- 视觉生长跟踪 为图表提供详细的资本和利息积累数据
import { savings } from '@finanzfluss/calculators'
const input = {
output: 'endValue', // What to calculate: 'endValue', 'startValue', 'yearlyInterest', 'monthlyDuration', or 'savingRate'
startValue: 10000,
savingRate: 200,
saveIntervalType: 'monthly', // 'monthly' or 'yearly'
savingType: 'inAdvance', // 'inAdvance' or 'inArrear'
yearlyInterest: 7,
interestIntervalType: 'monthly', // 'monthly', 'quarterly', or 'yearly'
yearlyDuration: 20,
considerCapitalGainsTax: true,
capitalGainsTax: 26.375,
distributionType: 'accumulating', // 'accumulating' or 'distributing'
partialExemption: 30,
useCompoundInterest: true,
}
// Validate input and calculate savings result
const result = savings.validateAndCalculate(input)
console.log(result.endValue) // Final portfolio value
console.log(result.deposits) // Total amount deposited
console.log(result.interestAfterTax) // Net interest earned after tax
console.log(result.yearlyDuration) // Duration in years
console.log(result.monthlyDuration) // Duration in months
console.log(result.diagramData) // Detailed capital and interest growth data
Gross-to-Net 计算器
布鲁托-内特-雷克纳https://finanzfluss.de/rechner/brutto-netto-rechner 页面存档备份,存于互联网档案馆)从毛收入中计算出净工资,核算所有德国税收和社会保险扣除额. 它根据德国财政部提供的税务计算官方假代码: https://www.bmf-steuerrechner.de/interface/pseudocodes.xhtml (中文(简体) )。 。 。 .
关键特性 :
- 所有6个德国税级 (一至六)对单身、已婚和离婚的个人进行具体计算
- 具体国家的计算 所有16个德国州,包括不同的教会税率(巴伐利亚/巴登-符腾堡州为8%,其他地方为9%)
- 基于年龄的调整 包括64年以上老年公民减税
- 子女津贴 支助部分儿童(例如混合家庭的0.5个子女)
- 灵活的保险办法 支持公共(GKV)和私人(PKV)健康保险
- 综合社会保险 包括养恤金、失业和护理保险的计算
import { grossToNet } from '@finanzfluss/calculators'
const input = {
inputAccountingYear: '2025',
inputTaxClass: 1,
inputTaxAllowance: 0,
inputChurchTax: 0,
inputState: 'Hamburg',
inputYearOfBirth: 1990,
inputChildren: 0,
inputChildTaxAllowance: 0,
inputPkvContribution: 0,
inputPpvContribution: 0,
inputEmployerSubsidy: 0,
inputPensionInsurance: 0,
inputLevyOne: 0,
inputLevyTwo: 0,
inputActivateLevy: 0,
inputHealthInsurance: 0,
inputAdditionalContribution: 1.7,
inputGrossWage: 5000,
inputPeriod: 2, // 2 = monthly, 1 = yearly
}
// Validate input and calculate gross to net result
const result = grossToNet.validateAndCalculate(input)
console.log(result.outputResNetWageMonth) // Net monthly wage
console.log(result.outputResNetWageYear) // Net yearly wage
净策略计算器
伦特弗西切伦-雷克纳(Rentenversicherung-Rechner)https://finanzfluss.de/rechner/rentenversicherung 页面存档备份,存于互联网档案馆将基于ETF的养恤金保险(Netto Police)与传统的ETF退休规划储蓄计划进行比较.
关键特性 :
- ETF 养恤金保险分析 比较净政策与直接ETF投资
- 税收优化计算 包括保险对投资收益的不同征税规则
- 费用结构分析 计入管理费、安置佣金和持续收费
- 长期预测 具有现实回报假设(多样化股票组合通常为7%)
- 灵活撤出方案 支持一次总付和逐步撤出战略
- 真实世界成本模型 使用实际保险产品数据和收费结构
import { netPolicy } from '@finanzfluss/calculators'
const input = {
// General inputs
savingRate: 250,
duration: 35, // in years
taxAllowance: 1000,
additionalIncome: 0,
capitalGainsTax: 26.375,
// Policy inputs
placementCommission: 299,
savingRateCosts: 4,
balanceCosts: 0.22,
fixedCosts: 10,
minimumCosts: 30,
// ETF inputs
ter: 0.2,
expectedInterest: 7,
partialExemption: 30,
// Reallocation inputs
reallocationOccurrence: 10,
reallocationRate: 40,
}
// Validate input and calculate net policy result
const result = netPolicy.validateAndCalculate(input)
console.log(result.tableData.netWorth) // Projected net worth over time
残疾保险计算器
贝鲁夫松活佛(Berufsunfähigkeitsversicherung-Rechner) 维基百科中的相关条目: 贝鲁夫松活佛https://finanzfluss.de/rechner/berufsunfaehigkeitsversicherung 页面存档备份,存于互联网档案馆帮助用户确定他们需要多少残疾保险。 它将三个标准覆盖率水平与当前收入进行比较,并模拟残疾不同阶段的收入差距.
关键特性 :
- 三个DIN 77230覆盖率 根据德国的私人家庭财务分析标准:确保基本生存(避免社会福利),维持你目前的生活水平,提高生活水平,包括财产、家庭或财富建设等额外目标
- 收入时间表建模 显示每个阶段的实际回家情况:工作、短期病假、长期疾病(Krankengeld)和完全残疾(Erwerbsminderungsrente)
- 自定义覆盖输入 在三个标准级别之外,支持用户确定的目标养恤金数额
- 视觉数据输出 为图表提供表级比较和基于间隔的覆盖数据
import { disabilityInsurance } from '@finanzfluss/calculators'
const input = {
grossIncome: 4000,
netIncome: 2600,
useCustomHalfDisabilityPension: false, // set to true to override the estimated value
customHalfDisabilityPension: 0,
numberOfChildren: 1, // affects care insurance contribution rate (0–4)
useCustomPensionAmount: false,
customPensionAmount: 0,
}
// Validate input and calculate disability insurance result
const result = disabilityInsurance.validateAndCalculate(input)
result.tableData.level1 // Level 1: basic existence security (DIN 77230 Stufe 1)
result.tableData.level2 // Level 2: maintaining current standard of living (DIN 77230 Stufe 2)
result.tableData.level3 // Level 3: improved standard of living (DIN 77230 Stufe 3)
AV- 选取计算器
阿尔特斯沃尔索热德波特-雷克纳(英语:Altersvorsorgedepot-Rechner (film))https://finanzfluss.de/rechner/altersvorsorgedepot 页面存档备份,存于互联网档案馆将储蓄比作受补贴的AV-Depot(Altersvorsorgedepot)与定期的ETF经纪仓库退休。 它模拟两个账户的全部储蓄和支付阶段,核算国家补贴(Grundzulage、Kinderzulage、Berufseinsteigerbonus)、Vorabauschale税收和退款的税务处理(Güntigerprüfung、Halbeinkünfteverfahren).
关键特性 :
- 逐个仓库比较 预测AV-Depot和正常仓库的资本逐年增长,捐款和收益相同
- 国家补贴 包括Grundzulage、每个合格儿童的幼儿园和25岁以下储蓄者的Berufseinsteigerbonus
- 可配置的减税处理 让AV缴款的所得税退款回流到AV-Depot,进入单独的二级仓库,或消费
- 支付阶段模型 包括两个仓库可选一次性一次总付和随后每年提取的税款
import { avDepot } from '@finanzfluss/calculators'
const input = {
age: 35,
retirementAge: 67,
zveSavingsPhase: 50_000,
zveRetirement: 20_000,
savingsRate: 1_800,
etfReturnRate: 6, // percent
avDepotCosts: 0.2, // percent, annual AV-Depot cost drag
exemptionOrder: 1_000,
taxSavingsMode: 'avDepot', // 'avDepot' | 'secondaryDepot' | 'consume'
baseRate: 0, // percent, Basiszins for Vorabpauschale
oneTimePayout: 0, // percent taken as a lump sum at retirement
payoutReturnRate: 3, // percent
payoutUntilAge: 85,
childBirthYears: [], // enables Kinderzulage while children are under 18
}
// Validate input and calculate AV-Depot result
const result = avDepot.validateAndCalculate(input)
result.finalCapital.avDepot // Capital in the AV-Depot at retirement
result.finalCapital.normalDepot // Capital in a comparable normal depot at retirement
result.payoutTotal.net.avDepot // Total net payout from the AV-Depot
AV- 电站模拟器
AV-Depot的计算自行进行,不与正常的仓库进行比较. 它是 AV- Depot 计算器的核心. 它返回原始数字而不是格式化的字符串.
关键特性 :
- 与 AV- Depot 计算器相同的输入,加两个可选字段以转入 AV- Depot
- 启动资本 (单位:千美元)
startCapital)作为补贴资本处理:它从第一年开始增长,被征税,就像补贴资本的支付,没有获得祖拉根的收入,也不算作自己的贡献 - 可选的贝鲁芬斯泰格博努斯 (单位:千美元)
includeStarterBonus(d) 扣除已经领取的奖金,例如在转让的里斯特合同中 - 补贴和减税总额 grundzulage、Kinderzulage、Berufseinsteigerbonus和所得税储蓄
import { avDepotSimulator } from '@finanzfluss/calculators'
const result = avDepotSimulator.validateAndCalculate({
...input, // same input as for the AV-Depot Calculator
startCapital: 25_000, // optional, defaults to 0
includeStarterBonus: false, // optional, defaults to true
})
result.savings.finalCapital // Capital in the AV-Depot (incl. secondary depot) at retirement
result.savings.totalGrundzulage // Sum of all Grundzulagen
result.payout.totalNet // Total net payout
Riester 或 AV- Depot 计算器
将维持现有的里斯特公司合同与将其资本转入AV-Depot公司和继续在那里提供捐款相比较。 这两种设想都是通过节省和支付阶段预测的。 结果包括就哪一种选择作出裁定.
关键特性 :
- 合同转让 将目前的里斯特合同价值移入AV-Depot,减去合同不足五年的切换费用
- 里斯特回报率 人工输入或来源于合同价值、缴款和津贴总额(如果合同太年轻或缺少投入,又回到违约率)
- 里斯特支付 根据合同的年金系数作为终身年金(Rentenfaktor/10,000欧元)
- 判决 包括资本差额、补贴差额、两种选择的月净支付率和直至支付阶段结束时的生存概率(Destatis Priedensterbetafel)
import { riesterOrAvDepot } from '@finanzfluss/calculators'
const input = {
age: 42,
retirementAge: 67,
zveSavingsPhase: 30_000,
zveRetirement: 20_000,
riesterAnnualContribution: 1_200, // own contribution per year
riesterContractValue: 18_500, // current value of the Riester contract
riesterContractStart: 2012,
riesterTotalContributions: 9_000, // optional, used to derive the return rate
riesterTotalAllowances: 2_500, // optional, used to derive the return rate
// riesterReturnRate: 2, // optional, percent, overrides the derived rate
riesterAnnuityFactor: 32.5, // monthly annuity per 10,000 € capital
riesterSwitchingCosts: 150,
etfReturnRate: 6, // percent
avDepotCosts: 0.2, // percent, annual AV-Depot cost drag
oneTimePayout: 0, // percent taken as a lump sum at retirement
payoutReturnRate: 3, // percent
payoutUntilAge: 85,
childBirthYears: [],
}
const result = riesterOrAvDepot.validateAndCalculate(input)
result.finalCapital.avDepot // Capital in the AV-Depot at retirement
result.finalCapital.riester // Capital in the Riester contract at retirement
result.riesterReturnRate.case // 'manual' | 'derived' | 'missingInputs' | 'tooShort' | 'tooHigh' | 'tooLow'
result.verdict.case // 'avDepotWins' | 'riesterWins' | 'mixed'
测试
运行测试套件 :
pnpm test
运行类型检查 :
pnpm test:types
进行覆盖报告测试 :
pnpm test:coverage
许可证
AGPL-3.0 导弹 许可证 2025-Present 资本流股份有限公司