画面で 0.10 と 0.20 の合計が 0.30 に見えても、金額モデルの証明にはならない。toFixed は表示であり、中間計算、負の返金、行ごとの配分を定義しない。二桁にするという説明だけでは、前後のシステムで方向や段階が異なり得る。
ここではソフトウェア上の表現と検証を扱い、会計や税の規則は提案しない。例は二桁と明示した業務通貨だけが対象で、ほかの通貨や高精度資産には別の桁数契約が必要だ。
下書き、業務値、表示を分ける
入力途中の負号や 1. は自然な状態だ。原文の下書きを保ち、送信時に厳密に解析する。表示の通貨記号や桁区切りを計算へ戻さない。
JavaScript Number は二進浮動小数点であり、ECMAScript Numberを参照できる。十進ライブラリーや最小単位整数を選び、範囲、桁数、乗除規則を決める。Number にして百倍する方法は先に二進へ変換するので、汎用の十進解析ではない。
文字列から最小単位へ直接変換する
例は長さを制限し、区切りや指数なし、小数二桁までを受け付け、直接 BigInt のセントを作る。.5、1.、過剰桁、先頭ゼロは拒否する。許すかどうかは製品の選択だが、クライアントとサーバーで統一する。
export function parseCents(text) {
if (typeof text !== 'string' || text.length > 128) {
throw new TypeError('bounded decimal text required');
}
const match = /^(-?)(0|[1-9]\d*)(?:\.(\d{1,2}))?$/.exec(text);
if (!match) throw new Error('invalid two-decimal amount');
const magnitude = BigInt(match[2]) * 100n +
BigInt((match[3] ?? '').padEnd(2, '0'));
return match[1] ? -magnitude : magnitude;
}
export function roundRatioHalfAway(numerator, denominator) {
if (denominator <= 0n) throw new RangeError('positive denominator required');
const sign = numerator < 0n ? -1n : 1n;
const absolute = numerator < 0n ? -numerator : numerator;
const quotient = absolute / denominator;
const remainder = absolute % denominator;
return sign * (quotient + (remainder * 2n >= denominator ? 1n : 0n));
}
console.assert(parseCents('0.10') + parseCents('0.20') === 30n);
console.assert(roundRatioHalfAway(-5n, 2n) === -3n);
BigInt でも無制限入力を許す理由にはならない。JSON へ直接は出せないため、十進整数文字列と単位・通貨を送れる。サーバーも独立して範囲を確認する。
丸めの方向と時点を指定する
例は中点でゼロから離れる方向なので -2.5 は -3 になる。これは選んだ算法で、業務全体の正解ではない。偶数丸め、切り下げ、現金単位への丸めは別の結果になり得る。
行、分類小計、最終合計のどこで丸めるかも決める。各行で丸めた和と、合計後の丸めは違うことがある。率は有理数や十進型で表し、途中を表示文字列へ変えて再解析しない。
配分後も合計を保持する
100 セントを三つへ 33 ずつでは 99 になる。まず 33 を割り当て、残り一つを安定した順で配れば 34、33、33 になる。不均等配分では余りの順序と同点の規則も必要だ。画面順より安定 ID が再現しやすい。
返金では元の配分記録を参照し、現在の並びで再計算しない。並べ替えで返金先の一セントが変わるのを避ける。規則と最終配分を残して、明細と合計を説明できるようにする。
地域化は解析規則の代わりではない
Intl.NumberFormatは表示用で、汎用金額パーサーではない。カンマや空白の意味は地域による。すべてのカンマを削除せず、入力形式と地域を明示する。
大きな整数を表示のためだけに Number へ変換しない。安全な業務範囲か、精度を保つ表示経路を選ぶ。負のゼロも意味のある返金に見せず、例では BigInt によりゼロへ統一される。
一連の不変条件で検証する
最小単位、上限、指数、長すぎる入力、過剰小数、負の中点、配分合計を試す。単位と通貨を含めて通信の往復も確認し、共通資料で前後の結果を照合する。
許す入力、内部表現、丸める段階、余りの配分を契約にする。最後の書式で正常に見せるのでなく、規則から正しさを説明できるようにする。
