ForHosting KIT · 開発者向けツール

ある数が全体の何パーセントかを計算

この計算機は、「ある数は別の数の何パーセントか」という一般的な疑問に答えます。比較する部分と、ゼロではない基準となる全体を入力してください。部分を全体で割り、その結果に100を掛けます。比率、パーセント、計算式をまとめて返すため、結果の確認、説明、別の処理への利用が容易です。正数、負数、小数、全体を上回る値にも対応しています。

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

無料で実行 API仕様を見る

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

部分と全体を正しく選びます

最初に、どちらの数が部分で、どちらが全体かを決めます。部分はパーセントで表したい量であり、全体は比較における完全な1単位を示す基準です。たとえば、24人のクラスで18人が課題を提出した場合、18が部分、24が全体です。順序を逆にすると別の問いへの答えになるため、数の大小よりも役割が重要です。部分が全体より小さい必要はありません。24に対する30は125パーセントとなり、基準の1.25倍であることを示します。文脈上適切であれば、小数や負数も使用できます。ただし、全体をゼロにはできません。ゼロに対する割合を有限のパーセントで表せないためです。結果を使う前に、「部分は全体の何パーセントか」と文章にして確認すると、入力の取り違えを防げます。

計算方法と結果を理解します

式は「パーセント = 部分 ÷ 全体 × 100」です。まず除算によって比較を比率に変え、100を掛けて百分率で表します。部分が18、全体が24なら、比率は0.75、パーセントは75です。応答には両方が含まれるため、用途に合う表現を利用できます。比率1は100パーセントに相当し、1未満なら大きさは100パーセント未満、1を超えれば100パーセントを上回ります。部分がゼロで全体がゼロでなければ、答えは0パーセントです。符号も保持され、異符号の数では負、2つの負数では正の結果になります。計算にはJavaScriptの標準的な浮動小数点演算を使用し、返す数値を自動的には丸めません。表示や報告では、分野に適した桁数で丸めてください。

文脈を保ってパーセントを使います

パーセントは異なる尺度の量を比較しやすくしますが、全体が明確な場合にだけ意味を持ちます。報告では、75パーセントだけを示すのではなく、「登録者24人中18件の提出、つまり75パーセント」のように基準も記載してください。総数が変化する場合、記録を除外する場合、複数のチームが異なる分母を使う場合には特に重要です。100パーセントを超える値は誤りではなく、部分が選択した全体を上回ることを示します。負の結果も数学的には有効ですが、符号が何を表すか説明することをお勧めします。自動処理では業務上の意味を確認し、全体がゼロ、または値が有限でない場合の入力エラーを処理してください。API は決定的で、ネットワークを使用しません。基本料金は $0.002 です。監査が必要な場合は、元の部分と全体も結果と一緒に保存してください。

活用例

完了率を報告します

完了した項目を割り当て総数と比較し、両方の元の値をパーセントとともに保存します。

予算使用率を測定します

支出額をゼロではない承認予算の割合として表し、100パーセントを超える場合にも対応します。

測定値を比較します

測定値を基準値に対するパーセントへ変換し、ダッシュボード、確認、説明に利用します。

よくある質問

どの計算式を使用しますか？

(部分 / 全体) × 100 を計算します。応答には100倍する前の比率も含まれます。

100パーセントを超えることはありますか？

はい。100パーセントを超える結果は、部分が基準として使った全体より大きいことを示します。

全体がゼロの場合はなぜ拒否されますか？

ゼロによる除算では有限のパーセントを得られないため、無効な入力としてエラーを返します。

小数や負数も使用できますか？

はい。有限の数値である部分と、有限かつゼロではない数値である全体を使用できます。

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

API リクエスト1回につき $0.002 です。ブラウザーでは同じ決定的な計算をローカルで実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/algebra/is-what-percent-of

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

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

curl -X POST https://api.kit.forhosting.com/algebra/is-what-percent-of \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"part":18,"whole":24}'

const res = await fetch("https://api.kit.forhosting.com/algebra/is-what-percent-of", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "part": 18,
    "whole": 24
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/algebra/is-what-percent-of",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "part": 18,
    "whole": 24
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/algebra/is-what-percent-of", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"part":18,"whole":24}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"part":18,"whole":24}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/algebra/is-what-percent-of", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "part": 18,
  "whole": 24
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "algebra.is_what_percent_of",
  "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の完全なドキュメントを見る →