ForHosting KIT · 日付・時間

週末日か判定

Q: 結果はタイムゾーンに依存しますか？

いいえ。 ソルバは明示された民事日に対する純粋なグレゴリオ演算を使い、ホスト時計や Date のタイムゾーンは読みません。

日付を1つ入力すると、土曜日か日曜日に当たるかを「はい・いいえ」ではっきり示します。2026年7月25日は土曜日なので週末です。曜日の名前とISOの曜日番号も表示します。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

日付: 2026-07-25

結果

年: 2,026
月: 7
日: 25
曜日名: Saturday

週末日チェッカーは、スケジューラや給与ツール、学校のカレンダーが日常的に問う質問に答えます。ある暦日が土曜または日曜に当たるか。

週末日の定義と日付の解釈

本機能は土曜・日曜を標準週末とします。入力は年4桁、ハイフン、月2桁、ハイフン、日2桁の単一ISO暦日です（例：2026-07-25）。時刻も末尾のZもないため、結果は明示された民事日の週末状態であり、呼び出し側のタイムゾーンやホスト時計には依存しません。

下層ではグレゴリオ暦の規則が有効で、各月の日数は固定ですが2月のみうるう年に29日になります（4で割り切れ、かつ100で割り切れる場合は400でも割り切れる年）。曜日はSakamotoの整数式で求め、日曜起点の指数を英語の長名・短名とISO曜日番号へ写像します。関連ツールは別の検索意図に応えます。

曜日名計算は週末の真偽値なしで名前を返し、週末日数カウンタは2日付間の土日を数え、営業日加算は期限投影で週末を飛ばします。いずれも1日付の真偽週末判定の代わりにはなりません。

実務上の注意、制限、本ツールを選ぶ場面

時刻付きのdatetimeや末尾Zではなく、必ず完全な暦日だけを送ってください。タイムゾーン依存の深夜を誤って符号化しないよう、拡張ISOタイムスタンプは意図的に拒否します。指導や試験では、土曜成功、日曜成功、金曜や水曜などの週中 false、有効な2月29日のうるう成功、2023-02-29 のような意図的失敗を小さな既知集合として保ってください。

年上限は9999で、本製品面の4桁ISO文字列を明確に保ちます。本ランディングは「週末日か」「週末チェッカー」「土曜か日曜か」を探す方向けで、営業日カウンタでも区間の週末合計でも、ロケール対応の日付整形でもありません。ISO日付が1つあり真偽の週末フラグだけが必要なときは本機能を選び、多言語の月名や整形文字列が必要なら日付整形機能を使ってください。

活用例

スケジューラとブラックアウト日の確認

提案中の配送や保守枠が土曜または日曜に当たるかを、カレンダー予約を確定する前に確認します。

テスト用の週末専用フィクスチャ生成

エンジニアリングチームがホスト時計に依存せず、UIカレンダー向けに既知の土日と平日のISO日付を組み立てます。

宿題とカレンダー演習

学生が教科書のISO日付を入力し、手計算の曜日分類と真偽の週末結果を突き合わせます。

よくある質問

必要な日付形式は何ですか？

YYYY-MM-DD 形式の単一ISO暦日です（例：2026-07-25）。datetime、序数日付、週日付は受け付けません。

結果はタイムゾーンに依存しますか？

いいえ。ソルバは明示された民事日に対する純粋なグレゴリオ演算を使い、ホスト時計や Date のタイムゾーンは読みません。

金曜日と土曜日を週末にできますか？

いいえ。一般的な土曜日と日曜日の週末を使い、そのどちらかなら「はい」、月曜日から金曜日なら「いいえ」になります。2つの日付の間の週末日を数える計算や、期限から週末を除く計算は別の機能です。

2023年2月29日のような存在しない日付はどうなりますか？

分かりやすいメッセージで受け付けないことをお知らせし、黙って「いいえ」を返すことはありません。2023年は平年なのでこの日はありませんが、うるう年の2月29日は通常どおり判定します。

結果に出る曜日番号は何を表しますか？

ISOの曜日番号で、月曜日が1、日曜日が7です。2026年7月25日は土曜日なので番号は6になり、英語の曜日名も一緒に表示されます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/is-weekend

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

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/date/is-weekend \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-25"}'

const res = await fetch("https://api.kit.forhosting.com/date/is-weekend", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2026-07-25"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/is-weekend",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-07-25"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/is-weekend", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2026-07-25"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2026-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/is-weekend", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "date": "2026-07-25"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.is_weekend",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

料金

1リクエストあたり$0.002

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

エラー

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

技術的な注記

年-月-日形式のISO日付を貼り付けると、明確な真偽値 is_weekend、英語の曜日名、ISO曜日番号（月曜が1から日曜が7）、およびその日が週末か平日かを述べる短いメッセージを返します。形が違う文字列、存在しない月、うるう年以外の2月29日などは、黙って false を返すのではなく invalid_input で拒否します。宿題確認の学生、週末専用フィクスチャを書く開発者、ブラックアウト日を検証する計画担当者、契約の押印から「それは週末だったか」を再現する方は、無料のブラウザ実行と前払いAPIで同じ決定的結果を得られます。

週末日の定義と日付の解釈

民事曜日が土曜または日曜なら is_weekend は true、月曜から金曜なら false です。日常文では月先書きや日先書きがあるため、APIとデータベースはこの曖昧でない形式を好みます。ホストの Date コンストラクタを呼ばないため、ブラウザとAPIが異なるタイムゾーンで動いても食い違いません。

APIの呼び出し方と返却内容

値は4桁-2桁-2桁の形に厳密に一致し、年1から9999の範囲で実在するグレゴリオ日でなければなりません。必須文字列フィールド date を含むJSON本体を送ってください。別名 iso_date、value、day でも渡せます。成功時は正規化日付文字列、数値の year・month・day、同じ真偽値の is_weekend と weekend、反対の is_weekday、Saturday や Sat のような英語の day_name と day_name_short、月曜=1…日曜=7 の iso_weekday、日曜起点0…6 の weekday_0_sunday、その年の leap_year、短い message、および解析・Sakamoto分類・週末判定を述べる steps 配列を返します。欠落、非文字列、不正な形、範囲外の年、不可能な月日、非うるう年の2月29日などは invalid_input となり課金されません。料金は成功リクエストあたり定額 $0.002、単位は item です。

実務上の注意、制限、本ツールを選ぶ場面

クライアントを制御できる場合は主フィールド名 date を使い、iso_date や value とラベル付けされたフォーム向けに別名があります。別の信頼できるグレゴリオ源で曜日を再計算し、土曜と日曜だけが is_weekend を true にするか確認すれば往復検証は容易です。invalid_input の失敗タスクは前払い残高を消費しないため、フィクスチャ作成でわざと不正日付を送る探索スクリプトも安価に保てます。

技術的な質問

週末日とは何ですか？

土曜と日曜のみです。月曜から金曜は is_weekend が false（is_weekday が true）になります。

2023-02-29 のような無効日付ではどうなりますか？

2023 はグレゴリオうるう年ではないため invalid_input を返します。無効な月、0日、YYYY-MM-DD 以外の形も拒否します。

週末日チェッカーは無料ですか？

ブラウザツールは無料でローカル実行です。API呼び出しは成功リクエストあたり $0.002 の前払いKIT残高を使い、失敗タスクは課金されません。

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

無料で実行

計算例

週末日の定義と日付の解釈

実務上の注意、制限、本ツールを選ぶ場面

活用例

スケジューラとブラックアウト日の確認

テスト用の週末専用フィクスチャ生成

宿題とカレンダー演習

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

エラー

技術的な注記

週末日の定義と日付の解釈

APIの呼び出し方と返却内容

実務上の注意、制限、本ツールを選ぶ場面

技術的な質問

ありがとう