dinero-formatting について
アプリ内の Dinero.js の金額を整形するためのガイドです。表示、ロケール対応、非十進通貨、シリアライズの指針を開発者向けにまとめています。
主な機能
- 01小数表示の指針
- 02Intl.NumberFormat による通貨整形
- 03ロケール別フォーマッター
- 04スナップショットのシリアライズ
- 05BigInt 用 JSON replacer
- 06非十進通貨の処理
活用シーン
- 01UI で価格や合計を表示
- 02多言語サイト向けの数値整形
- 03API やストレージ向けの Dinero オブジェクトのシリアライズ
- 04非十進の補助単位を持つ通貨の整形
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ dinerojs/ skills --skill dinero-formattingインストール後、Claude Code で/dinero-formattingを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
rules/_sections.mddisplay-no-currency-symbols.mddisplay-to-decimal.mdlocale-intl-formatter.mdlocale-multilingual.mdnondecimal-to-units.mdserialization-bigint-json.mdserialization-snapshot.md詳細
Dinero.js のフォーマット
表示用に Dinero.js の金額をフォーマットするためのパターンです。通貨記号、ロケールに応じたフォーマット、小数単位ではない通貨、シリアライズについて説明します。
適用する場面
次のような場合に、これらのガイドラインを参照してください。
- UI で価格、合計金額、または金額を表示する場合
- 通貨記号やロケール固有のフォーマットを追加する場合
- 小数単位ではない通貨(基数が 10 ではない細分単位を持つ歴史的な通貨など)をフォーマットする場合
- API、データベース、または転送用に Dinero オブジェクトをシリアライズする場合
- 再利用可能なフォーマットユーティリティを構築する場合
優先度別のルールカテゴリ
| 優先度 | カテゴリ | 影響 | 接頭辞 |
|---|---|---|---|
| 1 | 表示 | 重大 | display- |
| 2 | ロケール | 高 | locale- |
| 3 | シリアライズ | 高 | serialization- |
| 4 | 小数単位ではない通貨 | 中 | nondecimal- |
クイックリファレンス
1. 表示(重大)
display-to-decimal- 表示用文字列にはtoSnapshotではなくtoDecimalを使用するdisplay-no-currency-symbols- Dinero.js は通貨記号をフォーマットしません。Intl.NumberFormatと組み合わせてください
2. ロケール(高)
locale-intl-formatter-Intl.NumberFormatで再利用可能なフォーマッターを作成するlocale-multilingual- 多言語サイト向けに、ロケールをパラメーターとして受け取るフォーマッターを作成する
3. シリアライズ(高)
serialization-snapshot- 表示用ではなく、転送と保存にはtoSnapshotを使用するserialization-bigint-json- BigInt の Dinero オブジェクトにはカスタム JSON リプレーサーが必要
4. 小数単位ではない通貨(中)
nondecimal-to-units- 小数単位ではない通貨にはtoDecimalではなくtoUnitsを使用する
使用方法
詳しい説明とコード例については、個々のルールファイルをお読みください。
rules/display-no-currency-symbols.md
rules/locale-intl-formatter.md
各ルールファイルには、次の内容が含まれています。
- 重要な理由についての簡潔な説明
- 説明付きの誤ったコード例
- 説明付きの正しいコード例
- 追加の背景情報と参考資料
コメント
Markdown 対応