ForHosting KIT · 日付・時間

月内の曜日の出現回数

日付を入力すると、その月の何回目の同じ曜日か、最後の曜日かどうかが分かります。2025年7月1日は7月の第1火曜日で、最後の火曜日ではありません。第2月曜日のような決まりの確認に便利です。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

日付: 2025-07-01

結果

曜日: tuesday
曜日番号: 2
月内の出現回数: 1

日付を与えると、その曜日がその月の中で何回目に当たるか（例：「第2火曜日」）を示し、月内で最後の回かどうかも判定します。

仕組み

入力された日付をもとに、その曜日がその月の中で何回目に当たるか（例：「第2火曜日」）を判定し、さらにその曜日が月内で最後の回であるかどうかを示します。計算は完全に決定的であり、ブラウザー内で無料で動作します。基準例は期待される契約を固定し、各出力欄の読み方を具体的に示してくれます。

入力と出力

スキーマの必須項目は必ず存在し、正しい型でなければなりません。一方、任意の項目は文書化された既定値に従います。成功時の応答には、何回目かを表す序数と、最後の回であるかを示す指標という主要な出力欄が常に含まれますので、画面の表示要素との結び付きは長期にわたって安定します。

浮動小数点の表現範囲を超えてしまうような極端に大きな中間値は、null ではなく範囲外エラーとして返されますので、静かなあいまいさが生じることはありません。エラー文字列は安定しており、認証やテストにおける信頼できる照合の基準点として機能します。

この機能を自動処理や重要な本番系につなぐ前に、成功と失敗の双方について基準例を丁寧にご確認いただくことをお勧めします。

境界事例と限界

空文字列、誤った型、矛盾した範囲は、いかなる算術処理よりも前の、処理の最初の段階で拒否されます。タイムゾーンを持たない市民日付は暦上の日付として扱われ、結果を一日ずらしかねない暗黙の変換は行われません。必要な表やデータは機能のフォルダー内で完結して運ばれ、実行中にネットワーク呼び出しは一切発生しませんので、オフラインでも再現可能な動作が保証されます。

第4の回を越える曜日は正しく第5の回として識別され、該当する場合にはその月の最後の回として扱われます。組み込みの前には基準例を必ずご確認ください。基準例は期待される契約を定め、出力の各欄をどのように解釈すべきかを正確に示してくれます。

活用例

日常業務

表計算ソフトを使わずに確かな答えが得られます。

教育

デモに使える安定した基準例をご用意しています。

よくある質問

結果では何が分かりますか？

日付の曜日、その曜日が月の何回目か、そして最後の回かどうかです。2025年7月1日なら、火曜日の1回目で、最後ではないと表示されます。

日付が月の最終金曜日かどうかはどう確かめますか？

日付を入力し、最後の回と表示されるかを見てください。そう表示されれば、その月にはあとに金曜日がないので、その日が最終金曜日です。

第4の曜日が最後の曜日を兼ねることはありますか？

あります。その月に同じ曜日が4回しかなければ、4回目がそのまま最後になり、結果にも両方が示されます。2つの答えを合わせて読んでください。

ネットワーク接続は必要ですか？

必要ありません。計算はブラウザの中で行われ、通信もしないため、同じ日付なら今日でも何年後でも同じ答えになります。

開発者向け — APIアクセス

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

エンドポイント

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

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

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

curl -X POST https://api.kit.forhosting.com/date/weekday-occurrence \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2025-07-01"}'

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

import os, requests

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

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

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

リクエスト例

{
  "date": "2025-07-01"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.weekday_occurrence",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

仕組み

用いる純粋関数は API とまったく同じであるため、手元で得られる結果は遠隔サービスの結果と厳密に一致します。日付は ISO-8601 に従い、算術処理の前に必ず検証されますので、型が不正な場合には誤解を招く値ではなく、明確な invalid_input エラーが直ちに返されます。この機能を本番のワークフローや自動テストに組み込む前には、成功の経路と失敗の経路の双方を示す基準例を必ずご確認ください。

連携の活用例

自動化

ウィジェットと API で同じ純粋関数を使います。

技術的な質問

無料ですか？

はい、ブラウザーでの Tier A です。

ネットワークは？

ネットワークは不要で、端末上で処理します。

不正な入力は？

明確な照合を伴う invalid_input が返ります。

安定していますか？

決定的な基準例が契約を固定します。

作者は？

samurai。

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