四半期経過割合
2024年2月15日の正午(UTC)には、第1四半期はちょうど半分が過ぎ、割合は0.5です。日付、または時差付きの日時を入力すると、四半期の経過分と残りを秒単位で測った割合が分かります。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 日時
- 2024-02-15T12:00:00Z
- 年
- 2,024
- 月
- 2
- 日
- 15
- 時
- 12
四半期経過割合は、明示された民事時刻において、現在のグレゴリオ暦四半期を時計がどれだけ進んだかを、全日数カウントや年単位の百分率ではなく、ゼロから一までの連続値で答える運用上の問いです。四半期決算を計画する財務チーム、四半期プログレスバーを描く製品ダッシュボード、四半期境界でリセットするSLAカレンダーはいずれも、ホスト機の時計や現地の夏時間表に依存せずその割合を必要とします。本計算機は単一のISO-8601日時(日付のみの文字列はUTC深夜として扱う)を受け取り、瞬間を協定世界時へ変換し、四つの暦四半期のいずれに含まれるかを特定し、四半期最初の深夜からその瞬間までの秒数を測り、四半期の総秒数で割ります。
UTCにおける暦四半期の経過割合の計算方法
まず、すべてのクライアントが同じ民事成分で合意できるよう、ISO-8601形式で書かれた明示的なタイムスタンプから始めます。四桁の年、二桁の月、二桁の日、任意で時・分・秒、本エンジンが整数秒へ切り捨てる小数秒、そしてUTCを示す末尾のZ、または正負の時分オフセットです。時刻部分のない日付のみの文字列は、その民事日のUTC開始深夜として扱います。
パーサは形状不正、範囲外の月、四月三十一日や非閏年の二月二十九日といった不可能な日を拒否し、誤データが架空の進捗値になることを防ぎます。瞬間が確定したら、JavaScriptのDateオブジェクトを決して呼ばない純民事日付算術で、整数秒のUTCエポックへ変換し、ホストのタイムゾーンや夏時間の揺らぎを避けます。UTCの月を標準グレゴリオ暦四半期へ写像します。
一月から三月が第一四半期、四月から六月が第二、七月から九月が第三、十月から十二月が第四です。四半期は最初の月の初日のUTC深夜に始まり、次四半期初日のUTC深夜を排他的終端とするため、四半期最初の一秒の割合はゼロ、最後の一秒は次四半期に入らずに一に近づく割合になります。
経過秒は入力のUTCエポックから四半期開始のUTCエポックを引いた値、四半期長は次四半期開始エポックから現四半期開始エポックを引いた値で、九十・九十一・九十二日の四半期と、第一四半期における閏年の二月の余分な一日を自動的に反映します。残り割合は一からその値を引いたもので、残り秒がカウントダウン表示を完成させます。
四半期経過割合が実務で使われる場面
製品・財務チームはOKRや売上目標、取締役会資料のために四半期プログレスバーを描き、全日数カウンタでは見えない日内進捗も含め、民事四半期境界に合うゼロから一の連続割合を必要とします。四半期開始でエラー予算や容量計画をリセットする運用・SREカレンダーは、同じ割合で現在のUTC瞬間を正規化軸上に置き、アラートと報告に使います。
マーケと営業オペは、ISO形式で固定したローンチやチェックポイント時点で、現四半期のどれだけが既に過ぎたかを問うてキャンペーンやノルマ期間を計画します。
後日、四半期内の全日数だけ、割合なしの四半期番号、特定四半期の包含開始・終了日、年進捗の百分率だけが必要なら、それらは別の検索意図とランディングとして扱い、本ページの四半期経過割合に詰め込みすぎないでください。
活用例
四半期OKR・財務ダッシュボード
任意のISO日時を0〜1の四半期進捗割合へ変換し、プログレスバーと残り割合ラベルを閏対応・UTC安定のままホスト時計なしで保ちます。
SLAとエラー予算カレンダー
現在のチェックポイントを正規化四半期軸上に置き、Q1〜Q4境界でリセットするアラートと報告に使います。
よくある質問
四半期の割合はどのように計算しますか?
fraction = (日時のUTCエポック − 四半期開始のUTCエポック) ÷ (次四半期開始のUTCエポック − 四半期開始)。Q1は1–3月、Q2は4–6月、Q3は7–9月、Q4は10–12月。結果は0と1の間です。
四半期の経過日数と同じですか?
いいえ。 経過日数は四半期開始日から数えた全日数の整数です。本能力は明示日時における四半期全長の連続割合を返し、検索意図が異なります。
閏年で割合は変わりますか?
Q1でははい。 閏年は2月29日を加えるためQ1は90日ではなく91日(7,862,400秒)です。同じ2–3月の瞬間は閏年ではやや小さい割合になります。
日時が無効な場合はどうなりますか?
形状不正、範囲外の月、2023-02-29のような不可能日、無効な時刻成分は拒否され課金されません。
時差付きの日時も入力できますか?
できます。+02:00のような時差やZは先にUTCへ換算してから四半期を決めます。時刻のない日付は、その日のUTCの0時として扱います。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"datetime":"2024-02-15T12:00:00Z"}'const res = await fetch("https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"datetime": "2024-02-15T12:00:00Z"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"datetime": "2024-02-15T12:00:00Z"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"datetime":"2024-02-15T12:00:00Z"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"datetime":"2024-02-15T12:00:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/fraction-of-quarter-elapsed", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"datetime": "2024-02-15T12:00:00Z"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.fraction_of_quarter_elapsed",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
応答には残り割合、経過秒と残り秒、四半期ラベル、包含の開始日と終了日も含まれ、クライアントは一つの決定論的ペイロードから進捗とカウントダウンを描画できます。存在しない暦日や不正なタイムスタンプは黙って補正せず、明確なinvalid_inputエラーで失敗します。無料のブラウザツールと有料APIは同一の純同型関数を共有するため、教材デモと本番パイプラインが同じ入力で食い違うことはありません。
送信内容、戻り値、エラーの扱い
パターンには合うが実在しないグレゴリオ日付(非閏年の二月二十九日や一月から十二月の外の月を含む)も、問題を明示するメッセージで失敗するため、推測せず入力を直せます。典型確認は、一月最初の深夜が第一四半期で割合ゼロ、閏・平年に応じて二月中旬が第一四半期の半分付近、四月最初の一秒が第二四半期でゼロ、四半期末の一秒が同四半期内で一に近づく、などです。無料ブラウザフォームで素早く確認し、イベント一覧の一括変換や回帰フィクスチャが必要なときはスクリプトから同一契約を呼び出してください。必須の文字列フィールドdatetimeに、厳格なISO-8601瞬間(例:二千二十四ハイフン零二ハイフン一五T十二コロン零零コロン零零Z)または日付のみ(例:二千二十四ハイフン零四ハイフン零一)を送ってください。エイリアスdate、iso、at、when、value、onも同じ意味で受け付けるため、既存クライアントはフィールド名を変えずに接続できます。欠落フィールド、非文字列、空文字列、対応ISO形状に合わない文字列はinvalid_inputで失敗し課金されません。成功時の応答はZ接尾辞付きの正規化UTC日時、UTCの年・月・日・時・分・秒の数値、一から四の四半期番号、Q2のようなquarter_label、月範囲の可読文字列、包含のYYYY-MM-DDであるquarter_startとquarter_end、第一四半期の長さに関わるis_leap_year真偽値、整数のelapsed_secondsとremaining_seconds、四半期全長のquarter_seconds、単位区間のfractionとremaining_fraction、UTC定義を記した短いformula文字列をエコーします。成功したAPI呼び出しの価格は公開ベースの$0.002/件で、検証失敗はプリペイド残高を消費しません。
四半期経過割合が実務で使われる場面
本能力は純parseエンジンのため、API価格は成功一件あたり公開ベースの$0.002で、検証失敗は残高を消費しません。
連携の活用例
キャンペーンとノルマのチェックポイント
厳格なISO入力から決定論的な四半期割合でローンチや売上ノルマに印を付け、不正タイムスタンプは明確なinvalid_inputにします。
技術的な質問
費用はいくらですか?
ブラウザツールは無料でローカル実行です。APIは成功一件あたり$0.002のKITプリペイド残高を使い、無効入力は課金されません。