ISO週番号計算
日付を入力するとISO週番号が分かります。2024年1月1日は2024年の第1週ですが、2021年1月1日は2020年の第53週に入ります。週年も一緒に表示され、ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 日付
- 2024-01-01
- 年
- 2,024
- 月
- 1
- 日
- 1
- ISO週
- 1
このISO週番号計算ツールは、YYYY-MM-DD形式の単一のグレゴリオ暦日付を受け取り、そのISO-8601週番号と、それら2つの値が属する週年を返します。ISO週は常に月曜日に始まり日曜日に終わり、ある年の第1週はその年の最初の木曜日を含む週です。そのため、12月下旬や1月上旬はしばしばカレンダー上の市民暦年とは異なる週年を報告します。代表的な検証例として、2024-01-01は2024年第1週に、2021-01-01は2020年第53週にマッピングされます。エンジンは決定的な整数暦算術のみを使用します。うるう年、月の長さ、年内通日の序数、ISO曜日は、ネットワーク通信、ランダムサンプリング、ホストの時計に頼ることなく計算されます。
ISO週番号で分かること
ISO-8601の週日付は、月と日のカレンダーとは異なる問いに答えます。すなわち、ある日を、週年の中で1から52または53まで番号が振られた月曜起点の週の中に位置づけます。第1週は、その年の最初の木曜日を含む週と定義され、これは1月4日を含む週と同値です。
この規則のため、12月29日から1月3日までは、請求書上の市民暦年がまだ古い、または新しい番号を示していても、前または次の週年に属することがあります。タイムゾーン変換、ロケール依存の週の開始日、浮動小数点近似はありません。
拒否されるケースには、dateの欠落、2024/01/01のような誤った形式、不可能な月、2023-02-29のような存在しない日が含まれます。Unixエポック、複数形式の解析、営業日算術が必要な場合はそれぞれの専用ツールをご利用ください。このページは、検証済みのカレンダー日付に対するISO週番号と週年のみに答えます。
dateの読み取り方法と週を再現可能に保つ仕組み
文字列は4桁の数字、ハイフン、2桁の数字、もう一つのハイフン、2桁の数字に一致しなければなりません。先頭や末尾の空白はトリムされますが、部分的な日付、通日のみの表記、月名はここでは展開されません。
解析後、年は1から9999の間、月は1から12の間、日はその年のその月の実際の長さの範囲内でなければならず、うるう年は4で割り切れるが400で割り切れない世紀年を除くというグレゴリオ暦の規則に従います。
検証済みの3項組から、エンジンは月の長さを合計して年内通日を計算し、月曜を1、日曜を7とする坂本の純整数法でISO曜日を求め、その上で週番号を(年内通日-曜日+10)を7で割った床として計算します。その週が1未満の場合、その日付は前の週年の最終週に属し、その年の週数を超える場合は次の週年の第1週に属します。
ある年が53のISO週を持つのは、その年の最初または最後の日が木曜日の場合です。
ISO週番号が計画立案・レポーティング・ソフトウェアで役立つ場面
運用チームや財務チームは、週が日曜始まりではない国をまたいで週次のリズムをそろえなければならないときにISO週番号を使います。製造スケジュール、小売の販売実績パック、アジャイルのスプリントラベル、年内週を引用する法定レポートはいずれも、単一の曖昧さのない週IDから恩恵を受けます。
開発者はこの契約をスクリプトから呼び出し、ログバケットにスタンプを押したり、給与計算やタイムシートシステム用の決定的なテストベクターを生成したり、その場しのぎのローカルな週番号ではなくW01からW53までのラベルを要求する製品要件を満たしたりします。
教育者や標準策定者は、ExcelとISOで異なるスプレッドシートのシリアル番号に頼ることなく、2004年第53週の2005-01-01と2005年第1週の2005-01-03のような境界日を実演するためにこのツールを使います。このページでの計算はすべてブラウザ内で完結します。
関連するカレンダー操作が必要なときはエポック変換や日付の正規化と組み合わせ、日付ユーティリティの小さなラボを構築する際は他の無料の決定的なヘルパーと組み合わせてご利用ください。
活用例
週次レポートのラベル
ロケール依存のローカルな週ではなく、安定したISO週と週年のペアをダッシュボード、小売パック、運用レポートに刻印します。
年境界のコンプライアンスチェック
帳簿を締めたり週ベースの統計を提出したりする前に、前または次の週年に属する12月下旬・1月上旬の日付を検証できます。
よくある質問
ISO週番号はどのように定義されますか?
週は月曜から日曜までです。第1週はその年の最初の木曜日を含む週（1月4日を含む週）です。結果は市民暦年とは異なる週年を使うことがあります。
タイムゾーンの変換や現在時刻を使いますか?
Dateオブジェクト、タイムゾーンのシフト、「今日」への依存はありません。
2021年1月1日が2020年の第53週になるのはなぜですか？
第1週はその年の最初の木曜日を含む週と決まっており、2021年1月1日はそれより前にあるためです。そのため、この日は2020年の最後の週である第53週に属します。
週番号のほかに何が表示されますか？
月曜日を1、日曜日を7とする曜日番号と曜日名、2024-W01のような短い表記、その週年に含まれる週の数、年内の通し日数も表示されます。
受け付けられない日付はありますか？
2023-02-29のように実在しない日付や、2024/01/01のように年・月・日をハイフンでつながない書き方は受け付けません。年は1から9999の範囲で入力します。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/date/iso-week-number \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-01-01"}'const res = await fetch("https://api.kit.forhosting.com/date/iso-week-number", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-01-01"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/iso-week-number",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-01-01"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/iso-week-number", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-01-01"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-01-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/iso-week-number", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"date": "2024-01-01"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.iso_week_number",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
制限
year_min | 1 |
year_max | 9999 |
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
計画立案、給与計算、コンプライアンスのワークシートにはブラウザで無料にご利用いただき、CI、レポーティングパイプライン、製品機能で再現可能な週ラベルが必要な場合は、成功したリクエストごとに$0.002のAPIをご利用ください。
ISO週番号とは何か、そしてレスポンスの内容
この計算ツールは厳密なYYYY-MM-DD文字列として必須フィールドdateを1つ受け付け、その日がグレゴリオ暦上に実際に存在すること（うるう年のみの2月29日、すべての月の正しい長さを含む）を検証した上で、正規化された日付、市民暦のyear・month・day、iso_weekとしてのISO週番号、iso_week_yearとしての週年、月曜=1から日曜=7までの読みやすい名前付きISO曜日、2020-W53のようなコンパクトなiso_week_string、その週年が含む週数、年内通日の序数、そして短い式の説明を返します。入力が実在するカレンダー日であれば週のフィールドは完全に決定され、そうでなければinvalid_inputでリクエストは失敗します。
dateの読み取り方法と週を再現可能に保つ仕組み
優先されるフィールドはdateですが、iso_date、d、valueといった別名も受け付けるため、スプレッドシート、クエリ文字列、型付きフォームは列名を変えずに同じ契約を再利用できます。自動化されたパイプライン内で同一の週ラベルが必要な場合は、このページの無料ブラウザ実行と有料APIを組み合わせてご利用ください。
ISO週番号が計画立案・レポーティング・ソフトウェアで役立つ場面
前年同期比のダッシュボードを構築するアナリストは、市民暦年だけでなくiso_weekとiso_week_yearの両方を保存することで、1月上旬の日々が前の週年の第52週または第53週にまだ属しているという典型的なオフバイワンを回避します。API経由では成功した検索1件につき$0.002がかかり、検証に失敗したリクエストは課金されず、レスポンスが返された後は何も保存されません。この無料のインタラクティブな探索と、同一結果を返す有料APIという分割は、KITのtier-Aカタログの他のツールと同様であり、単発のチェックからパイプラインへ、数学的な結果を変えることなく移行できます。
連携の活用例
決定的なテストフィクスチャ
Dateのずれなしに、ユニットテスト、プロパティチェック、CIアサーション向けに再現可能なiso_weekとiso_week_stringの値を生成できます。
技術的な質問
ISO週番号計算ツールの料金はいくらですか?
このページのブラウザ版は無料です。API経由では成功したリクエストごとに$0.002がかかり、無効な入力には課金されません。
iso_week_yearがカレンダー年と異なるのはなぜですか?
12月29日ごろから1月3日ごろまでの日付は、ISO-8601の規則の下でしばしば前の週年の最終週または次の週年の第1週に該当します。
どの日付形式が受け付けられますか?
厳密なYYYY-MM-DD形式のカレンダー日付のみです。2024/01/01、01-01-2024、2023-02-29（非うるう年）のような値はinvalid_inputで拒否されます。