日付に月を加算
日付に月数を足すと、後の暦日が分かります。2024年1月31日に1か月を足すと2024年2月29日です。存在しない日は、その月の末日に合わせられます。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 日付
- 2024-01-31
- 月数
- 1
- 結果
- 2024-02-29
- 年
- 2,024
- 月
- 2
- 日
- 29
この日付に月を加算する計算ツールは、YYYY-MM-DD形式の単一のグレゴリオ暦日と非負の整数の月数を受け取り、その基準日から指定した月数だけ後のカレンダー日を返します。代表的な検証例として、2024-01-31に1か月を加えるとうるう年なので2024-02-29になり、2023-01-31に1か月を加えると平年なので2023-02-28になり、2024-03-15に3か月を加えるとクランプなしで2024-06-15になります。エンジンは決定的なグレゴリオ暦の遡及算術のみを使用します。基準日が実在するカレンダー日であることを検証し、要求された月数だけ年と月をずらし、元の日が対象月の日数を超える場合は対象月の最終有効日にクランプし、ネットワーク通信、ランダムサンプリング、ホストの時計に頼ることなく構造化された結果を返します。
月を足すことの意味と、表示される結果
カレンダー上の整数の月を加算することは、固定日数の加算やビジネス期間のカウントとは異なる問いに答えます。それはグレゴリオ暦の市民暦上で年と月を進めながら、その日が存在する場合は同じ日付番号を保ち、存在しない場合は対象月の最終日にクランプします。基準日は厳密なYYYY-MM-DD文字列として、monthsは非負の整数として指定します。
ゼロを指定すれば日付は変わらず、1を指定すれば可能な限り翌月の同じ名目日に進み、より大きな値は年の境界を自動的にまたいでいきます。代表的な月末のケースは明確です。1月31日に1か月を加えると、うるう年かどうかに応じて2月28日または29日になり、3月31日に1か月を加えると4月30日になり、5月31日に1か月を加えると6月30日になります。
この計算ツールは基準日が実在するカレンダー日であることを検証します。2月29日はうるう年のみ、4月は30日まで、32日という日は決して存在しません。ロケール依存の週の開始、月の長さの浮動小数点近似、ホストのDateオブジェクトへの依存はありません。
日数の減算、営業日、エポック変換、複数形式の解析、ISO週番号が必要な場合はそれぞれの専用ツールをご利用ください。このページは、検証済みのISO基準日に整数の月を加算し、月末クランプを適用した後のグレゴリオ暦日にのみ答えます。
日付と月数の読み取り方法と結果を再現可能に保つ仕組み
文字列は4桁の数字、ハイフン、2桁の数字、もう一つのハイフン、2桁の数字に一致しなければなりません。先頭や末尾の空白はトリムされますが、部分的な日付、通日のみの表記、月名はここでは展開されません。
解析後、年は1から9999の間、月は1から12の間、日はその年のその月の実際の長さの範囲内でなければならず、うるう年は4で割り切れるが400で割り切れない世紀年を除くというグレゴリオ暦の規則に従います。
数字文字列の先頭の任意のプラス記号は許可されますが、小数、負数、非数値トークンは明確なメッセージとともに拒否されるため、不正なセルが誤った後の日付につながることはありません。内部的には、エンジンは市民暦の年と月を、年×12+月-1というゼロ始まりの月インデックスに変換し、整数の月数を加えた上で対象の年と月を復元し、元の日をその対象月の日数にクランプします。
これは実行環境間でビット単位まで安定した純粋な整数算術です。
月シフトされた日付が請求・更新・ソフトウェアで役立つ場面
運用チームや財務チームが月を加算するのは、サブスクリプションが暦月3か月ごとに更新される場合、請求書の支払期日が発行から1か月後と定義されている場合、あるいは保証期間がライブの時計ではなく固定された出荷日基準から12か月後と定義されている場合です。
コホートウィンドウを構築するアナリストは同じ操作を用いて、既知の日に始まり固定の月数後に終わる観測期間にラベルを付け、月末やうるう日でのオフバイワンエラーを回避します。
開発者はこの契約をスクリプトから呼び出し、スケジューラー用の決定的なテストベクターを生成したり、給与計算やトライアル期間のフィクスチャを見積もったり、タイムゾーンのずれや一部のDateライブラリが1月31日を前進させる際に生む驚きのない、純粋なカレンダー月ステップを要求する製品要件を満たしたりします。
教育者や標準策定者は、うるう年における2024-01-31プラス1か月と平年における2023-01-31プラス1か月のように、製品ごとに異なるスプレッドシートのシリアル番号に頼らずクランプの挙動を実演するためにこのツールを使います。このページでの計算はすべてブラウザ内で完結します。
関連するカレンダー操作が必要なときは日数の減算、エポック変換、日付の正規化、ISO週ヘルパーと組み合わせ、日付ユーティリティの小さなラボを構築する際は他の無料の決定的なツールと組み合わせてご利用ください。
活用例
サブスクリプションと請求サイクル
検証済みの発行日からNか月後の次回更新日または請求期日を見積もり、月末の日付を正しくクランプします。
月末とうるう日のクランプ
1月31日に1か月を加えると、うるう年のみ2月29日に、平年は2月28日になることをDateの癖なしに検証できます。
よくある質問
後の日付はどのように定義されますか?
エンジンは検証済みのYYYY-MM-DD基準日に非負の整数のグレゴリオ暦月を加算し、可能な場合は同じ日付番号を保ち、そうでない場合は対象月の最終有効日にクランプします。
月末やうるう年の場合はどうなりますか?
月の長さとうるう日は検証・適用されます。たとえば2024-01-31に1か月を加えると2024-02-29に、2023-01-31に1か月を加えると2023-02-28になります。
どの日付形式と月数が受け付けられますか?
基準日は厳密なYYYY-MM-DD形式のカレンダー日付のみ、monthsは0から119988までの整数のみです。
タイムゾーンの変換や現在時刻を使いますか?
いいえ。 検証済みのカレンダー日にN整数か月を純粋な算術で加算するだけです。Dateオブジェクト、タイムゾーンのシフト、「今日」への依存はありません。
月を引くこともできますか？
できません。このツールは足し算専用で、0以上の整数の月数だけを受け付け、マイナスの値は拒否します。0を入力すると、日付はそのまま返ります。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/date/add-months \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-01-31","months":1}'const res = await fetch("https://api.kit.forhosting.com/date/add-months", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-01-31",
"months": 1
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/add-months",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-01-31",
"months": 1
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/add-months", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-01-31","months":1}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-01-31","months":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/add-months", 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-31",
"months": 1
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.add_months",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
制限
year_min | 1 |
year_max | 9999 |
months_min | 0 |
months_max | 119988 |
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
請求サイクルや更新、宿題にはブラウザで無料にご利用いただき、CI、レポーティングパイプライン、製品機能で再現可能な月シフト済みフィクスチャが必要な場合は、成功したリクエストごとに$0.002のAPIをご利用ください。
月の加算が意味すること、そしてレスポンスの内容
その上で、正規化された基準日、使用したmonths数、YYYY-MM-DD形式の後の日付であるresult、結果のyear・month・dayの各フィールド、日付が短縮された場合にtrueとなるclampedブール値、対象月の日数を表すdays_in_result_month、後続処理へのパイプ渡しを容易にする基準日の構成要素base_year・base_month・base_day、そして短い式の説明を返します。入力が有効範囲内の月数を持つ実在のカレンダー日であれば後の日付は完全に決定され、そうでなければinvalid_inputでリクエストは失敗します。拒否されるケースには、dateまたはmonthsフィールドの欠落、2024/01/31のような誤った形式、不可能な月、2023-02-29のような存在しない日、負の月数、そして結果の年がサポート範囲である1から9999の外に出るケースが含まれます。
日付と月数の読み取り方法と結果を再現可能に保つ仕組み
優先される基準フィールドはdateですが、iso_date、d、value、baseといった別名も受け付けるため、スプレッドシート、クエリ文字列、型付きフォームは列名を変えずに同じ契約を再利用できます。monthsフィールドは、別名n、count、addを持ち、0から119988までの整数でなければなりません。自動化されたパイプライン内で同一の月シフト済みの日付が必要な場合は、このページの無料ブラウザ実行と有料APIを組み合わせてご利用ください。
月シフトされた日付が請求・更新・ソフトウェアで役立つ場面
API経由では成功した検索1件につき$0.002がかかり、検証に失敗したリクエストは課金されず、レスポンスが返された後は何も保存されません。この無料のインタラクティブな探索と、同一結果を返す有料APIという分割は、KITのtier-Aカタログの他のツールと同様であり、単発のチェックからパイプラインへ、数学的な結果を変えることなく移行できます。
連携の活用例
決定的なテストフィクスチャ
DateやホストのAPIに依存せずに、ユニットテストやプロパティチェック、CIアサーション向けに再現可能な月シフト済みISO文字列を生成できます。
技術的な質問
日付に月を加算する計算ツールの料金はいくらですか?
このページのブラウザ版は無料です。API経由では成功したリクエストごとに$0.002がかかり、無効な入力には課金されません。