ForHosting KIT · 日付・時間

日付に最も近い平日

日付を入力すると、月曜日から金曜日のうち最も近い平日が分かります。土曜日は直前の金曜日、日曜日は翌週の月曜日になり、平日はそのままです。締め切りや給与の締め日の確認に便利で、ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
日付
2024-03-16
結果
結果
2024-03-15
ずらした日数
-1
基準の曜日
Saturday
基準の曜日(ISO)
6

この日付に最も近い平日計算機は、厳密な YYYY-MM-DD 形式のグレゴリオ暦の 1 日を受け取り、純粋な UTC 市民暦として計算した月曜日から金曜日のうち最も近い平日を返します。入力がすでに月曜日から金曜日の場合、結果はその同じ日付で日数オフセットはゼロです。入力が土曜日のときはエンジンが 1 日戻して金曜日へ、日曜日のときは 1 日進めて月曜日へ進めます。これは祝日を考慮しない 7 日週における、一意に定まる最も近い営業日です。古典的な確認例として、2024-03-16(土曜日)は 2024-03-15(金曜日)へ、2024-03-17(日曜日)は 2024-03-18(月曜日)へ写像され、2024-03-15(金曜日)はそのままです。経路は決定論的な先発的グレゴリオ算術のみを用い、暦上にその日が存在することを検証し、坂本の整数算術で曜日を求め、固定の週末オフセット表を適用し、シリアル日数カウントを経由して変換します。ネットワーク呼び出し、乱数サンプリング、ホストの Date オブジェクトは使いません。スケジューリング、給与締切、SLA 整合にはブラウザで無料でお使いいただけます。

最も近い平日の意味と応答に含まれる内容

月曜日から金曜日のうち最も近い平日を求めることは、名前付きの次の曜日、前の曜日、複数日の営業日オフセットとは別の問いです。入力に最も近く、かつ月〜金の集合に留まる単一の市民暦の日を問い、土曜日と日曜日を再割当が必要な非平日として扱います。

距離は先発的グレゴリオ時間軸上の完全な暦の真夜中単位で測り、時刻なし・ローカル時区変換なしの UTC 日付文字列として解釈します。月〜金のいずれでもオフセットは 0 で、result は正規化済み入力と一致します。拒否例には date 欠落、2024/03/16 のような誤形式、不可能な月、2023-02-29 のような存在しない日が含まれます。

基準以降の名前付き曜日、祝日対応の営業日、2 つの時刻間の週末日数などが必要な場合は専用ツールをご利用ください。本ページは明示的な ISO 日付 1 件に対する最も近い月〜金スナップのみに答えます。

最も近い平日の算術が運用・給与・ソフトウェアで活きる場面

運用・製品チームは、ユーザーが週末のスタンプを入力しても締切を営業カレンダー日に置く必要があるとき、決済日や通知日を土日に置きたくないとき、SLA が片側の翌営業日・前営業日ではなく最も近い平日で納品を定義するときに、最も近い平日を必要とします。

給与・財務の流れは自由形式のイベント日を月〜金のバケットにスナップし、バッチジョブ・ACH 窓口・請求書期限を週末外に保ちつつ国ごとの完全な祝日暦を作らずに済みます。コホートラベルを作る分析者は同じ手順で観測開始を週末ノイズからずらしつつ平日は正確に保ち、年境界とうるう日での 1 日ずれを避けます。

開発者はスクリプトから契約を呼び出し、スケジューラやフォーム検証の決定論的テストベクトル生成、オンボーディング用デモカレンダーの種まき、ホストロケールの週開始に依存しない純暦ステップを求める製品要件の充足に使います。

教育者や規格執筆者は、2024-03-16 が土曜日で最も近い平日は金曜日であること、日曜日は前方の月曜日へ写像されることを、製品ごとに異なる表計算シリアル番号やタイムゾーンでずれる生の Date に頼らず示せます。

関連する暦ステップが必要なときは次の曜日・営業日加算・週末日数のヘルパと、日付ユーティリティの小さな実験室を組むときは他の無料決定論ツールと組み合わせてください。

締切・決済のスナップ

週末に入力された締切・決済スタンプ・通知日を、片側の翌営業日方針を作らずに、最も近い月〜金の日へ移します。

給与とバッチジョブの整合

自由形式のイベント日を ACH 窓口・請求期限・土日を拒否する夜間バッチ暦向けの月〜金バケットへ正規化します。

決定論的テストフィクスチャ

Date やホスト時計に依存せず、単体テスト・フォーム検証・CI アサーション用に再現可能な最も近い平日の ISO 文字列を生成します。

公休日はスキップしますか?

いいえ。 月〜金と土日の区別のみです。国別の祝日暦が必要な場合は祝日対応の営業日ツールをご利用ください。

受け付ける日付形式は?

厳密な ISO-8601 拡張暦日 YYYY-MM-DD です。月の長さとうるう日を検証し、年は 1〜9999 をサポートします。UTC 市民日のみで、タイムスタンプやタイムゾーンはありません。

土曜日が月曜日ではなく金曜日になるのはなぜですか?

金曜日は1日前、月曜日は2日後なので、金曜日のほうが近いためです。このツールは常に最も近い平日を選ぶので、土曜日は前に、日曜日は後ろに移ります。

週末の日付はどのように調整されますか?

土曜日は直前の金曜日に、日曜日は翌日の月曜日に移ります。月曜日から金曜日の日付は、入力したとおりの日付がそのまま返ります。

最も近い平日はどんな場面で使いますか?

締め切りや支払日、締め日が週末に当たり、最も近い営業日を使う決まりがあるときに役立ちます。給与の支払日や決済日の確認によく使われます。

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

POSThttps://api.kit.forhosting.com/date/nearest-weekday

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

curl -X POST https://api.kit.forhosting.com/date/nearest-weekday \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-03-16"}'
{
  "date": "2024-03-16"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.nearest_weekday",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

1リクエストあたり$0.002

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

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

CI・報告パイプライン・製品機能で再現可能な平日スナップが必要なときは、成功リクエストごとに $0.002 で API を呼び出してください。

最も近い平日の意味と応答に含まれる内容

土曜日では直前の金曜日が 1 日先、次の月曜日が 2 日先なので、最も近い平日は金曜日で offset_days は -1 です。日曜日では次の月曜日が 1 日先、直前の金曜日が 2 日先なので、最も近い平日は月曜日で offset_days は +1 です。計算機は正規化済み基準日、ISO の result 文字列、offset_days、ブールの is_weekend と shifted、基準曜日名と ISO 曜日番号(月曜日=1〜日曜日=7)、結果側の同ペア、結果の year・month・day、配管しやすい基準成分、短い公式リマインダを返します。日長の浮動小数近似もホスト Date への依存もなく、入力が実在する暦日なら最も近い平日は完全に決まり、そうでなければ invalid_input で失敗します。

日付の読み方と結果が再現可能である理由

文字列は 4 桁・ハイフン・2 桁・ハイフン・2 桁に一致する必要があり、前後の空白は除去されますが、部分日付・年通算日のみ・月名・時刻付きタイムスタンプはここでは展開しません。解析後、年は 1〜9999、月は 1〜12、日はその年その月の実日数の 1 から上限までで、うるう年は 4 で割り切れるが 400 で割り切れない世紀年は除くというグレゴリオ規則に従います。推奨フィールドは date ですが、iso_date・d・value・base・from の別名も受け付けるため、表計算・クエリ文字列・型付きフォームは列名を変えずに同じ契約を再利用できます。内部ではエンジンが日曜=0 の坂本純整数算術で基準曜日を求め、土曜日を -1、日曜日を +1、月〜金を 0 に写像し、既知の days_from_civil で市民三重項を先発的グレゴリオのシリアル日数に変換し、整数オフセットを加え、civil_from_days で年月日を復元します。ホストのロケール設定や夏時間遷移でずれてはならない自動パイプライン内で同一の最も近い平日が必要なときは、本ページの無料ブラウザ実行と有料 API を組み合わせてください。

最も近い平日の算術が運用・給与・ソフトウェアで活きる場面

本ページでは作業はすべてご利用のブラウザ内で走り、API では成功した参照ごとに $0.002 で、検証失敗は課金されず、応答後に何も保存しません。無料の対話的探索と同一の有料 API という分割は KIT の tier A カタログの他項目と一致し、一回の確認からパイプラインへ数学的結果を変えずに移行できます。

日付に最も近い平日計算機の料金は?

本ページのブラウザでは無料です。API では成功リクエストが $0.002 で、無効な入力は課金されません。

土曜日と日曜日はどう写像されますか?

土曜日は 1 日戻して金曜日(offset_days = -1)。日曜日は 1 日進めて月曜日(offset_days = +1)。単純な 7 日週における最も近い月〜金です。

入力がすでに平日の場合はどうなりますか?

基準日はそのまま返されます。offset_days は 0、shifted は false、result は正規化済み入力日と一致します。

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