ForHosting KIT · 日付・時間

米国週番号計算機

日付を入力すると、米国式の週番号が分かります。週は日曜日から土曜日までで、1月1日を含む週が第1週です。2024年3月15日は第11週に当たります。その年が何週あるかも表示されます。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
日付
2024-03-15
結果
年
2,024
月
3
日
15
年内通算日
75

米国では多くのカレンダー、給与システム、学校の予定表、表計算モデルが、各週を日曜日から始め、第1週を1月1日を含む週とする規則で週を番号付けします。この規則は、週を月曜日から始め、第1週をその年の最初の木曜日を含む週と定義するISO 8601週日付方式とは異なります。予定・報告・監査証跡がISO週番号ではなく米国週番号と一致する必要がある場合、小さな決定的変換器がホストのDateの癖やロケールのずれを避けます。

米国週ルールとISO週の違い、および日付の送り方

ここで用いる米国の慣例では、週は常に日曜日に始まり土曜日に終わります。ある年の第1週は1月1日を含む週であり、壁掛けカレンダー上ではその週が前年の12月に始まっていても同じです。以降の週は、12月31日まで完全な日曜から土曜のブロックとして数えられ、1月1日の位置とうるう年かどうかにより第52週または第53週に落ちることがあります。

ISO 8601の週は異なります。月曜日始まりで、第1週はその年の最初の木曜日を含む週なので、同じ市民日が別の週インデックスに対応し得ます。経路は壁時計・ロケール・ネットワークを一切読まないためです。

番号の計算方法と無効な日付の扱い

エンジンはまずグレゴリオ暦の日を検証し、うるう年規則を適用します。2月が29日になるのは年が4で割り切れる場合のみで、世紀年はさらに400で割り切れる必要があります。次に累積月長から年内通算日を求め、ホストのDateオブジェクトを使わず整数算術でその日付の曜日を計算します。

米国週番号は、年内通算日マイナス1に1月1日の曜日を足し、7で割った床値に1を加えたもので、日曜が曜日ゼロです。この式は1月1日を第1週に置き、以降の各日曜で1つ進めます。4桁年・2桁月・2桁日をハイフンで区切った形式でない不正な文字列も同様に拒否されます。

主な使い道と実用上の注意

宿題確認・計画デモ・カレンダーライブラリを入れない素早い検証には、ブラウザ内の無料米国週番号計算機を使ってください。検証失敗はエンジン拒否後に残高を消費しません。日インデックスや2月の長さが必要なときはISO通算日や月日数ツールと組み合わせてください。

ただし週インデックスがISO週日付ラベルと一致することを期待しないでください。年の境界は隔離安全のため公開パラメータ範囲に従います。

給与と米国労働週レポート

日曜開始の週で時間をまとめる人事・給与パイプラインは、各支払期間に勤務日を含む米国週番号を付け、表計算の一般的なWEEKNUM期待に合わせます。

学校と小売の計画カレンダー

学区カレンダーや小売マーチャンダイジング計画は、1月1日を第1週として週を番号付けすることが多く、スライド・メール要約・在庫ウィンドウ用にISO日付をそのインデックスへ変換します。

ISO週番号と同じですか?

いいえ。 ISO週は月曜始まりで、第1週は最初の木曜日の規則で決まります。同じ市民日でもISO規則では別のインデックスになり得ます。

日付が無効な場合はどうなりますか?

例:不正なYYYY-MM-DD形式、2月30日、非うるう年の2月29日。検証失敗は課金されません。

1年が53週になることはありますか?

あります。12月31日が第53週に入る年があり、1月1日の曜日とうるう年かどうかで決まります。たとえば2024年の最後の週は第53週です。

第1週が12月に始まることはありますか?

あります。第1週は1月1日を含む日曜日から土曜日までの週なので、1月1日が週の途中なら、その週は前年の12月の終わりに始まっています。

週は日曜日と月曜日のどちらから始まりますか?

日曜日です。米国式の週は日曜日から土曜日までで、月曜日に始まり、その年の最初の木曜日を含む週を第1週とするISO週とは異なります。

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

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

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

curl -X POST https://api.kit.forhosting.com/date/us-week-number \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-03-15","calendar":"valor-ejemplo"}'
{
  "date": "2024-03-15",
  "calendar": "valor-ejemplo"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.us_week_number",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

1リクエストあたり$0.002

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

HTTPコード意味
401unauthorizedAPIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
402insufficient_balance残高が不足しています。チャージ後に再度お試しください。
404unknown_type指定されたタスクタイプは存在しません。タイプ名を確認してください。
429rate_limitedリクエストが多すぎます。しばらく待ってから再度お試しください。

この米国週番号計算機はISOカレンダー日付を受け取り、グレゴリオ暦のうるう年算術と純粋な曜日式を適用し、週インデックスを曜日および年の事実とともに安定したJSONで返します。

米国週ルールとISO週の違い、および日付の送り方

YYYY-MM-DD形式の日付文字列、または構造化フィールドyear・month・dayをまとめて送ってください。文字列経路ではcalendar、calendar_date、iso_dateなどの別名が受け付けられます。3部分すべてがない部分的な構造化入力はinvalid_inputで拒否され、呼び出し側が欠けた値を推測するのではなく本体を直すようにします。同一入力は常に同一のJSONを生みます。

番号の計算方法と無効な日付の扱い

4月31日、2月30日、非うるう年の2月29日など不可能な日付はinvalid_inputで失敗し、その月の実日数を述べるメッセージを返します。応答はweek_startsをSunday、week_1_ruleをcontains_january_1、weeks_in_yearを12月31日の米国週とエコーし、ダッシュボードが二度目の呼び出しなしで年の範囲を示せるようにします。

APIの使い方、料金、ワークフロー、実用上の制限

dateをYYYY-MM-DDとするJSON本体、または公開範囲内の整数year・month・dayを送ってください。成功時のペイロードには正規化日付、構造化成分、day_of_year、日曜を0・土曜を6とするday_of_week(英語名付き)、week_number、weeks_in_year、is_leap_year、calendarがgregorian、methodがus_week_numberが含まれ、ラベルで分岐するルーターやテストに使えます。給与エクスポート、学校カレンダー、小売計画ツール、SDKがKIT残高下で安定契約を必要とする場合は前払いAPIを使い、成功項目ごとに$0.002です。

APIでの表計算との一致

ExcelやGoogle Sheetsの日曜基準週番号と一致しなければならないサービスは、各クライアント言語で曜日計算を再実装する代わりに安定したJSONフィールドを公開します。

ある日付の米国週番号を得るには?

dateを2024-03-15のようなISO文字列にしたJSONを送るか、year・month・dayを送ってください。応答にweek_numberとday_of_week_nameが含まれます。

週は日曜始まりですか、月曜始まりですか?

日曜です。この計算機は米国慣例を使い、week_startsは常にSunday、第1週は1月1日を含む週です。

米国週番号計算機は無料ですか?

ブラウザツールはお使いの端末で無料です。API呼び出しは前払いKIT残高を成功項目あたり$0.002で使い、検証失敗は課金されません。

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