ForHosting KIT · 開発者向けツール

翌月末日計算

翌月末日計算ツールは、YYYY-MM-DD形式で明示された日付を受け取り、その翌月の最終日を返します。2月、うるう年、30日または31日まである月、12月から1月への年越しを、端末の時計やローカルタイムゾーンに依存せず処理します。請求規則、レポート期間、更新通知、ワークフローなどで、ブラウザー、API連携、テストスイートのどこでも再現できる安定したISO日付が必要な場合にご利用いただけます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

翌月の境界日を明確に計算します

業務上の規則は、月の境界を扱うまでは単純に見えることがあります。「翌月末まで」という条件は、一定の日数を加える方法では正しく実装できません。暦月の日数は28日、29日、30日、31日のいずれかだからです。この計算ツールは、入力されたISO日付の月を起点として暦上の1か月だけ進め、対象月に存在する最後の日を選びます。たとえば1月の日付なら2月末、11月の日付なら12月末が結果になります。元の日付の日部分は計算結果を変えませんが、存在しない日付が処理へ紛れ込まないように検証されます。結果はISO日付として返されるため、データベースの項目、スケジュール済みタスク、請求書、レポート、曖昧さのない値を必要とするシステムでそのまま扱えます。計算には先発グレゴリオ暦を使用し、同じ有効な入力には常に同じ結果を返します。

うるう年と年越しの動作を確認できます

簡略化した日付計算は、特に2月で誤りやすくなります。グレゴリオ暦では4で割り切れる年をうるう年としますが、世紀の年については400でも割り切れる必要があります。そのため、2024年2月は29日、2100年2月は28日、2000年2月は29日です。本ツールはこの規則を整数演算で直接適用します。12月から1月へ移る場合は年も増やすため、2026年12月の入力からは2027年1月の最終日が返されます。入力には、0001から9999までの実在する4桁の年、2桁の月、2桁の日が必要です。また、その日は指定された月に実在しなければなりません。4月31日や平年の2月29日は拒否されます。9999年12月から先へ進めることで対応範囲の4桁ISO年を超える場合も、不正または曖昧な値を返さず、リクエストを明確に拒否します。これにより境界条件をテスト可能な形で扱えます。

UTCに左右されない決定的な日付演算です

ソフトウェアがあるタイムゾーンの午前0時を解析し、別のタイムゾーンで書式設定すると、日付が意図せずずれる場合があります。この機能は、その種の問題を仕組みから排除しています。現在時刻を読み取らず、Dateオブジェクトを生成せず、実行環境のタイムゾーン、ネットワークサービス、乱数も使用しません。文字列に書かれた年、月、日を分解し、それらの整数だけで範囲を限定したグレゴリオ暦演算を行います。ローカルの時差が結果へ一切入らないため、UTCに対して安全な設計です。東京のブラウザー、ニューヨークのサーバー、UTCに設定したテスト環境のどこから同じ入力を送っても、返される日付は変わりません。自動処理では、返されたend_of_next_month項目をISO日付として検証し、後続契約が月末を含む境界を採用している場合はそのまま保存できます。月末を含まない境界が必要なシステムでは、その仕様書に従って変換してください。

活用例

請求期限を設定する

基準日から、翌請求月の最終日を含む期限を正確に作成できます。

レポート期間を締める

サーバーのタイムゾーンに依存しない、安定した月末境界をレポートに利用できます。

更新フローをテストする

うるう年、短い月、年越しについて、再現可能な期待日付を生成できます。

よくある質問

必要な入力形式は何ですか？

実在するグレゴリオ暦の日付をYYYY-MM-DD形式で指定してください。月と日には先頭の0も必要です。

元の日は結果に影響しますか？

影響しません。日付自体は検証されますが、同じ月の有効な日付からは同一の翌月末日が得られます。

うるう年はどのように処理されますか？

4、100、400によるグレゴリオ暦の割り切れ条件を使い、対象の2月が28日か29日かを決定します。

タイムゾーンで結果は変わりますか？

変わりません。日付の構成要素だけを使い、ローカル時刻、時計、Date APIは呼び出しません。

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

APIリクエスト1回の料金は$0.002です。ブラウザー版はネットワーク計算を行わず、ローカルで実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/end-of-next-month

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

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

curl -X POST https://api.kit.forhosting.com/date/end-of-next-month \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-01-15"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/end-of-next-month",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-01-15"
},
)
task_id = res.json()["task_id"]

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

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

リクエスト例

{
  "date": "2024-01-15"
}

レスポンス例

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

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