ISO週→日付変換
ISO週の表示を実際の日付に変えます。2024年第1週の月曜日は2024年1月1日、2015年第1週の月曜日は2014年12月29日です。第53週がない年の第53週は受け付けません。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 年
- 2,024
- 週
- 1
- 曜日
- 1
- 曜日名
- Monday
- 日付
- 2024-01-01
- カレンダー年
- 2,024
- 月
- 1
このISO週から日付への変換ツールは、ISO-8601の週番号年、1から52または53までの週番号、月曜=1から日曜=7までのISO曜日を、対応するグレゴリオ暦の日をYYYY-MM-DD形式にマッピングします。ISO週日付は、物流、給与計算カレンダー、製造スケジュール、多くのヨーロッパの業務システムで使われる標準です。第1週は常に1月4日を含み、週は常に月曜日に始まり、一部の年は第53週を持ちます。エンジンは純粋な整数のグレゴリオ暦算術のみを使用し、ネットワーク通信もサンプリングもDateオブジェクトも使わないため、同じ入力からは常に同じ日付が得られます。
ISO週から日付への変換が返す内容と失敗する条件
ISO-8601の週日付は、3つの数値、すなわち週番号年Y、その年の最終週までの範囲を持つ週番号W、月曜が1で日曜が7の曜日Dによって1日を特定します。年Yの第1週は、Yの1月4日を含む週、すなわちYの最初の木曜日を含む週として定義されます。この基準点から、エンジンは週単位・曜日単位で前後にたどります。
年境界付近では、結果のグレゴリオ暦の年がISO週年と異なることがあります。たとえば2015年第1週の月曜日は2014-12-29であり、2020年第53週の金曜日は2021-01-01です。ほとんどの年は52週ですが、最初または最後の日が木曜日である年のみ53週を持つため、2024年は52週しかないので2024年第53週は失敗します。
年、週、曜日のいずれかの欠落や非整数の値、1から7の範囲外の曜日、サポートされる1から9999の範囲外の年も拒否されます。タイムゾーンのシフト、ロケール依存の週の開始日、実時計への依存はありません。
活用例
物流と生産スケジュール
発注書や計画に記されたISO週ラベルを、具体的なYYYY-MM-DDの出荷日・生産日に変換します。
給与計算とレポーティングカレンダー
フィルター、エクスポート、期間の締め処理のために、ISO週の期間をグレゴリオ暦の開始日・終了日に解決します。
よくある質問
第53週が拒否されるのはどのような場合ですか?
そのISO週年が52週しか持たない場合です。1月1日または12月31日が木曜日である年のみ53週を持ちます。
カレンダー年とISO週年は異なることがありますか?
はい。 年境界付近の日は、要求されたISO週年に属しながらも、前または次のグレゴリオ暦年に落ちることがよくあります。
このツールはカレンダー日付をISO週に変換しますか?
いいえ。 週年、週、曜日を日付にマッピングするだけです。逆方向にはISO週番号計算ツールをご利用ください。
入力する3つの数字は何を表しますか？
1つ目はISO週年、2つ目は1から52または53までの週番号、3つ目は月曜日を1、日曜日を7とする曜日です。2024、1、1と入力すると2024年1月1日になります。
小数を入れたり空欄にしたりできますか？
いいえ。3つの値はすべて整数で入力します。小数や空欄、文字は受け付けないため、表計算の入力ミスが間違った出荷日になることはありません。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/date/iso-week-to-date \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2024,"week":1,"weekday":1}'const res = await fetch("https://api.kit.forhosting.com/date/iso-week-to-date", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"year": 2024,
"week": 1,
"weekday": 1
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/iso-week-to-date",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"year": 2024,
"week": 1,
"weekday": 1
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/iso-week-to-date", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"year":2024,"week":1,"weekday":1}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"year":2024,"week":1,"weekday":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/iso-week-to-date", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"year": 2024,
"week": 1,
"weekday": 1
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.iso_week_to_date",
"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 | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
すでにご存じかもしれませんが、2024年第1週の月曜日は2024-01-01であり、2015年第1週の月曜日は2014年12月にさかのぼり、52週しかない年の第53週へのリクエストは失敗しなければなりません。計画立案や検証にはブラウザで無料にご利用いただき、CI、ERP連携、教育デモで再現可能なISO週フィクスチャが必要な場合は、成功したリクエストごとに$0.002のAPIをご利用ください。
ISO週から日付への変換が返す内容と失敗する条件
この変換ツールはその3項組を、拡張形式YYYY-MM-DDの単一のカレンダー日付文字列に加え、構造化された暦年・月・日のフィールド、人間可読な曜日名、2024-W01のような正規のiso_week_string、そして検証に用いたweeks_in_iso_year件数に解決します。週番号がその年の週数を超える場合、リクエストはinvalid_inputで拒否されます。この経路は決定的な日付を構築するか、フォーム、ユニットテスト、APIクライアントに適した明確なメッセージとともに失敗します。
year・week・weekdayの読み取り方法と日付を再現可能に保つ仕組み
整数文字列や安全なBigIntは、文書化された範囲内の整数として解析できる場合に受け付けられ、小数、空文字列、非数値トークンは拒否されるため、不正なセルが誤った出荷日につながることはありません。計算は週番号年の1月4日から始まり、坂本方式の純整数算術でそのISO曜日を求め、第1週の月曜日までさかのぼった上で、(7×(週-1)+曜日-1)日を加えます。1月1日より前や12月31日より後に落ちる序数は、400年規則を含む完全なうるう年処理とともにグレゴリオ暦の年境界をまたいで正規化されます。優先されるフィールドはISO週番号年を表すyear、週番号を表すweek、ISO曜日を表すweekdayです。yearにはiso_week_year、week_year、yという別名が、weekにはiso_week、week_number、wという別名が、weekdayにはiso_weekday、day、dowという別名があり、スプレッドシート、クエリ文字列、型付きフォームは同じ契約を再利用できます。自動化されたパイプライン、ERPコネクタ、給与計算カレンダージェネレーターの中で、2つ目の暦ライブラリを出荷することなく同一の数学的結果が必要な場合は、このページの無料ブラウザ実行と有料APIを組み合わせてご利用ください。
週から日付への変換が計画立案・物流・ソフトウェアで役立つ場面
運用チームは、月を名指しせずに「第42週」と記す発注書、配送スロット、生産計画でISO週ラベルに出会います。財務やHRのカレンダーはしばしばISO週で期間を締め、レポーティングツールはそれらのラベルを、フィルターやエクスポート用の具体的な開始日・終了日に変換しなければなりません。開発者は同じ契約をスクリプトから呼び出し、日付ピッカー用の決定的なテストベクターの種を作ったり、保存前にユーザーが入力した週文字列を正規化したり、あいまいな近似ではなくカレンダー日を要求するプログラミング課題の条件を満たしたりします。教育者はISO-8601を教える際にこれを使い、学生は第1週が常に1月4日を含むこと、長い年のみが第53週を受け付けることを確認できます。プロダクトや連携ツールは、フォームがyear・week・weekdayを収集し、バックエンドが並べ替えや結合のために単一のYYYY-MM-DDを保存しなければならないときにこの変換を使います。このページでの計算はすべてブラウザ内で完結します。API経由では成功した検索1件につき$0.002がかかり、検証に失敗したリクエストは課金されず、レスポンスが返された後は何も保存されません。この無料のインタラクティブな探索と、同一結果を返す有料APIという分割は、KITのtier-Aカタログの他のツールと同様であり、計画立案のデモから自動化パイプラインへ、数学的な結果を変えることなく移行できます。カレンダー日付から週と週年への逆マッピングが必要なときはISO週番号計算ツールと、無料で決定的な暦ヘルパーの小さなラボを構築する際は他の日付系エンドポイントと組み合わせてご利用ください。
連携の活用例
決定的なテストフィクスチャ
year/week/weekdayの3項組から、ユニットテストやCIアサーション向けに再現可能なカレンダー日付を生成できます。
技術的な質問
ISO週から日付への変換ツールの料金はいくらですか?
このページのブラウザ版は無料です。API経由では成功したリクエストごとに$0.002がかかり、無効な入力には課金されません。
year・week・weekdayはどのように定義されますか?
yearはISO週番号年、weekは1から52または53、weekdayはISO-8601に従い月曜=1から日曜=7です。