ForHosting KIT · 日付・時間

年進捗率

Q: うるう年でパーセントは変わりますか？

はい。 うるう年は366日なので、2月以降の同じ月日は平年と異なる％に写像されます。2月29日はうるう年のみ受理されます。

Q: 年内通日と同じですか？

いいえ。 年内通日は序数1–366を返します。本能力は年の経過％（と残り％）を返し、どちらも暦計算を使いますが検索意図は異なります。

2024年7月1日は1年のちょうど50%で、366日中183日目、残りも183日です。どの日付でも同じ方法で計算できるので、進捗バーや年間目標の管理、季節ごとの計画に使えます。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

日付: 2024-07-01

結果

年: 2,024
月: 7
日: 1
年内通日: 183

年進捗とは、ある暦日までにすでに過ぎた暦年の割合を、1月1日のほぼゼロから12月31日の100までの百分率で表したものです。製品ダッシュボード、年間目標トラッカー、季節マーケカレンダー、個人の生産性ツールはいずれも、ホストのタイムゾーンや夏時間表と戦わずにその数を必要とします。本計算機は年-月-日の厳密なISO暦日を1つ受け取り、うるう年の2月を含むグレゴリオ暦上で日が実在するかを確認し、年内通日の序数を計算し、その序数に100を掛けて365または366で割ったパーセントを返します。応答には残り日数、残りパーセント、うるうフラグ、年の長さも含まれ、進捗バーとカウントダウンの一貫性を保ちます。平年の2月29日や4月31日のような不可能な日付は黙って繰り越さず、明確な検証エラーで失敗します。

ISO日付から年進捗率を計算する方法

国際ISO形式（ハイフン区切り・固定幅）で年・月・日を書いた暦日から始め、どのクライアントも同じ3整数で合意できるようにします。まず年が実用的なグレゴリオ範囲にあり、月が1〜12であることを確認します。次に世界の暦が用いるうるう規則を適用します。

うるう年は4で割り切れる年ですが、世紀年は400でも割り切れる場合に限ります。これにより2024年や2000年の2月29日は合法、2023年や1900年は非法になります。うるう状態が分かれば、その年の各月の長さを参照し、4月31日や2月30日など月長を超える日を拒否します。

三つ組が有効なら、与えられた月より前の各完全月の長さを足し、その後に日を加えて年内通日の序数を得ます。1月1日は常に1、3月1日はうるう年で61・平年で60、12月31日は366または365です。

実務で年進捗率計算機が使われる場面

製品・成長チームはOKR・売上目標・コンテンツカレンダーの年次進捗バーを描き、うるう日を無視するUnixエポック分数ではなく暦日に合う信頼できるパーセントを必要とします。人事と財務は休暇方針・会計報告窓・研修期限を年の一部として追い、非エンジニアにも読めるダッシュボードにします。

マーケは発売日が固定されたとき、すでに年の何％が過ぎたかを問い季節キャンペーンを組みます。パーセント無しの年内通日だけ、2日付間の営業日、生年月日から年齢、完全なユリウス通日、ISO 8601の週番号が後で必要なら、本ページを過負荷にせず別の検索意図とランディングとして扱ってください。

活用例

年間OKR・目標ダッシュボード

任意のISO日付を年の経過％に変換し、ホストのタイムゾーンなしでうるうを考慮した進捗バーと残り％ラベルを保ちます。

季節マーケカレンダー

キャンペーン発売日を年進捗％に写像し、計画デッキと自動季節トリガーに使います。

よくある質問

うるう年でパーセントは変わりますか？

はい。うるう年は366日なので、2月以降の同じ月日は平年と異なる％に写像されます。2月29日はうるう年のみ受理されます。

日付が無効な場合は？

形式不正、範囲外の月、2023-02-29 のような不可能な日は拒否され課金されません。

年内通日と同じですか？

いいえ。年内通日は序数1–366を返します。本能力は年の経過％（と残り％）を返し、どちらも暦計算を使いますが検索意図は異なります。

年の進捗率はどのように計算しますか？

その日が年の何日目かを、その年の日数である365か366で割り、100を掛けます。そのため12月31日は必ずちょうど100%になります。

年の残りも分かりますか？

分かります。過ぎた割合に加えて、残りの日数と残りの割合も表示されます。2024年7月1日なら残りは183日、50%で、12月31日には0日になります。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/year-progress

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

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

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

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

import os, requests

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

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

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

リクエスト例

{
  "date": "2024-07-01"
}

レスポンス例

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

技術的な注記

無料のブラウザツールと有料APIは同一の純同型関数を共有するため、教室デモと自動パイプラインは同じ入力で決してずれません。

ISO日付から年進捗率を計算する方法

年進捗パーセントは100×day_of_year÷年の長さと定義され、年の最終日はちょうど100％、それ以前は線形に縮尺されます。残り日数は年の長さ−day_of_year、残りパーセントは補数×100です。パイプライン全体は乱数シードなし・壁時計なし・JavaScript Dateなし・ネットワークなしの決定的整数および浮動小数演算なので、同一入力は常に同一JSONを生成します。

送信内容と返却内容

パターンは合うが実在しない日付（平年の2月29日、1〜12外の月など）も問題名を示すメッセージで失敗し、推測なしに修正できます。古典的な検証は、平年の1月1日が約0.27％付近、7月1日が年半ば付近でうるうと平年で1日ずれ、12月31日がちょうど100％です。必須文字列フィールド date に 2024-07-01 のような厳密なISO暦日を送ります。欠落フィールド、非文字列、4-2-2桁パターンに合わない文字列は invalid_input で失敗し課金されません。成功時は正規化済み日付文字列、年・月・日の数値、1〜365または366の day_of_year、真偽値 is_leap_year、365または366の days_in_year、その年の最終日までの remaining_days、経過年割合×100の percent、補数×100の remaining_percent、うるう規則とパーセント定義を示す短い formula を返します。成功したAPI呼び出しの料金は公開ベース $0.002 毎件で、検証失敗は前払い残高を消費しません。

実務で年進捗率計算機が使われる場面

本能力は純 parse エンジンのため、API料金は成功1件あたり公開ベース $0.002 で、検証失敗は残高を消費しません。

連携の活用例

コンプライアンスと休暇トラッカー

厳密なYYYY-MM-DDから安定した％と remaining_days を刻印し、悪い日付には明確な invalid_input を返します。

技術的な質問

年進捗率はどう計算されますか？

percent = 100 × day_of_year / days_in_year です。day_of_year はISO日付の1始まり序数、days_in_year はグレゴリオうるう規則で365または366。12月31日は常にちょうど100%です。

料金はいくらですか？

ブラウザツールは無料でローカル実行です。APIは成功1件あたり $0.002 のKIT前払い残高を使い、無効入力は課金されません。

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

年進捗率

無料で実行

計算例

ISO日付から年進捗率を計算する方法

実務で年進捗率計算機が使われる場面

活用例

年間OKR・目標ダッシュボード

季節マーケカレンダー

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

ISO日付から年進捗率を計算する方法

送信内容と返却内容

実務で年進捗率計算機が使われる場面

連携の活用例

コンプライアンスと休暇トラッカー

技術的な質問

ありがとう