dinerojs/dinero.js

Dinero.js JavaScriptやTypeScriptで安全にお金を作成、計算、フォーマットできます。 dinerojs.com

---

お金は複雑であり、言語のプリミティブだけでは正しく表現できません。Dinero.jsはJavaScriptライブラリで、貨幣の価値を表現できるだけでなく、変異、変換、比較、フォーマットも行い、全体的にアプリケーション内での資金操作をより簡単かつ安全にします。

✨ 特徴

• 不変かつ純粋: すべての操作が新しいオブジェクトを返し、副作用なし
• 型安全: 完全な型推論を伴う一流のTypeScriptサポート
• Tree-shakeable: 使用するもののみインポート、バンドルは小さく保つ
• プラグイン可能な精度: デフォルトで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.