ForHosting KIT · 開発者向けツール

金額のパーセントを計算

この割合計算機は、割引、予算、レポート、請求書、比較でよく使われる2種類の計算に対応します。金額と割合を入力すると、250の18パーセントのように該当する値を求められます。2つの金額が既知で、最初の金額が2番目の何パーセントに当たるかを知りたい場合は、逆算を選択します。処理は決定論的で、正または負の有限数を受け付けます。逆算の基準額がゼロの場合は、ゼロ除算による割合が定義できないため、明確なエラーを返します。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

金額に対する割合の値を求める

金額と適用する割合が分かっている場合は、percentage_of_amount を選択してください。割合を100で割り、その係数を金額に掛けて計算します。たとえば、12パーセントは250を掛ける前に0.12へ変換されます。整数の割合だけでなく、2.5のような小数や100を超える割合にも対応します。また、会計上の調整など、符号がデータ上の意味を持つ場合は負の値も利用できます。返されるのは計算された割合部分だけであり、元の金額にその値を加減した合計ではありません。割引額を求める場合は結果を元の価格から差し引き、割増額なら結果を加えてください。割合部分を独立して返すことで、増額か減額かを勝手に仮定せず、さまざまな処理で再利用できます。各入力は有限のJSON数値である必要があります。未入力、数値を表す文字列、無限大、数値ではない文字列は推測で変換せず、エラーとして扱います。

一方の金額が基準額の何パーセントかを求める

割合に当たる値と基準額が既知の場合は、percentage_one_amount_is_of_another を選択してください。この処理ではamountをbase_amountで割り、その商に100を掛けます。180件を基準として45件が条件を満たす場合、結果は25パーセントです。符号付き残高、差分、基準を超える値を扱うときは、結果が負になったり100を超えたりすることがあります。数学的に有効な結果を一般的な表示範囲へ強制的に収めることはありません。基準額をゼロにはできません。ゼロを基準とする有限の割合は定義できないためです。一方、基準額がゼロでなければamountがゼロでも有効で、結果はゼロパーセントになります。入力順序にもご注意ください。45が180の何パーセントかという質問と、180が45の何パーセントかという質問では答えが異なります。base_amountには、合計、目標、基準、比較対象となる値を指定してください。

フォームや自動処理で信頼できる結果を利用する

ブラウザー計算機とAPIは同じ純粋な計算処理を使うため、保存したリクエストはどこで実行しても同じ結果になります。出力には、選択した処理、関連する入力値、計算結果が含まれます。そのため、非表示のフォーム状態に依存せず、ログや後続の変換内容を確認できます。小数は、パーセント記号、通貨記号、桁区切りを付けずに入力してください。たとえば、7.5は七・五パーセントを表します。APIの料金は1リクエスト当たり $0.002 で、ブラウザーではローカル実行も可能です。ネットワーク照会、乱数、時刻、外部データは計算に影響しません。財務レポートで使う場合、この計算機は一般的な数値結果を返し、通貨固有の丸め規則は適用しない点にご注意ください。結果を受け取った後、お使いのシステムで必要な小数桁と会計規則を適用してください。極端に大きな値によって有限数の範囲外になる場合は、利用できない無限大を返さず、入力エラーとして明示的に拒否します。

活用例

割引額を計算する

表示価格から差し引く前に、割引率に相当する金額を求められます。

目標に対する進捗を測る

完了量が、ゼロではない目標、割当量、予定総数の何パーセントかを確認できます。

割合フィールドを自動化する

請求書、レポート、ダッシュボード、データ検証処理で決定論的な割合を生成できます。

よくある質問

計算料金はいくらですか？

APIは1リクエスト $0.002 です。ブラウザーでも計算を実行できます。

結果に元の金額も含まれますか？

含まれません。割合計算では該当部分だけを返します。必要に応じて別途加算または減算してください。

小数や負の割合も使えますか？

はい。小数、負数、100を超える値を含む、有限の数値割合を指定できます。

基準額がゼロだと拒否されるのはなぜですか？

逆算では基準額による除算を行います。ゼロ除算は定義されないため、有限の割合結果を求められません。

金額はどのように丸めればよいですか？

一般的な数値結果を受け取った後、通貨や会計システムで定められた丸め規則を適用してください。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/calc2/percentage-of-amount

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

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

curl -X POST https://api.kit.forhosting.com/calc2/percentage-of-amount \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operation":"percentage_of_amount","amount":250,"percentage":12}'

const res = await fetch("https://api.kit.forhosting.com/calc2/percentage-of-amount", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "operation": "percentage_of_amount",
    "amount": 250,
    "percentage": 12
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/calc2/percentage-of-amount",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "operation": "percentage_of_amount",
    "amount": 250,
    "percentage": 12
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/calc2/percentage-of-amount", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"operation":"percentage_of_amount","amount":250,"percentage":12}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"operation":"percentage_of_amount","amount":250,"percentage":12}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/calc2/percentage-of-amount", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "operation": "percentage_of_amount",
  "amount": 250,
  "percentage": 12
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "calc2.percentage_of_amount",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

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