ForHosting KIT · 開発者向けツール

XはYの何パーセント？割合計算ツール

部分の数と全体の数が分かっているとき、この計算ツールは部分が全体の何パーセントに当たるかを示します。18は24の何パーセントか、得点が満点の何割か、予算のうちどれだけを使ったか、といった日常的な疑問に答えられます。部分と全体を入力して小数点以下の桁数を選ぶと、外部サービスや表計算ファイルを使わずに、再現可能なパーセント、比率、計算式を得られます。

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

無料で実行 API仕様を見る

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

部分と全体を正しく見分けます

まず、どちらの値が部分で、どちらが全体かを確認します。部分とは比較したい量であり、全体とは完全な1単位、つまり100パーセントを表す基準です。24点満点で18点を取った場合、18が部分、24が全体です。28人のクラスで21人が課題を提出した場合は、21が部分、28が全体です。値を逆にすると別の問いへの答えになるため、「獲得点 ÷ 満点」「使用量 ÷ 利用可能量」「完了数 ÷ 計画数」のように整理すると正しく入力できます。全体をゼロにはできません。ゼロによる除算には定義されたパーセントがないためです。一方、部分はゼロでも構いません。予定した12件のうち完了が0件なら、正確に0パーセントです。数学的な比較では有限の負数も利用できますが、通常の得点、件数、数量では負でない値が一般的です。計算前に、両方の値の単位もそろえてください。円同士、点数同士、キログラム同士のように比較します。

パーセントの式を適用して結果を読み取ります

計算には「パーセント = 部分 ÷ 全体 × 100」という標準式を使います。18を24で割ると比率は0.75になり、それを100倍すると75パーセントです。結果が100パーセント未満なら部分は全体より小さく、ちょうど100パーセントなら両者は同じです。100パーセントを超える場合は、部分が基準となる全体を上回っています。たとえば30を24と比べると125パーセントです。パーセントは必ずしも100を上限としません。出力される比率は、パーセントへ変換する前の同じ関係を示します。表計算ソフトやプログラムが0.75のような小数を必要とするときに便利です。計算式の文字列には入力した数の配置が表示されるため、式の立て方を確認したり、計算方法を説明したり、入力の逆転に気付いたりできます。小数点以下の桁数は用途に合わせて選んでください。概算には整数で十分なことが多い一方、成績、調査、測定では1桁または2桁が必要な場合があります。丸めによって変わるのは表示だけで、計算対象の数学的な関係は変わりません。

学習や日常業務で結果を適切に使います

パーセントを使うと共通の尺度ができ、全体の異なる結果を比べやすくなります。18点中24点ではなく、24点中18点という得点と、40点中30点という得点は、合計点が異なっていてもどちらも75パーセントです。ただし、同じ尺度に直せることが、比較の公平さを保証するわけではありません。試験ごとに配点の重みが違う場合や、予算の対象期間が異なる場合、調査標本の人数や構成が異なる場合があります。特に他者へ結果を伝えるときは、パーセントと併せて部分と全体も示してください。複数段階の計算では途中で早く丸めすぎると、最終結果がわずかに変わることがあります。このツールは部分と全体を1回直接比較し、指定した桁数でパーセントと比率を丸めます。増減率の計算、既知のパーセントから未知の部分を求める計算、重み付き項目の合算は行いません。これらは関連していますが別の計算です。入力が同じ母集団と期間に対応するか確認してください。自動処理ではAPIリクエスト1回につき$0.002です。値の欠落、有限でない数、範囲外の数、全体のゼロ、未対応の桁数には、誤解を招く結果ではなく明確な入力エラーを返します。

活用例

得点をパーセントに換算します

獲得点を満点と比較し、小テスト、試験、課題の結果をパーセントで示します。

進捗を測定します

完了した作業、提出済みの書類、完成した項目を、予定総数に対する割合で表します。

全体に占める部分を要約します

予算、在庫、標本、出席者総数のうち、ある数量が占める割合を計算します。

よくある質問

XがYの何パーセントかを求める式は何ですか？

XをYで割り、100を掛けます。この計算ツールでは、Xが部分、Yが全体です。

18は24の何パーセントですか？

18を24で割ると0.75です。これに100を掛けると75パーセントになります。

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

はい。部分が全体より大きいと100パーセントを超えます。たとえば30は24の125パーセントです。

全体をゼロにできないのはなぜですか？

式では全体で割りますが、ゼロによる除算は定義されていないため、全体がゼロの入力は受け付けません。

APIリクエストの料金はいくらですか？

APIリクエストは1回$0.002です。ブラウザー版でも同じ再現可能な計算を端末内で実行できます。

開発者向け — APIアクセス

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

エンドポイント

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

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

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

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

const res = await fetch("https://api.kit.forhosting.com/edu/what-percent-is", {
  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/edu/what-percent-is",
    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/edu/what-percent-is", 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/edu/what-percent-is", 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": "edu.what_percent_is",
  "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の完全なドキュメントを見る →