ROI 計算ツール

計算式と金額の解析

金額に対する二進浮動小数点の誤差を避けるため、両方の入力は算術演算の前に BigInt で整数セントに解析されます。1200」「1200.5」「1200.50」はいずれも有効ですが、先頭のプラス記号、「01000」のような余分なゼロ、指数表記、小数点が 2 つ以上、あるいは JavaScript の浮動小数点リテラルは、いずれも不正な形式として拒否されます。investment は除算を定義できるよう 0 セントより大きい値に解析される必要があります。dev.roi は投資収益率を（return_amount − investment）÷ investment × 100 として計算し、それを生み出す net_profit も同時に返します。例の 1000 と 1200 は 100000 セントと 120000 セントになり、net_profit は 200.00、roi_percent は 20.00 となります。各フィールドは非負の安全な整数、または小数部が最大 2 桁の正規形の小数文字列を受け付けます。「return_amount は 0 でもよく、それは全損を表し、−100.00 パーセントとなります。

整数セントとゼロから離れる方向の half-up

整数除算の前に除数の半分を加え、損失の場合は符号を反映するため、ちょうど −0.5 の値はゼロ方向ではなく −1 に丸められます。残る 100 分の 2 の部分が、パーセント文字列の小数 2 桁になります。経路全体が正確な整数演算であるため、結果はあらゆるプラットフォームでバイト単位まで同一であり、同じセント規則に従う独立したオラクルが各文字列を最後の桁まで再現します。roi_percent は浮動小数点では決して計算されません。すべて BigInt の中で処理され、エンジンは profit_cents × 10000 を作り、それを investment_cents で割る際に明示的な half-up・ゼロから離れる方向の手順を踏みます。return_amount が investment を下回ると、net_profit と roi_percent はどちらも先頭にマイナスを持ちます。1000 を投資して 800 が戻ると、net_profit は −200.00、roi_percent は −20.00 と表示されます。

出力・エラー・実行できる場所

成功した応答はいずれも 4 つの小数 2 桁の文字列を返します。設計は意図的に狭く保たれており、バージョン 1 では年率換算もポートフォリオの加重も通貨換算も行いません。そのため公開される表面は短く、監査しやすくなっています。失敗したタスクが前払い残高に課金されることはありません。正規形に整えられた investment と return_amount、符号付きの net_profit、そして roi_percent です。エラー経路は安定した照合可能なメッセージを用い、いずれも型付きの invalid_input としてスローされます。investment または return_amount の欠落、investment が 0、フィールド名の前に negativo と示される負の値、そして不正な形式として報告される不正な金額です。同じ JSON 契約が $0.002 からの有料 API を支えるため、案件の一括スクリーニングやスプレッドシートの列のサーバー側検証が行えます。