ForHosting KIT · 日付・時間

ISO日付から月初の曜日を計算

日付を入力すると、その月の1日が何曜日だったかが分かります。2026年8月13日なら、2026年8月1日は土曜日です。ISOの曜日番号と日曜始まりの番号も表示され、カレンダー作りに使えます。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
日付
2026-08-13
結果
入力した日付
2026-08-13
最初の日付
2026-08-01
年
2,026
月
8

この計算ツールは、明示されたISO日付を受け取り、その日付が属する月の1日が何曜日だったかを求めます。入力日は月内のどの日でも構いませんが、結果は常に1日を指します。正規化された月初日、曜日名、ISO曜日番号、日曜始まりの番号を返します。厳密なグレゴリオ暦検証により、存在しない日付を自動補正せず拒否します。

曖昧さのない完全なISO日付を入力します

4桁が年、2桁が月、残る2桁が日を表します。たとえば2026-08-13は2026年8月を選択し、末尾の日によって、不完全な年月ではなく実在する明示的な日付を指定したことも確認できます。曜日計算の前に値全体を検証します。

月は01から12、日は指定月に実在する必要があり、2月にはグレゴリオ暦のうるう年規則を適用します。通常、4で割り切れる年はうるう年ですが、400で割り切れない世紀年は平年です。対象範囲は0001年から9999年です。

時刻付き日時、タイムゾーン接尾辞、週日付、年間通算日、異なる区切り文字、地域固有形式は受け付けません。この厳密さにより、2023-02-29や2026-13-01のような値が別の日付へ気付かないまま補正されることを防ぎます。検証後は入力日の数字が結果に影響しません。

決定的な曜日計算の仕組みを確認します

検証が終わると、計算処理は入力された年と月を保持し、曜日を求める際の日を意図的に1へ置き換えます。月ごとの小さな補正表、4で割り切れる年の調整、世紀年の補正、400で割り切れる年の復元を組み合わせた、固定のグレゴリオ暦整数式を使用します。1月と2月は、この式では算術上の前年に属するものとして扱います。

7を法とする余りが日曜始まりの番号となり、0は日曜日、1は月曜日、6は土曜日です。さらに、月曜日を1、日曜日を7とするISO番号へ変換し、固定表から曜日名を選択します。システム上の日付は一切生成しません。

カレンダー、帳票、テストで結果を活用します

応答は人が読む表示にもソフトウェア連携にも利用しやすい構成です。カレンダー画面では、1日より前に置く空欄の数を算出できます。月次会計期間の開始曜日を帳票へ付けたり、時計を模擬せずタイムゾーンも変更せずに安定した月間表示テストを作ったりできます。

本機能は最初の営業日を求めず、祝日を除外せず、曜日名を地域化せず、指定曜日の最初の出現日も検索しません。明示したISO日付が属する月の1日は何曜日か、という一つの問いだけに決定的に答えます。

月間カレンダー表を作成

曜日番号を使って1日を正しい列へ配置し、その前に必要な空欄の数を計算します。

会計期間へ曜日を付記

取引日から対象期間を特定し、月次帳票へその期間の開始曜日を追加します。

安定した日付テストを作成

システム時計を読まず、ローカル日付やタイムゾーンを設定せずに、月初の決定的な期待値を生成します。

入力日は月の1日でなければなりませんか?

いいえ。 選択月に実在する日付なら受け付けます。その日付を検証したうえで、同じ月の1日の曜日を計算します。

タイムゾーンによって答えは変わりますか?

変わりません。 グレゴリオ暦の整数演算を使用し、Dateの生成やローカルのタイムゾーン設定の参照を行いません。

存在しない日付を入力するとどうなりますか?

無効な月、存在しない日、0000年、平年の2月29日などが該当します。

月のカレンダーを作るとき、結果をどう使いますか?

日曜始まりの番号で、1日の前に入る空欄の数が分かります。2026年8月は土曜日始まりで番号は6なので、日曜始まりの表なら空欄は6つです。

2つの曜日番号はどう違いますか?

ISO番号は月曜日が1、日曜日が7です。日曜始まりの番号は日曜日が0、土曜日が6です。土曜日の場合は、たまたまどちらも6になります。

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

POSThttps://api.kit.forhosting.com/date/weekday-of-first-of-month

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

curl -X POST https://api.kit.forhosting.com/date/weekday-of-first-of-month \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-08-13"}'
{
  "date": "2026-08-13"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.weekday_of_first_of_month",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

1リクエストあたり$0.002

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

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

通信、乱数、システム時計、タイムゾーン変換、Dateオブジェクトを使わず固定の整数演算だけで計算するため、ブラウザーとAPIで常に決定的な結果になります。

曖昧さのない完全なISO日付を入力します

dateフィールドには、YYYY-MM-DD形式の完全なISO暦日を指定してください。同じ月の有効な日付なら、first_dateとweekdayは常に同じ値になります。

決定的な曜日計算の仕組みを確認します

一般的な日付APIでは、時刻のない文字列がローカル規則で解釈され、地域によって深夜が別の日へ移動する場合がありますが、その影響を受けません。同じ入力は先発グレゴリオ暦だけに従うため、UTCでも、別のタイムゾーンに設定したブラウザーでも、将来のAPI呼び出しでも同一の結果になります。

カレンダー、帳票、テストで結果を活用します

first_dateは選択月の正規化されたYYYY-MM-01を示します。weekdayは曜日名、iso_weekdayは月曜日から日曜日までを1から7で表すISO番号、weekday_sunday_zeroは日曜日を添字0として週を並べるシステム向けの値です。input_date、year、monthも含まれるため、保存した結果だけでも対象が分かります。ブラウザーでは無料で実行でき、自動化したAPIリクエストの料金は$0.002です。不正な入力にはinvalid_inputを返すため、暦の誤りと内部障害を区別できます。

iso_weekdayは何を表しますか?

ISO方式の番号で、月曜日が1、火曜日が2、日曜日が7です。日曜始まりの配列向けにweekday_sunday_zeroも返します。

APIリクエストの料金はいくらですか?

成功したAPIリクエストは$0.002です。同じ決定的な計算をブラウザーでは無料で実行できます。

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