ForHosting KIT · 金融・お金

前年比成長率計算

Q: 今年値は昨年値より低くてもよいですか？

はい。 後の数字が先より下なら decline です。同じ数字なら零を返し、direction は unchanged です。

昨年100から今年112に増えれば、前年比成長率は12%です。結果は0.12ではなくパーセントでそのまま表示されます。同じ単位の昨年の値と今年の値を入力してください。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

前の値: 100
現在値: 112

結果

変化: 12
成長率 (%): 12
方向: growth

前年比成長は、ある量の一年から翌年への相対変化を、昨年値に対する百分率として表したものです。創業者、アナリスト、投資家、報道、学生は、すでに持つ二つの数からその率を求めます。昨年の数字と今年の数字です。現在値から前回値を引き、前回値で割り、百を掛けます。この前年比成長率計算はその恒等式を適用し、成長の百分率を返します。百から百十二への動きは小数 0.12 ではなく十二と印字されます。複数年ギャップの年率化、複利化、公式系列の取得は行いません。

前年比成長の意味と百分率の定義

前年比成長率は、連続する二年のあいだで測った量の相対変化です。その結果は小数ではなく百分率です。百から百十二への上昇は十二であり、記者はさらに掛け算せず十二パーセントと引用します。

百分率を返すことで、ダッシュボード、取締役会資料、検索流入がすでに期待する前年比パーセントと契約が一致し、分数 0.12 にはしません。後の値が先より上なら growth、下なら decline、同じならこの尺度では量は動いていません。前回値は分母なので、零であってはなりません。

零で割ることは未定義であり、この計算は Infinity や NaN を返す代わりにその場合を拒否します。現在値は前回値より上でも等しくても下でもよく、零も含みます。測った活動の崩壊は百パーセントの本物の減少だからです。

この道具は複数年ギャップを年率化せず、小数を後から百分率へ直さず、複利化せず、統計機関から公式数字を取得しません。表計算、10-K、教室の問題、ダッシュボードからすでにお持ちの二つの数の上で閉じた式を評価します。小数を返す GDP 専用の成長率でも、n 年にわたる年平均成長率でもありません。

それらは別の検索であり、別の仕事です。

活用例

売上とKPIの取締役会資料

昨年の売上、受注、またはアクティブユーザーと今年の数字を、取締役会資料や貸し手メモが引用できる前年比百分率に変えます。

授業と宿題の答え合わせ

前回年が零なら Infinity を出さず拒否する、再現可能な前年比の模範解答を生成します。

よくある質問

結果は百分率ですか、小数ですか？

百分率です。 100 から 112 への動きは 12 を返します。別の用具の小数を変換するのでなければ、もう一度 100 を掛けないでください。

昨年値が零だとどうなりますか？

前回年が零だと前年比成長は未定義のため、その依頼は課金されません。

今年値は昨年値より低くてもよいですか？

はい。後の数字が先より下なら decline です。同じ数字なら零を返し、direction は unchanged です。

数年にわたる成長にも使えますか？

使えません。比べるのは連続する2年だけで、複利計算や数年分の差を1年あたりに割り振ることはしません。その場合は年平均成長率という別の計算を使います。

どんな数値を前年と比べられますか？

売上、受注、アクティブユーザーなど、両方の年で同じ方法で測った数値なら使えます。2つの値は同じ単位でそろえてください。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/fin/year-over-year-growth

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/fin/year-over-year-growth \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"previous_value":100,"current_value":112}'

const res = await fetch("https://api.kit.forhosting.com/fin/year-over-year-growth", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "previous_value": 100,
    "current_value": 112
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/year-over-year-growth",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "previous_value": 100,
    "current_value": 112
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/year-over-year-growth", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"previous_value":100,"current_value":112}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"previous_value":100,"current_value":112}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/year-over-year-growth", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "previous_value": 100,
  "current_value": 112
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.year_over_year_growth",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

前回値が零の場合、率は未定義のため invalid_input で拒否します。

前年比成長の意味と百分率の定義

previous_value が昨年の数字、current_value が今年の数字なら、恒等式は growth_percent が current_value から previous_value を引き、previous_value で割り、百を掛けたものです。

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

値は有限数で、零であってはなりません。前回年が零であることは契約上の誤りであり、課金されません。有限数でなければならず、昨年の数字より大きくても等しくても小さくても構いません。検証失敗は残高を消費しません。同じ単位の有限数を二つ、必須として JSON 本体に載せ、POST してください。previous_value は昨年の数字であり、率の分母です。表計算が慣れた列名を保てるよう、別名 previous、prior、last_year、year0、previous_year_value を受け付けます。previous_value が欠ける、空、無限、またはちょうど零なら、タスクは previous_value を名指しして invalid_input で失敗します。current_value は今年の数字です。別名 current、later、this_year、year1、current_year_value は同じ欄を指します。各欄は JSON の数でも数値文字列でも届いて構いません。成功時、本体は previous_value と current_value をエコーし、change を現在マイナス前回として half-up で小数第十位まで丸め、growth_percent を百分率として half-up で小数第十位まで丸め、符号に応じて direction を growth、decline、unchanged のいずれかにし、恒等式を述べる formula 文字列を含めます。例：前回が百、現在が百十二なら growth_percent は十二、change は十二、direction は growth です。前回が二十五万、現在が二十万なら growth_percent は負の二十、direction は decline です。

前年比成長率計算が役立つ場面

財務チーム、創業者、教室は、量が昨年から今年へどれだけ変わったかを問うときに前年比成長率計算を使います。長い地平で複利になったかではありません。運営者は昨年の売上、数量、利用者、トラフィックを今年の数字と比べ、取締役会や貸し手へ説明します。あとで多年の複利率や GDP 専用の小数が必要になったら、この二点の前年比契約を引き伸ばすのではなく、それらの専用の恒等式を使ってください。製品チームは同じ契約をダッシュボードへつなぎ、年次合計を二つ入力した創業者が、あとでテスト一式で API が返すのと同じ growth_percent を見られるようにします。実装が純粋な parse の tier A であるため、成功した呼び出しは毎回、公表された基本料金 $0.002 で、モデルのトークンも外向きの網もありません。依頼は小さく保ち、丸めた growth_percent をテストに固定すれば、表計算、LMS プラグイン、エッジワーカー向けに再現可能な前年比百分率が得られ、自前の時系列クライアントを立てる必要はありません。

連携の活用例

ダッシュボードと継続的検査の固定

表計算の点検やテスト一式に growth_percent を固定し、パイプラインとブラウザウィジェットが丸めた百分率で食い違わないようにします。

技術的な質問

二つの年次値から前年比成長を求めるにはどうしますか。

有限数の previous_value（非零）と current_value を送ってください。API は growth_percent = (current_value − previous_value) / previous_value × 100 に加え、絶対変化と方向ラベルを返します。

前年比成長率計算の料金はいくらですか。

ブラウザの用具は無料です。API 依頼は成功一件あたり $0.002 で前払いの KIT 残高を使い、不正な入力は課金されません。

KITの完全なドキュメントを見る →

前年比成長率計算

無料で実行

計算例

前年比成長の意味と百分率の定義

活用例

売上とKPIの取締役会資料

授業と宿題の答え合わせ

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

エラー

技術的な注記

前年比成長の意味と百分率の定義

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

前年比成長率計算が役立つ場面

連携の活用例

ダッシュボードと継続的検査の固定

技術的な質問

ありがとう