ForHosting KIT · 開発者向けツール

翌年の開始日

翌年の開始日は、ISOのYYYY-MM-DD形式で明示された日付を受け取り、その翌年の1月1日を返します。指定されたグレゴリオ暦の日付を検証して年を1つ増やし、現在時刻、端末の地域設定、タイムゾーンに依存せず結果を整形するため、計算は常に決定的です。同じ入力から同じ出力が必要な反復可能な自動処理、テスト、請求期間、保存期限の予定、各種ワークフローにご利用いただけます。

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

無料で実行 API仕様を見る

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

明示的なISO暦日をご指定ください

dateフィールドには、月と日の先頭のゼロを含む完全なYYYY-MM-DD形式の値をご指定ください。0001から9998までのグレゴリオ暦年に対応し、翌年も同じ4桁の形式で返せるようにしています。不完全な日付、タイムスタンプ、タイムゾーンの接尾辞、存在しない月、平年の2月29日や4月31日などの無効な日は受け付けません。この厳密な入力仕様により、フォーム、表計算、データベース、外部サービスから取得した日付が不正な場合、暗黙に補正されることなく明確なエラーになります。指定した月日によって回答の形式は変わりませんが、入力が実在する暦日であることを保証するため、月日も検証されます。たとえば2024-08-19からは2025-01-01が得られ、2024はグレゴリオ暦のうるう年であるため2024-02-29も有効です。翌年や現在の日付などの語句ではなく、基準となる日付そのものをご指定ください。この処理が不足する時間的な文脈を推測することはありません。

決定的なUTC結果の意味をご確認ください

結果には、検証済みの基準日、数値形式の翌年、YYYY-MM-DD形式で1月1日を示すstart_of_next_yearが含まれます。アルゴリズムは日付の4つの構成要素を10進整数として読み取り、グレゴリオ暦のうるう年と各月の日数の規則を検証し、年に正確に1を加えて月日を01-01に整形します。Dateオブジェクトの生成、システム時計の確認、ブラウザーの地域設定の参照、ローカルタイムゾーンによる変換は行いません。そのためUTC、ニューヨーク、東京、オフラインのブラウザーのいずれで実行しても、同じ入力から同じJSONが生成されます。UTC暦計算による返却日は曖昧さのない暦上の境界であり、後続システムがタイムスタンプを必要とする場合には00:00:00 UTCを表す基準として利用できます。ここではタイムスタンプ自体を返さないため、意図しない時差や夏時間の変換は発生しません。この違いは、実行場所によって時計ベースの近道が異なる年を選び得る大みそか付近で特に重要です。時間に関する唯一の根拠は、明示された入力です。

ワークフローで境界日を安全にお使いください

基準日の年が終わった後の最初の暦日が必要な処理にご利用ください。次年度の報告期間の開始、更新境界の設定、暦年に沿う将来の会計年度開始日の算出、日付依存テスト用の固定データ作成などが該当します。周辺システムが日付のみの値を扱う場合は、start_of_next_yearをISO日付として保存または比較してください。別のAPIが時点を要求する場合は、その後続レイヤーだけでUTC時刻を明示的に付加し、たとえば当該APIの仕様に従って返された境界をUTC午前0時として扱います。この出力を入力日の1年後と解釈しないでください。両者は別の処理です。2024-08-19の1年後は2025-08-19ですが、翌年の開始日は2025-01-01です。APIでの1項目あたりのリクエスト料金は$0.002で、純粋な計算は生成されるブラウザークライアントにも適しています。現在の時計を参照しないため、保存した例や繰り返し実行するジョブは、作成から長期間が経過しても再現可能です。

活用例

次の報告年度を開始する

日付付きレコードから、次の年次報告期間に対応する1月1日の境界日を取得します。

安定したテストデータを作成する

システム時計を模擬したりテストランナーのタイムゾーンを制御したりせず、予測可能な翌年の境界を生成します。

年次保存規則を予定する

保存期間を適用する前に、文書またはイベントの明示的な日付から翌暦年の開始日を算出します。

よくある質問

本日の日付を使用しますか？

いいえ。リクエストで明示された日付だけを使用し、現在のシステム時計は参照しません。

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

APIリクエスト1件の料金は$0.002です。

うるう年は検証されますか？

はい。指定年がグレゴリオ暦のうるう年である場合に限り、2月29日を受け付けます。

入力年の上限が9998なのはなぜですか？

翌年を4桁のISO日付として表せる必要があるため、この仕様では9999を増加できません。

1年を加算する処理と同じですか？

いいえ。基準日の月日にかかわらず、常に翌年の1月1日を返します。

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

いいえ。日付の構成要素を直接使って計算し、ローカル時刻への変換は行いません。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/start-of-next-year

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

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

curl -X POST https://api.kit.forhosting.com/date/start-of-next-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-08-19"}'

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

import os, requests

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

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

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

リクエスト例

{
  "date": "2024-08-19"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.start_of_next_year",
  "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の完全なドキュメントを見る →