ForHosting KIT · 日付・時間

年間経過日数

2024年3月15日には年のうち74日が過ぎており、うるう年の75日目に当たります。日付を入れると、1月1日を0として、その日までに過ぎた日数が分かります。ブラウザで無料で使えます。

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

この年間経過日数を計算するツールは、厳密なYYYY-MM-DD形式の1つのグレゴリオ暦日を受け取り、その年の1月1日からすでに何日経過したかを返します。代表的な検証例として、2024-01-01は経過日数0、うるう年の2024-03-15は74日、平年の2023-12-31は364日となります。エンジンは決定的なグレゴリオ暦の遡及算術のみを使用します。その日が実際にカレンダー上に存在することを検証し、指定された月より前の各月の日数を合計し、日付番号を加え、1月1日が1ではなく0になるよう1を引きます。ネットワーク通信もランダムサンプリングもホストの時計やDateオブジェクトへの依存もありません。

経過日数の意味と結果の内容

1月1日からの経過日数は、人々が時に1から366までの通日として印刷する序数の年内日、任意の2つの日付の間の整数日の距離、営業日や年齢計算とは異なる問いに答えます。ここでは年の時計は1月1日にゼロから始まります。うるう年の3月15日までにはすでに74日の丸1日が終わっており、そのカレンダー日自体はその年の75番目の日です。

単一の日付を厳密なYYYY-MM-DD文字列として指定します。この計算ツールはその日が実在するグレゴリオ暦日であることを検証します。2月29日はうるう年のみ、4月は30日まで、32日という日は決して存在しません。

ロケール依存の週の開始、日の長さの浮動小数点近似、ホストのDateオブジェクトへの依存はありません。2つの日付の間の距離、ISO週番号、日数の減算によるナビゲーション、複数形式の解析が必要な場合はそれぞれの専用ツールをご利用ください。このページは、指定された日付を含む年の1月1日から何日の丸1日が経過したかのみに答えます。

年内進捗の算術が計画立案・レポーティング・ソフトウェアで役立つ場面

運用チームやプロダクトチームが年間経過日数を測定するのは、ダッシュボードが年初来の進捗を表示する場合、ポリシーが新年からN番目の暦日を参照する場合、あるいは保持期間やレポーティングウィンドウがライブの時計ではなく1月1日を基準に定義されている場合です。

年間コホートを構築するアナリストは同じ数値を用いて、スプレッドシートのシリアル番号を手作業で引き算するときに現れる月末やうるう日でのオフバイワンエラーなしに、年内の観測位置にラベルを付けます。

教育者や標準策定者は、2024-02-29がうるう年の60日目であるのに対し、同じ2月の長さは2023年には存在しないことを、時刻をサイレントに含めてしまう不透明な電卓アプリに頼ることなく実演するためにこのツールを使います。このページでの計算はすべてブラウザ内で完結します。

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

年初来の進捗表示

タイムゾーンのずれなしに、ダッシュボード、OKRのタイムライン、年間進捗バー向けに1月1日からの経過暦日数を表示します。

うるう年の年内通日チェック

うるう年のみ2月29日をまたぐ序数と経過日数の位置を検証でき、12月31日は経過日数364または365になります。

これは2つの日付の間の日数と同じですか?

いいえ。 このツールは同じ年の1月1日からの距離のみを測定します。任意の2つの日付の組み合わせには、2つの日付の間の日数を計算するツールをご利用ください。

時刻やタイムゾーンは含まれますか?

いいえ。 このツールは純粋なグレゴリオ暦の日数のみを数えます。時刻、オフセット、ホストの時計を解析することはありません。

1月1日が0になるのはなぜですか?

終わった日数を数えるため、1月1日にはまだ1日も終わっていないからです。その日付の通し番号は常に1つ多く、2023年12月31日なら364日が過ぎています。

うるう年では数え方がどう変わりますか?

2月29日はうるう年にしかないため、それ以降の日付はすべて1日分先に進みます。2024年なら、2月29日そのものが年の60日目です。

日付はどんな書き方で入れればよいですか?

2024-03-15のように、年・月・日をハイフンでつないだ形だけです。2024/03/15のような形や月の名前、時刻付きの日付は受け付けません。前後の空白は取り除かれます。

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

POSThttps://api.kit.forhosting.com/date/days-elapsed-year

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

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

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

1リクエストあたり$0.002

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

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

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

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

その上で、正規化された日付文字列、year・month・dayの各構成要素、1始まりの序数であるday_of_year、day_of_year引く1であるdays_elapsed、真偽値のis_leap、365または366のdays_in_year、そして短い式の説明を返します。入力がサポートされる年の範囲内の実在するカレンダー日であれば経過日数は完全に決定され、そうでなければinvalid_inputでリクエストは失敗します。拒否されるケースには、dateフィールドの欠落、2024/03/15のような誤った形式、不可能な月、2023-02-29のような存在しない日、1から9999の範囲外の年が含まれます。

dateの読み取り方法とカウントを再現可能に保つ仕組み

文字列は4桁の数字、ハイフン、2桁の数字、もう一つのハイフン、2桁の数字に一致しなければなりません。先頭や末尾の空白はトリムされますが、部分的な日付、通日のみの表記、月名、埋め込まれた時刻はここでは展開されません。解析後、年は1から9999の間、月は1から12の間、日はその年のその月の実際の長さの範囲内でなければならず、うるう年は4で割り切れるが400で割り切れない世紀年を除くというグレゴリオ暦の規則に従います。優先されるフィールドはdateですが、iso_date、d、value、dayといった別名も受け付けるため、スプレッドシート、クエリ文字列、型付きフォームは列名を変えずに同じ契約を再利用できます。内部的には、エンジンは指定された月より前の各完全な月の日数を合計してday_of_yearを求め、日付番号を加え、days_elapsedをday_of_year引く1に設定します。これは実行環境間でビット単位まで安定した純粋な整数算術です。1月1日は常に経過日数0とday_of_year1を生み、12月31日は平年で経過日数364、うるう年で経過日数365を生みます。自動化されたパイプライン内で同一の経過日数が必要な場合は、このページの無料ブラウザ実行と有料APIを組み合わせてご利用ください。

年内進捗の算術が計画立案・レポーティング・ソフトウェアで役立つ場面

開発者はこの契約をスクリプトから呼び出し、進捗バー用の決定的なテストベクターを生成したり、分析ペイロードのday_of_yearフィールドを検証したり、ホストのDateオブジェクトによるタイムゾーンのずれのない純粋なカレンダーオフセットを要求する製品要件を満たしたりします。API経由では成功した検索1件につき$0.002がかかり、検証に失敗したリクエストは課金されず、レスポンスが返された後は何も保存されません。この無料のインタラクティブな探索と、同一結果を返す有料APIという分割は、KITのtier-Aカタログの他のツールと同様であり、単発のチェックからパイプラインへ、数学的な結果を変えることなく移行できます。

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

Dateに依存せずに、ユニットテストやプロパティチェック、CIアサーション向けに再現可能なdays_elapsedとday_of_yearの数値を生成できます。

年間経過日数を計算するツールの料金はいくらですか?

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

days_elapsedはどのように定義されますか?

days_elapsedはday_of_year引く1です。1月1日は0を、1月2日は1を生みます。day_of_yearは1始まりの序数です(1月1日で1)。

うるう年や無効な日付の場合はどうなりますか?

月の長さとうるう日は検証されます。たとえば2024-02-29は受け付けられますが、2023-02-29はinvalid_inputで拒否されます。

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