ForHosting KIT · 日付・時間

ISO日付から四半期内の週番号を計算

日付を入力すると、その四半期の第何週かが分かります。2026年5月20日は、4月1日から数えて第2四半期の第8週です。第1週は常に四半期の最初の7日間です。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
日付
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からも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

POSThttps://api.kit.forhosting.com/date/week-number-in-quarter

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"}'
{
  "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リクエストまでです。

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

HTTPコード意味
401unauthorizedAPIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
402insufficient_balance残高が不足しています。チャージ後に再度お試しください。
404unknown_type指定されたタスクタイプは存在しません。タイプ名を確認してください。
429rate_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です。

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