dinerojs/dinero.js

Dinero.js позволяет безопасно создавать, рассчитывать и форматировать деньги в JavaScript и TypeScript.
dinerojs.com

---

Деньги — это сложная система, и примитивы языка недостаточны для их правильного представления. Dinero.js — это библиотека на JavaScript, которая позволяет выражать денежные значения, а также выполнять мутации, конвертации, сравнения, форматирование и в целом делает манипуляцию деньгами проще и безопаснее в вашем приложении.

✨ Особенности

• Неизменяемая и чистая: каждая операция возвращает новый объект, без побочных эффектов
• Type-safe: первоклассная поддержка TypeScript с полным выводом типов
• Встряхиваемый деревом: импортируйте только то, что используете, оставьте пакеты маленькими
• Подключаемая точность: по умолчанию используйте number или bigint для больших объёмов
• Недесятичные валюты: поддержка любой базы, включая валюты с несколькими подразделениями
• Фреймворк-агностик: работает везде, где работает JavaScript

📦 Установка

⚡️ Быстрый старт

Dinero объекты минимальны. Каждая функция в dinero.js свободна от побочных эффектов, позволяя объединять только то, что вы используете.

Посмотрите краткое руководство по документации.

📚 Документация

Документация позволяет узнать обо всех аспектах библиотеки.

Dinero.js lets you create, calculate, and format money safely in JavaScript and TypeScript. dinerojs.com

---

Money is complex, and the primitives of the language aren’t enough to properly represent it. Dinero.js is a JavaScript library that lets you express monetary values, but also perform mutations, conversions, comparisons, formatting, and overall make money manipulation easier and safer in your application.

✨ Features

• Immutable & pure: every operation returns a new object, no side effects
• Type-safe: first-class TypeScript support with full type inference
• Tree-shakeable: import only what you use, keep bundles small
• Pluggable precision: use number by default or bigint for large amounts
• Non-decimal currencies: support for any base, including multi-subdivision currencies
• Framework-agnostic: works everywhere JavaScript runs

📦 Install

npm install dinero.js

# or

yarn add dinero.js

⚡️ Quick start

Dinero objects are minimal. Every function in dinero.js is side-effect free, allowing you only to bundle exactly what you use.

import { dinero, add, toDecimal } from 'dinero.js';
import { USD } from 'dinero.js/currencies';

const d1 = dinero({ amount: 500, currency: USD });
const d2 = dinero({ amount: 800, currency: USD });

const total = add(d1, d2);

toDecimal(total); // "13.00"

Check out the quick start guide on the documentation.

📚 Documentation

The documentation lets you learn about all aspects of the library.