# @finanzfluss/calculators 中文文档

规范地址：https://npmcn.com/package/%40finanzfluss/calculators/

版本：2\.1\.0
npm 元数据更新时间：2026-11-04T13:49:02.216Z
中文译文更新时间：2026-11-14T18:33:33.960Z
软件包许可：AGPL-3\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40finanzfluss/calculators
原文对照：https://npmcn.com/package/%40finanzfluss/calculators/?lang=original
项目主页：https://github.com/finanzfluss/calculators#readme
源码仓库：https://github.com/finanzfluss/calculators

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：701 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：zod ^4\.1\.5，dinero\.js ^2\.0\.2，bignumber\.js ^9\.3\.1，@formulajs/formulajs ^4\.5\.3
- 首次发布：2025-06-25T11:04:39.688Z
- 最新版本发布：2026-11-04T13:49:01.575Z
- 近 30 天下载量：8795（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 17 个）

## 中文简介

Finanzflus 的财务计算器

## 安装

```sh
npm install @finanzfluss/calculators
```

也可以使用：`pnpm add @finanzfluss/calculators`、`yarn add @finanzfluss/calculators`、`bun add @finanzfluss/calculators`

## README

![Logo for @finanzfluss/calculators Repository](https://npmcn.com/package/%40finanzfluss/calculators/.github/calculators-icon.svg)

# @ finanzfluss/ 计算器

Finanzfluss网站使用的一些财务计算器: [https://www.finanzfluss.de/rechner/ (中文(简体) )](https://www.finanzfluss.de/rechner/)

🎯 **类型安全**: 使用 TypeScript 和 Zod 验证构建

🔍 **真实世界测试**:数百万Finanzflus用户使用

🏛️ **德国税收制度支助**: 正确的税收和保险计算

  

## 安装

```bash
# pnpm
pnpm add -D @finanzfluss/calculators

# npm
npm install -D @finanzfluss/calculators

# yarn
yarn add -D @finanzfluss/calculators
```

  

## 计算器

### 复合利息计算器

辛辛斯雷克纳人[https://finanzfluss.de/rechner/zinseszinsrechner 页面存档备份,存于互联网档案馆](https://www.finanzfluss.de/rechner/zinseszinsrechner/)) 证明长期财富建设的复合利息的力量. 它计算了投资在回报被再投资后如何随着时间增长,帮助用户可视化复合效应对其储蓄的影响.

#### 关键特性 :

-   **灵活启动资本** 支持一次总付投资和零初始资本设想
-   **定期储蓄计划** 可配置的每月付款额,用于系统投资模式
-   **多个复合间隔** 每月、季度和年度复合期
-   **长期预测** 从短期投资到十年投资期限
-   **利率敏感性分析** 显示收益的微小变化对最终财富的重大影响
-   **视觉数据输出** 提供资本增长与复合利息积累的详细细目
-   **真实的返回模型** 合理利率范围验证(-10000%至10000%)

```ts
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 页面存档备份,存于互联网档案馆](https://www.finanzfluss.de/rechner/sparrechner/))是一个多功能的财务规划工具,在提供所有其他变量时计算储蓄计划中的任何未知变量。 它通过解决最终价值、启动资本、利率、期限或支付金额等问题,帮助用户规划储蓄目标.

#### 关键特性 :

-   **弹性计算模式** 解决五个变量中的任何一个:最终价值、启动资本、利率、持续时间或支付额
-   **税收优化计算** 支持分配和积累有资本收益税考虑的投资类型
-   **部分免税** 模拟德国对资金的部分豁免(Teilfreistellung)
-   **多个保存间隔** 支持每月和年度付款时间表
-   **视觉生长跟踪** 为图表提供详细的资本和利息积累数据

```ts
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.finanzfluss.de/rechner/brutto-netto-rechner/))从毛收入中计算出净工资,核算所有德国税收和社会保险扣除额. 它根据德国财政部提供的税务计算官方假代码: [https://www.bmf-steuerrechner.de/interface/pseudocodes.xhtml (中文(简体) )](https://www.bmf-steuerrechner.de/interface/pseudocodes.xhtml)。 。 。 .

#### 关键特性 :

-   **所有6个德国税级** (一至六)对单身、已婚和离婚的个人进行具体计算
-   **具体国家的计算** 所有16个德国州,包括不同的教会税率(巴伐利亚/巴登-符腾堡州为8%,其他地方为9%)
-   **基于年龄的调整** 包括64年以上老年公民减税
-   **子女津贴** 支助部分儿童(例如混合家庭的0.5个子女)
-   **灵活的保险办法** 支持公共(GKV)和私人(PKV)健康保险
-   **综合社会保险** 包括养恤金、失业和护理保险的计算

```ts
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 页面存档备份,存于互联网档案馆](https://www.finanzfluss.de/rechner/rentenversicherung/)将基于ETF的养恤金保险(Netto Police)与传统的ETF退休规划储蓄计划进行比较.

#### 关键特性 :

-   **ETF 养恤金保险分析** 比较净政策与直接ETF投资
-   **税收优化计算** 包括保险对投资收益的不同征税规则
-   **费用结构分析** 计入管理费、安置佣金和持续收费
-   **长期预测** 具有现实回报假设(多样化股票组合通常为7%)
-   **灵活撤出方案** 支持一次总付和逐步撤出战略
-   **真实世界成本模型** 使用实际保险产品数据和收费结构

```ts
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 页面存档备份,存于互联网档案馆](https://www.finanzfluss.de/rechner/berufsunfaehigkeitsversicherung/)帮助用户确定他们需要多少残疾保险。 它将三个标准覆盖率水平与当前收入进行比较,并模拟残疾不同阶段的收入差距.

#### 关键特性 :

-   **三个DIN 77230覆盖率** 根据德国的私人家庭财务分析标准:确保基本生存(避免社会福利),维持你目前的生活水平,提高生活水平,包括财产、家庭或财富建设等额外目标
-   **收入时间表建模** 显示每个阶段的实际回家情况:工作、短期病假、长期疾病(Krankengeld)和完全残疾(Erwerbsminderungsrente)
-   **自定义覆盖输入** 在三个标准级别之外,支持用户确定的目标养恤金数额
-   **视觉数据输出** 为图表提供表级比较和基于间隔的覆盖数据

```ts
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 页面存档备份,存于互联网档案馆](https://www.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,进入单独的二级仓库,或消费
-   **支付阶段模型** 包括两个仓库可选一次性一次总付和随后每年提取的税款

```ts
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和所得税储蓄

```ts
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)

```ts
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'
```

  

## 测试

运行测试套件 :

```bash
pnpm test
```

运行类型检查 :

```bash
pnpm test:types
```

进行覆盖报告测试 :

```bash
pnpm test:coverage
```

  

## 许可证

[AGPL-3.0 导弹](https://npmcn.com/package/%40finanzfluss/calculators/LICENSE) 许可证 2025-Present [资本流股份有限公司](https://www.finanzfluss.de/impressum/)

## 常见问题

### @finanzfluss/calculators 是什么？

Finanzflus 的财务计算器

### 如何安装 @finanzfluss/calculators？

在项目目录运行 npm install @finanzfluss/calculators，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^4\.1\.5）、dinero\.js（^2\.0\.2）、bignumber\.js（^9\.3\.1）、@formulajs/formulajs（^4\.5\.3）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @finanzfluss/calculators 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @finanzfluss/calculators 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @finanzfluss/calculators 可以商用吗？

@finanzfluss/calculators 使用 AGPL-3\.0 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @finanzfluss/calculators 的下载量有多少？

根据 npm 官方下载统计，@finanzfluss/calculators 在 2026/10/15 – 2026/11/13 这 30 天内被下载 8,795 次，日均约 293 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @finanzfluss/calculators 还在维护吗？

最新版本 2\.1\.0 发布于 2026/11/04（10 天前）；至今共发布 28 个版本，其中过去 12 个月发布了 17 个；首次发布于 2025/06/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。