年の最初の日と最後の日
2024年6月15日なら、その年は2024-01-01から2024-12-31までで、うるう年のため366日あります。2つの日付は、年次報告や絞り込み、保存フォルダー、保存期間の設定にそのまま使えます。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 日付
- 2024-06-15
- 年
- 2,024
- 初日
- 2024-01-01
- 最終日
- 2024-12-31
- 年の日数
- 366
この計算機は、明示されたISO形式の日付を受け取り、同じ暦年に属する両端の日付を返します。現在時刻を調べずに1月1日と12月31日が必要なレポート、検索条件、アーカイブ、検証規則に便利です。結果を生成する前に、世紀年のうるう年規則も含め、入力が実在するグレゴリオ暦の日付か確認します。処理にはJavaScriptのDateオブジェクトを使わず、固定形式の文字列解析と整数演算だけを使います。そのため、サーバーのタイムゾーン、夏時間、ロケール、実行時刻によって答えが変わりません。応答には年、うるう年かどうか、その年の日数も含まれます。
年の両端を求める仕組み
年4桁、月2桁、日2桁をハイフンで区切った日付を入力してください。各要素を分離し、先発グレゴリオ暦に従って検証します。月は01から12までで、許される日は月と年によって異なります。
4で割り切れる年の2月は29日ありますが、世紀年は400でも割り切れる必要があります。したがって2000はうるう年、1900は平年、2024はうるう年です。日付が実在すると確認できれば、境界には年だけを使います。
最初の日は4桁の年に01-01を付け、最後の日は同じ年に12-31を付けます。追加日は2月にあるため、うるう年でも境界は変わりません。現在の日付を問い合わせず、Dateによる解析も行わないため、UTCサーバー、ローカルブラウザー、エッジワーカーのいずれでも同じISO文字列になります。
外部通信はなく、計算量は一定です。
受け付ける日付と結果の内容
例は2024-06-15です。形式は意図的に厳格で、2024-6-15のような省略、スラッシュ、タイムスタンプ、前後の空白、各言語固有の日付表現は拒否されます。同じ文字列が環境ごとに別の意味になることを防ぐためです。
月0、月13、4月31日、2月30日、平年の2月29日も拒否します。成功時には検証済みの日付と整数のyearを返します。日付は常に明示かつ必須で、省略しても今日の日付には置き換わりません。
そのため、保存した要求や履歴処理を後から再現できます。
暦年の境界を安全に使う方法
暦年の境界は、年次データベース検索、報告期間、文書フォルダー、保存ラベル、日付選択の初期値に役立ちます。別のシステムがタイムスタンプを必要とする場合は、結果を受け取った後で、そのシステムのタイムゾーン方針を明示的に適用します。半開区間では、返された初日を含む下限とし、翌年1月1日を含まない上限として別途求める設計が一般的です。
この機能は、人向けの予定で分かりやすい実際の最終暦日を意図的に返します。会計年度、学年度、移動12か月、営業日、現在年は計算しません。これらには追加の規則が必要です。
テストには2月29日、世紀の境界、1月1日、12月31日付近を選べます。
活用例
年次レポートの絞り込み
日付付き取引から1月1日と12月31日の両端を求め、暦年単位で一貫した検索を行えます。
アーカイブとフォルダーの命名
端末の現在年やタイムゾーンに依存せず、レコードの日付から安定した年間境界を得られます。
よくある質問
現在の年を使用しますか？
いいえ。 明示されたISO日付が必須で、その入力内の年だけを使うため、現在の時計は結果に影響しません。
必要な日付形式は何ですか？
2024-06-15のように桁数を固定したYYYY-MM-DDを使用してください。タイムスタンプ、スラッシュ、省略表記、実在しない日は拒否されます。
最初の日と最後の日も範囲に含まれますか？
含まれます。1月1日と12月31日はどちらも範囲の一部なので、両端を含む期間の指定にそのまま使え、1日を足したり引いたりする必要はありません。
うるう年だと最初の日や最後の日は変わりますか？
変わりません。増える1日は2月の中にあるため、1月1日と12月31日はいつも同じです。変わるのは年間の日数で、うるう年は366日、平年は365日です。
時刻を含むデータで使うときの注意点は？
結果は時刻ではなく暦の日付として扱い、時間帯の決まりはご自身で当てはめてください。翌年の直前で終わる範囲が必要なら、翌年の1月1日を終わりに使います。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/date/year-start-end \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-06-15"}'const res = await fetch("https://api.kit.forhosting.com/date/year-start-end", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-06-15"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/year-start-end",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-06-15"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/year-start-end", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-06-15"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-06-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/year-start-end", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"date": "2024-06-15"
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.year_start_end",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
年の両端を求める仕組み
days_in_yearは365または366となり、is_leap_yearも返されます。
入力検証と応答フィールド
必須のdateフィールドを持つオブジェクトを送信してください。first_dayとlast_dayは両端を含むISO日付で、範囲フィルターに利用できます。is_leap_yearとdays_in_yearにより、別の計算をせず年間予定やうるう年処理を確認できます。不正な入力は、別の月へ自動補正されず、説明付きのinvalid_inputになります。ブラウザーとAPIは同じ純粋なsolve関数を共有します。
暦年の境界を安全に使う方法
first_dayとlast_dayは瞬間ではなく暦日として扱ってください。成功したAPI要求は1件$0.002で、ブラウザーでは同じ純粋な計算を無料で実行できます。ネットワーク、時計、乱数、隠れたロケール状態がないため、同じ入力から常に同じJSONが得られます。
連携の活用例
暦処理の回帰テスト
平年、うるう年、世紀年の例外を対象に、予測可能な境界とうるう年情報を生成します。
技術的な質問
最初の日と最後の日を範囲に含みますか？
はい。first_dayは入力年の1月1日、last_dayは12月31日で、どちらもその暦年に含まれます。
うるう年では境界が変わりますか？
いいえ。境界の間に2月29日が加わるだけです。日付は1月1日と12月31日のままで、days_in_yearが366になります。
API要求の料金はいくらですか？
成功したAPI要求は1件$0.002です。ブラウザー版では、同じ決定的な計算を端末内で無料実行できます。