ForHosting KIT · 日付・時間

日付から日数を減算

日付と日数を入力すると、さかのぼった日付が分かります。2024年3月15日から10日を引くと2024年3月5日です。月末やうるう年、年の変わり目も自動で処理します。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
日付
2024-03-15
日数
10
結果
結果
2024-03-05
年
2,024
月
3
日
5

この日付から日数を減算する計算ツールは、YYYY-MM-DD形式の単一のグレゴリオ暦日と非負の整数の日数を受け取り、その基準日から指定した日数だけ前のカレンダー日を返します。代表的な検証例として、2024-03-15から10日を引くと2024-03-05に、2024-03-01から1日を引くとうるう年なので2024-02-29に、2024-01-01から1日を引くと2023-12-31にさかのぼります。エンジンは決定的なグレゴリオ暦の遡及算術のみを使用します。基準日が実際にカレンダー上に存在することを検証し、3項組を通し日数に変換し、要求された整数の日数を引き、ネットワーク通信、ランダムサンプリング、ホストの時計に頼ることなくyear・month・dayに戻します。

日数を引く意味と結果に含まれるもの

整数の暦日を減算することは、営業日数やタイムゾーンを考慮したタイムスタンプとは異なる問いに答えます。それは週末、祝日、夏時間の切り替えをスキップすることなく、真夜中から前の真夜中へとグレゴリオ暦の市民暦上を厳密に後退します。基準日は厳密なYYYY-MM-DD文字列として、daysは非負の整数として指定します。

ゼロを指定すれば日付は変わらず、1を指定すればその基準日に対する昨日に進み、より大きな値は月や年の境界を自動的にまたいでいきます。この計算ツールは基準日が実在するカレンダー日であることを検証します。2月29日はうるう年のみ、4月は30日まで、32日という日は決して存在しません。

ロケール依存の週の開始、日の長さの浮動小数点近似、ホストのDateオブジェクトへの依存はありません。営業日、エポック変換、複数形式の解析、ISO週番号が必要な場合はそれぞれの専用ツールをご利用ください。このページは、検証済みのISO基準日から整数の日数を減算した後のグレゴリオ暦日にのみ答えます。

以前の日付の算術が計画立案・コンプライアンス・ソフトウェアで役立つ場面

運用チームや財務チームが日数を減算するのは、ポリシーが請求書は30暦日で失効すると定めている場合、通知がイベントの14日前に送られなければならない場合、あるいは保持期間がライブの時計ではなく固定された基準スタンプから90日前と定義されている場合です。

過去のコホートを構築するアナリストは同じ操作を用いて、既知の日に終わり固定の日数だけ前に始まる観測ウィンドウにラベルを付け、月末やうるう日でのオフバイワンエラーを回避します。

開発者はこの契約をスクリプトから呼び出し、スケジューラー用の決定的なテストベクターを生成したり、給与計算やサブスクリプションのトライアル用のフィクスチャを過去日付にしたり、タイムゾーンのずれのない純粋なカレンダーステップを要求する製品要件を満たしたりします。

教育者や標準策定者は、うるう年における2024-03-01マイナス1日と平年における2023-03-01マイナス1日のように、製品ごとに異なるスプレッドシートのシリアル番号に頼らず月末の巻き戻しを実演するためにこのツールを使います。このページでの計算はすべてブラウザ内で完結します。

関連するカレンダー操作が必要なときはエポック変換、日付の正規化、ISO週ヘルパーと組み合わせ、日付ユーティリティの小さなラボを構築する際は他の無料の決定的なツールと組み合わせてご利用ください。

ポリシーと通知のウィンドウ

タイムゾーンのずれなしに、請求書、法的通知、保持ウィンドウのために締切のN日前のカレンダー日を計算します。

月末とうるう日の巻き戻し

3月1日から1日を引くと、うるう年のみ2月29日に着地し、年境界が正しく前年の12月に巻き戻ることを検証できます。

以前の日付はどのように定義されますか?

エンジンは検証済みのYYYY-MM-DD基準日から非負の整数のグレゴリオ暦日を、純粋な通し日数算術を用いて減算します。週末や祝日はスキップされません。

うるう年や月末の場合はどうなりますか?

月の長さとうるう日は検証・適用されます。たとえば2024-03-01から1日を引くと2024-02-29に、2023-03-01から1日を引くと2023-02-28になります。

どの日付形式と日数が受け付けられますか?

基準日は厳密なYYYY-MM-DD形式のカレンダー日付のみ、daysは0から3652430までの整数のみです。

タイムゾーンの変換や現在時刻を使いますか?

いいえ。 検証済みのカレンダー日からN整数日を純粋な算術で減算するだけです。Dateオブジェクト、タイムゾーンのシフト、「今日」への依存はありません。

土日や祝日は飛ばされますか?

飛ばされません。土曜、日曜、祝日、夏時間の切り替えも含め、暦の上のすべての日を数えます。営業日で数える決まりの場合は、営業日の計算を使ってください。

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

POSThttps://api.kit.forhosting.com/date/subtract-days

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

curl -X POST https://api.kit.forhosting.com/date/subtract-days \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-03-15","days":10}'
{
  "date": "2024-03-15",
  "days": 10
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.subtract_days",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

year_min1
year_max9999
days_min0
days_max3652430
HTTPコード意味
401unauthorizedAPIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
402insufficient_balance残高が不足しています。チャージ後に再度お試しください。
404unknown_type指定されたタスクタイプは存在しません。タイプ名を確認してください。
429rate_limitedリクエストが多すぎます。しばらく待ってから再度お試しください。

計画立案、コンプライアンス、宿題にはブラウザで無料にご利用いただき、CI、レポーティングパイプライン、製品機能で再現可能な以前の日付フィクスチャが必要な場合は、成功したリクエストごとに$0.002のAPIをご利用ください。

日数の減算が意味すること、そしてレスポンスの内容

その上で、正規化された基準日、使用したdays数、YYYY-MM-DD形式の以前の日付であるresult、結果のyear・month・dayの各フィールド、後続処理へのパイプ渡しを容易にする基準日の構成要素base_year・base_month・base_day、そして短い式の説明を返します。入力が有効範囲内の日数を持つ実在のカレンダー日であれば以前の日付は完全に決定され、そうでなければinvalid_inputでリクエストは失敗します。拒否されるケースには、dateまたはdaysフィールドの欠落、2024/03/15のような誤った形式、不可能な月、2023-02-29のような存在しない日、負の日数、そして結果の年がサポート範囲である1から9999の外に出るケースが含まれます。

日付と日数の読み取り方法と結果を再現可能に保つ仕組み

文字列は4桁の数字、ハイフン、2桁の数字、もう一つのハイフン、2桁の数字に一致しなければなりません。先頭や末尾の空白はトリムされますが、部分的な日付、通日のみの表記、月名はここでは展開されません。解析後、年は1から9999の間、月は1から12の間、日はその年のその月の実際の長さの範囲内でなければならず、うるう年は4で割り切れるが400で割り切れない世紀年を除くというグレゴリオ暦の規則に従います。数字文字列の先頭の任意のプラス記号は許可されますが、小数、負数、非数値トークンは明確なメッセージとともに拒否されるため、不正なセルが誤った以前の日付につながることはありません。優先される基準フィールドはdateですが、iso_date、d、value、baseといった別名も受け付けるため、スプレッドシート、クエリ文字列、型付きフォームは列名を変えずに同じ契約を再利用できます。daysフィールドは、別名n、count、subtractを持ち、0から3652430までの整数でなければなりません。内部的には、エンジンはよく知られたdays_from_civilマッピングを用いて市民暦の3項組を遡及グレゴリオ暦の通し日数に変換し、整数の日数を引いた上でcivil_from_daysでyear・month・dayを復元します。これは実行環境間でビット単位まで安定した純粋な整数算術です。自動化されたパイプライン内で同一の以前の日付が必要な場合は、このページの無料ブラウザ実行と有料APIを組み合わせてご利用ください。

以前の日付の算術が計画立案・コンプライアンス・ソフトウェアで役立つ場面

API経由では成功した検索1件につき$0.002がかかり、検証に失敗したリクエストは課金されず、レスポンスが返された後は何も保存されません。この無料のインタラクティブな探索と、同一結果を返す有料APIという分割は、KITのtier-Aカタログの他のツールと同様であり、単発のチェックからパイプラインへ、数学的な結果を変えることなく移行できます。

決定的なテストフィクスチャ

DateやホストのAPIに依存せずに、ユニットテストやプロパティチェック、CIアサーション向けに再現可能な以前の日付文字列を生成できます。

日付から日数を減算する計算ツールの料金はいくらですか?

このページのブラウザ版は無料です。API経由では成功したリクエストごとに$0.002がかかり、無効な入力には課金されません。

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