GDP成長率計算

前期GDPがゼロの場合、率が定義できないため invalid_input で拒否します。

GDP成長が意味することと小数の率がどう定義されるか

previous_gdp が前期の水準、current_gdp が後期の水準なら、恒等式は growth_rate が current_gdp から previous_gdp を引き、previous_gdp で割った値です。小数を返すことで、パーセント表示を自前で整える表計算、API、テストの契約が誠実に保たれます。測定産出の崩壊は100パーセントの実質収縮であり、growth_rate はマイナス1です。

入力契約、応答の形、誤り時の振る舞い

値は有限数で、ゼロであってはなりません。前期ゼロが契約上の誤りであり、課金されません。有限数でなければならず、前期の公表値より高くても等しくても低くても構いません。検証失敗は残高を消費しません。同じ通貨・同じ単位の有限数2つを必須とする JSON 本体を POST してください。previous_gdp は前期の国内総生産で、成長率の分母です。表計算が慣れた列名を保てるよう、previous、gdp_previous、gdp0、earlier_gdp、gdp_t0 の別名を受け付けます。previous_gdp が欠落、空、無限、またはちょうどゼロなら、タスクは previous_gdp を名指しして invalid_input で失敗します。current_gdp は後期の国内総生産です。current、gdp_current、gdp1、later_gdp、gdp_t1 の別名は同じ欄を指します。各欄は JSON 数でも数値文字列でも届きます。成功時、本体は previous_gdp と current_gdp をエコーし、change を今期マイナス前期として half-up で小数第10位まで丸め、growth_rate を小数の率として half-up で小数第10位まで丸め、率の符号に応じて direction を expansion、contraction、unchanged のいずれかにし、恒等式を述べる formula 文字列を含めます。例：前期100、今期103なら growth_rate は 0.03、change は3、direction は expansion です。前期2万、今期1万8千なら growth_rate は負の 0.1、direction は contraction です。

GDP成長率計算が役に立つ場面

報道デスク、調査デスク、教室は、統計発表が2つのGDP水準を印刷し、問いが相対変化であって、その水準を生んだ支出面の恒等式の再構築ではないときに、GDP成長率計算を使います。家計や学生は、文を書くまで小数をパーセントに換えずに、昨年のGDPと今年のGDPを比べ、測定経済が拡大したか収縮したかを見ます。あとで成長ではなくGDPの水準や、多年の複合成長率が必要になったときは、この2点のGDP成長契約を引き伸ばさず、それらの専用恒等式を使ってください。プロダクトチームは同じ契約をブリーフィングツールに結び、公式の2点を入力した記者が、あとでテスト一式で API が返すのと同一の growth_rate を見るようにします。実装が tier A の純粋 parse であるため、成功した呼び出しは毎回、公表された基本料金 $0.002 であり、モデルトークンも外向きネットワークもありません。リクエストを小さく保ち、テストで丸めた growth_rate を固定すれば、国民経済計算クライアントを自前で立てずに、表計算、LMSプラグイン、エッジワーカー向けの再現可能な小数成長が得られます。