ForHosting KIT · 日付・時間

年内の残り日数

Q: うるう年で答えは変わりますか？

はい。 うるう年は366日なので、2月以降の通算日と残り日数は、年が4で割り切れる場合（通常の世紀例外あり）の2月29日を織り込みます。

2026年7月25日は365日中の206日目で、12月31日までは残り159日です。日付を入力すると、年末までの残り日数、年内の通算日、うるう年かどうかが分かります。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

日付: 2026-07-25

結果

年: 2,026
月: 7
日: 25
通日: 206

年内の残り日数計算機は、毎週のように聞かれる計画の問い—ある暦日から年が終わるまでに何日の全日が残るか—に答えます。年-月-日形式のISO日付を貼り付けると、同年の12月31日までの残り日数、年内通算日、グレゴリオうるう年かどうか、年末のISO文字列を返します。

グレゴリオ暦における「年末までの残り日数」の意味

ISO暦日付は年を4桁、ハイフン、月を2桁、もう一つのハイフン、日を2桁で書きます—例として二千二十六ハイフン零七ハイフン二十五。その下ではグレゴリオ暦が月の長さを決めます。大半の月は三十日か三十一日、二月は平年二十八日、うるう年のみ二十九日です。

うるう年は四で割り切れる年すべてですが、四百で割り切れない世紀年は除きます。年内通算日はその年における日付の序数位置です。一月一日が一日目、十二月三十一日が三百六十五日目または三百六十六日目です。

年末までの残り日数は年の長さからその通算日を引いたものと定義され、最後の暦日は残り全日ゼロ、一月一日は平年で三百六十四、うるう年で三百六十五となります。この定義はカウントダウンや年末計画の日常語と一致し、翌年の地平線を作ったり営業日だけを数えたりしません。

実務上の注意、制限、関連検索

常に完全な暦日付だけを送り、時刻成分や末尾のZ付きdatetimeは送らないでください。このツールは拡張ISOタイムスタンプを意図的に拒否し、タイムゾーン依存の真夜中が誤って符号化されないようにします。教育や試験では小さな既知集合を保ってください。

年半ばの平日、平年とうるう年の一月一日、残りゼロの十二月三十一日、成功する有効な二月二十九日、二千二十三ハイフン零二ハイフン二十九のような意図的失敗です。年の上限は九千九百九十九で、この製品面では四桁ISO文字列を明確に保ちます。

このページは年内残り日数、年末までの残り日数、ISO日付からの年末カウントダウンを探す方向けで、営業日カウンタでもロケール対応日付整形でも複数年の間隔計算機でもありません。すでに一つのISO日付があり年末残りだけが必要なときにこの機能を選び、週末と祝日を除く稼働日が必要ならbusiness-days機能を使ってください。

活用例

年末プロジェクトと休暇の計画

管理者が目標のISO日付を入力し、休暇バッファ・凍結期間・納品締切のために12月31日までの全日暦日数を確認します。

年内通算日の宿題確認

学生が手計算の通算日と残り日数を、うるう年の2月規則を含む決定的結果と照合します。

よくある質問

年末までの残り日数はどう数えますか？

平年の1月1日は残り364日、12月31日は0です。同一年内で指定日の後に残る全日暦日の数です。

うるう年で答えは変わりますか？

はい。うるう年は366日なので、2月以降の通算日と残り日数は、年が4で割り切れる場合（通常の世紀例外あり）の2月29日を織り込みます。

ある日付が1年の何日目かは分かりますか？

はい、結果と一緒に表示されます。1月1日が1日目なので、2026年7月25日は365日中の206日目、12月31日は365日目、うるう年なら366日目です。

営業日だけを数えることはできますか？

いいえ、できません。週末や祝日を含むすべての暦日を数えます。結果は年の日数から入力日の通算日を引いた値で、営業日のルールは使いません。

日付が受け付けられないのはなぜですか？

存在しない日付か、形が正しくないためです。うるう年でない年の2月29日や、時刻を付けた日付は受け付けず、暦の日付だけを使います。

開発者向け — APIアクセス

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

エンドポイント

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

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

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

curl -X POST https://api.kit.forhosting.com/date/days-remaining-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-25"}'

const res = await fetch("https://api.kit.forhosting.com/date/days-remaining-year", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2026-07-25"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/days-remaining-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-07-25"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2026-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/days-remaining-year", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "date": "2026-07-25"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.days_remaining_year",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

料金

1リクエストあたり$0.002

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

制限

`year_min`	1
`year_max`	9999

エラー

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

技術的な注記

形が違う、存在しない月、うるう年以外の2月29日などの無効な文字列は、誤った静かな答えではなく明確なinvalid_inputで拒否します。

グレゴリオ暦における「年末までの残り日数」の意味

日常文で月先書きや日先書きのロケールでも曖昧にならないため、APIやデータベースがこれを好みます。ツールはホストのDateコンストラクタを開かないため、ブラウザがAPIのWorkerと異なるタイムゾーンで動いても結果がずれず、うるう日の境界は整数の整除規則だけで決まります。

APIの呼び出し方と返却内容

値は四桁・ハイフン・二桁・ハイフン・二桁の厳密なパターンに一致し、年一から九千九百九十九までの包括範囲の実在するグレゴリオ日でなければなりません。必須の文字列フィールドdateを含むJSON本体を送ります。iso_date、value、dayという別名でも渡せます。成功時は正規の日付文字列、数値のyear・month・day、1始まりのday_of_year、三百六十五または三百六十六のdays_in_year、十二月三十一日までの同一の非負整数であるdays_remainingとdays_left、経過日としてday_of_yearと同じdays_elapsed、真偽値のleap_year、その年の十二月三十一日のISO文字列year_end、短いmessageと解析と減算を言い直す順序付きsteps配列を返します。欠落フィールド、非文字列型、形の不良、範囲外の年、存在しない月や日、うるうでない二月二十九日はinvalid_inputを返し課金されません。料金は成功リクエストごとに一律$0.002で、単位アイテムと限界単価ゼロです。

実務上の注意、制限、関連検索

クライアントを制御できる場合は主フィールド名dateを優先し、iso_dateやvalueとラベル付けされたフォームとの互換のために別名があります。往復確認は簡単です。月の長さから手計算でday_of_yearを再計算し、days_in_yearからその序数を引いた値がdays_remainingと等しいことを確かめます。invalid_inputを返す失敗タスクは前払い残高を消費しないため、学習者がわざと悪い日付を送る探索スクリプトも安く保てます。

連携の活用例

アプリとテスト用カウントダウンfixture

開発者がホスト時計やタイムゾーンに依存せず、単体テストとUIカウントダウン用の既知の残り日数を生成します。

技術的な質問

12月31日はどうなりますか？

ツールは days_remaining = 0 を返し、入力が年の最終日であることを示します。翌年には繰り越しません。

日付が無効な場合は？

欠落フィールド、YYYY-MM-DD以外の文字列、存在しない月や日、うるうでない2月29日はinvalid_inputを返し、課金されません。

年内残り日数計算機は無料ですか？

ブラウザツールは無料でローカル実行です。API呼び出しは成功リクエストごとに$0.002の前払いKIT残高を使い、失敗タスクは課金されません。

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

年内の残り日数

無料で実行

計算例

グレゴリオ暦における「年末までの残り日数」の意味

実務上の注意、制限、関連検索

活用例

年末プロジェクトと休暇の計画

年内通算日の宿題確認

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

制限

エラー

技術的な注記

グレゴリオ暦における「年末までの残り日数」の意味

APIの呼び出し方と返却内容

実務上の注意、制限、関連検索

連携の活用例

アプリとテスト用カウントダウンfixture

技術的な質問

ありがとう