ISO日付から四半期内の週番号を計算
日付を入力すると、その四半期の第何週かが分かります。2026年5月20日は、4月1日から数えて第2四半期の第8週です。第1週は常に四半期の最初の7日間です。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 日付
- 2026-05-20
- 年
- 2,026
- 四半期
- 2
- 四半期の開始日
- 2026-04-01
- 週番号
- 8
明示したISO日付を、Q1、Q2、Q3、Q4内の再現可能な週位置に変換します。四半期の初日を第1週の起点とし、以後7日ごとに番号を増やします。現在時刻、ローカルタイムゾーン、外部カレンダーは参照しません。そのため、どの環境でも同じ値が必要なダッシュボード、レポート処理、検証規則、テストに適しています。実在する日付をYYYY-MM-DD形式で送信すると、正規化日付、年、四半期、四半期開始日、1始まりの週番号を返します。
四半期内の週番号の定義
この計算では、暦四半期の開始日を基準に7日単位で区切ります。Q1は1月1日、Q2は4月1日、Q3は7月1日、Q4は10月1日に始まります。最初の7日が第1週、次の7日が第2週となり、同じ規則で続きます。
開始後に完了した日数を整数で7除し、1を加えて算出します。月曜日始まりで四半期境界をまたぐ場合があるISO週番号とは異なります。四半期初日にリセットする報告、キャンペーン、目標に適した規則です。
四半期の日数は一定でないため、最終週が7日未満になる場合や第14週に達する場合があります。うるう年は世紀年の例外を含むグレゴリオ暦の規則で処理します。
日付の入力と検証
dateには、2026-05-20のような厳密なYYYY-MM-DD形式を指定してください。追加文、地域固有の表記、タイムスタンプ、先頭のゼロがない値は推測せず拒否します。年は0001から9999、月は01から12で、日はその月に実在する必要があります。
JavaScriptのDate、実行環境のタイムゾーン、システム時計は使いません。数値要素を検証し、範囲の限られた整数演算だけを行うため、保存した要求を再実行しても結果は同じです。
レポートと自動処理での利用
四半期相対の週番号は、四半期単位の業務に使いやすい短いラベルです。製品チームは、年内週番号が異なっても複数四半期の第3週を比較できます。定期エクスポート時に各日付へ情報を追加すれば、データウェアハウスでも集計規則が明確になります。
対象は暦日であり営業日ではありません。週末や祝日を除外せず、月曜日開始も強制せず、4-4-5小売暦や独自会計年度にも対応しません。履歴再処理では「今日」ではなく、アプリケーション側の日付を明示してください。
活用例
四半期業績ダッシュボード
日付付きKPIへ一貫した四半期週を付与し、複数の暦四半期を比較します。
キャンペーン進捗管理
タイムゾーンに左右されず、活動日を該当する7日間の区分へ割り当てます。
よくある質問
第1週は月曜日に始まりますか?
いいえ。 四半期の最初の暦日から始まり、以後の各区分は7日間です。
ISO年内週番号と同じですか?
いいえ。 ISO週は月曜日始まりで四半期をまたぎますが、この番号は各四半期でリセットします。
第14週になることはありますか?
はい。 四半期は90、91、92日のため、末尾の日付が第13週または第14週に入ります。
タイムスタンプや地域形式を使えますか?
いいえ。 タイムゾーン変換や曖昧さを避けるため、正確なYYYY-MM-DDを指定してください。
各四半期はいつ始まりますか?
第1四半期は1月1日、第2四半期は4月1日、第3四半期は7月1日、第4四半期は10月1日に始まります。その日ごとに数え直し、第1週に戻ります。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/date/week-number-in-quarter \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-05-20"}'const res = await fetch("https://api.kit.forhosting.com/date/week-number-in-quarter", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2026-05-20"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/week-number-in-quarter",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2026-05-20"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/week-number-in-quarter", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2026-05-20"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2026-05-20"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/week-number-in-quarter", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"date": "2026-05-20"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.week_number_in_quarter",
"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 | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
四半期内の週番号の定義
応答には基準を確認できるquarter_startも含まれます。
日付の入力と検証
2月29日はグレゴリオ暦のうるう年だけ有効で、不可能な日付はinvalid_inputになります。APIで成功した計算は1件$0.002で、ブラウザーでは同じ純粋な計算をローカル実行します。監査には元のISO日付とquarter_startを保存してください。
レポートと自動処理での利用
売上ダッシュボードでは、前四半期の週を混在させず、年、四半期、week_numberで集計できます。1月、4月、7月、10月の各1日前後をテストし、week_numberが1へ戻ることを確認できます。ISO年内週は別フィールドに保存してください。
連携の活用例
ウェアハウスデータ補完
集計や履歴再処理の前に、年、四半期、quarter_start、week_numberを追加します。
技術的な質問
計算料金はいくらですか。
ブラウザーでは無料です。成功したAPI要求は1件あたり$0.002です。