ForHosting KIT · 日付・時間

生年月日から退職資格日を計算

Q: この計算機は公的な退職年齢を決定しますか？

いいえ。 目標年齢は明示的に指定していただきます。本機能は暦計算のみを行い、法律、年金制度、納付履歴、個人の資格条件を解釈しません。

Q: 今日の日付やタイムゾーンは結果に影響しますか？

いいえ。 アルゴリズムは入力された生年月日と年齢だけを使います。時計やタイムゾーンを参照せず、Dateオブジェクトも生成しません。

1964年6月15日生まれで退職年齢が67歳なら、資格を得る日は2031年6月15日です。生年月日と制度で決められた年齢を入力すると正確な日付が分かり、2月29日生まれにも対応します。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

生年月日: 1964-06-15
退職年齢: 67

結果

退職日: 2031-06-15
退職の年: 2,031

退職資格日は一般に、登録済みの生年月日に、年金制度、勤務先の規程、または個人の試算で定めた暦年数を加える記念日計算として求められます。この計算機は、明示されたISO形式の生年月日と目標退職年齢を受け取り、両方を検証して、対応するグレゴリオ暦の日付を返します。現在日付を参照せず、法域を推測せず、公的給付の規則も適用しません。そのため、同じ入力からは実行時刻やタイムゾーンにかかわらず常に同じ結果が得られます。2月29日生まれで対象年がうるう年でない場合も、明示された規則で一貫して処理します。

生年月日と目標年齢を明示的な値として入力します

桁数が固定されたISO形式なら、03/04/1960のように、読む人によって3月4日にも4月3日にも解釈される表記を避けられます。この計算機は文字列の形だけでなくグレゴリオ暦として実在する日付かどうかも確認するため、1961-02-29や1970-04-31などの不可能な日付を拒否します。

年齢は数値型の整数である必要があり、数字の文字列、小数、無限大、負数を暗黙に変換することはありません。また、日付計算と制度解釈を明確に分離できます。対象の年金制度や検討中の条件に記載された年齢を入力してください。

本機能は国、職種、雇用履歴、保険料の納付履歴、性別、障害の有無、法改正などから年齢を推定しません。人によって異なる年齢が適用される制度では、先に該当年齢を確認し、その値と登録済みの生年月日を送信してください。返される日付は誕生日の暦計算だけを示し、給付や支払いの承認を意味しません。

決定論的な暦計算の規則を確認します

グレゴリオ暦では4で割り切れる年がうるう年ですが、世紀の年は例外で、400でも割り切れる場合に限ってうるう年です。このため2000年はうるう年でしたが、1900年は違いました。2月29日生まれだけは、同じ月日が対象年に存在しないことがあります。

この場合、本機能は明示的で一定した規則を採用します。対象年がうるう年なら2月29日を維持し、この値をfalseにします。それ以外の有効な日付では元の月日を保ちます。

実装に使用するのは整数による暦演算と文字列整形だけです。JavaScriptのDateオブジェクトを生成せず、実行環境の時計を読まず、夏時間を適用せず、ローカルタイムゾーン経由の変換も行いません。現在年齢は計算せず、今日の日付が変わっても出力は変化しません。

法的判断ではなく計画用の結果として使用します

該当する制度年齢を別途選定済みであれば、ISO日付を計画表、給付見積もり、従業員向けの確認画面、テストデータ、資格判定処理などに直接保存できます。出力は時刻を伴わない暦日なので、後続システムでも日付のまま扱い、ローカルタイムゾーンの午前0時へ変換しないことを推奨します。

そのような変換を行うと、別の地域でシリアライズまたは表示した際に日付がずれる場合があります。本機能の範囲は意図的に限定されています。必要な勤続期間を満たしたか、申請受付がそれ以前に始まるか、給付が誕生日当日と翌月のどちらから始まるか、地域の規則が2月29日生まれを別の方法で扱うかは判定しません。

これらは制度や法域に依存するため、別の規則層で処理してください。重要な退職判断は、制度の管理者または公的機関にご確認ください。不正な入力にはもっともらしい日付ではなく、型付きエラーを返します。

活用例

従業員の退職計画

登録済みの生年月日と制度に基づいて選んだ年齢から、計画の確認に使える一貫した日付を作成します。

年金手続きの準備

別の規則で該当する目標年齢を決定した後、後続の資格判定処理で使用する記念日を生成します。

よくある質問

この計算機は公的な退職年齢を決定しますか？

いいえ。目標年齢は明示的に指定していただきます。本機能は暦計算のみを行い、法律、年金制度、納付履歴、個人の資格条件を解釈しません。

生年月日にYYYY-MM-DD形式が必要なのはなぜですか？

厳密なISO形式は地域による解釈の違いをなくし、結果を作る前に不可能なグレゴリオ暦の日付を拒否できるためです。

今日の日付やタイムゾーンは結果に影響しますか？

いいえ。アルゴリズムは入力された生年月日と年齢だけを使います。時計やタイムゾーンを参照せず、Dateオブジェクトも生成しません。

その日から年金を受け取れるという意味ですか？

いいえ。入力した年齢に達する誕生日を示すだけです。支給や給付を受けられるかどうかは、加入している制度や適用される法令によって決まります。

2月29日生まれの場合はどうなりますか？

退職の年がうるう年でなければ2月28日になり、日付を調整したことが示されます。うるう年であれば2月29日のままです。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/retirement-date

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

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

curl -X POST https://api.kit.forhosting.com/date/retirement-date \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth_date":"1964-06-15","retirement_age":67}'

const res = await fetch("https://api.kit.forhosting.com/date/retirement-date", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "birth_date": "1964-06-15",
    "retirement_age": 67
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/retirement-date",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "birth_date": "1964-06-15",
    "retirement_age": 67
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"birth_date":"1964-06-15","retirement_age":67}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/retirement-date", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "birth_date": "1964-06-15",
  "retirement_age": 67
}

レスポンス例

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

技術的な注記

生年月日と目標年齢を明示的な値として入力します

birth_dateにはYYYY-MM-DD形式の厳密なISO暦日を、retirement_ageには0から200までの整数年齢を指定してください。

決定論的な暦計算の規則を確認します

計算ではbirth_dateの年にretirement_ageを加え、その月日が対象年に存在する限り、月と日をそのまま保持します。退職年がうるう年でなければ2月28日を返し、leap_day_adjustedをtrueにします。したがって、東京、ロンドン、ニューヨークのどこから実行しても同じJSONを返します。

法的判断ではなく計画用の結果として使用します

応答には、正規化されたbirth_dateとretirement_ageに加えて、retirement_date、retirement_year、leap_day_adjustedが含まれます。自動処理ではAPIの成功1件あたり$0.002で、ブラウザー版も同じ純粋なロジックを使います。

連携の活用例

暦計算の回帰テスト

通常の誕生日、世紀の境界、2月29日の各ケースについて、タイムゾーンに依存しない決定論的な期待日を生成します。

技術的な質問

2月29日生まれはどのように扱いますか。

対象年がうるう年でなければ2月28日を使用し、leap_day_adjustedをtrueにします。うるう年なら2月29日を維持します。

APIでの計算料金はいくらですか。

APIで正常に処理された1件の料金は$0.002です。ブラウザー計算機も同じ決定論的ロジックをローカルで実行します。

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

生年月日から退職資格日を計算

無料で実行

計算例

生年月日と目標年齢を明示的な値として入力します

決定論的な暦計算の規則を確認します

法的判断ではなく計画用の結果として使用します

活用例

従業員の退職計画

年金手続きの準備

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

生年月日と目標年齢を明示的な値として入力します

決定論的な暦計算の規則を確認します

法的判断ではなく計画用の結果として使用します

連携の活用例

暦計算の回帰テスト

技術的な質問

ありがとう