ForHosting KIT · 開発者向けツール

ユリウス暦とグレゴリオ暦の日数差計算

この計算ツールは、明示されたISO日付について、先発グレゴリオ暦と先発ユリウス暦の年単位の日数差を返します。YYYY-MM-DD形式の入力全体を検証して年を取り出し、両暦法に蓄積された閏年規則の差を適用します。結果では、グレゴリオ暦がユリウス暦より進んでいるか、遅れているか、同じかを示します。有限の整数演算だけを使用するため、タイムゾーン設定、ネットワーク、端末時計に依存せず、APIでもブラウザーでも同じ結果を再現できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

日数差が示す内容

ユリウス暦とグレゴリオ暦は平年をほぼ同じように扱いますが、世紀年の閏年規則が異なります。ユリウス暦では、4で割り切れる年はすべて閏年です。グレゴリオ暦では、世紀年が400でも割り切れる場合を除き、追加の1日を設けません。この省かれた日が積み重なり、二つの暦の間に差が生じます。本ツールは、入力されたISO日付の年について、その累積差を示します。正の結果は、同じ年・月・日の表記を年単位の規約で比較したとき、グレゴリオ暦がユリウス暦よりその日数だけ進んでいることを意味します。負の値は遅れを、0は累積した年単位の差がないことを表します。これは日付変換ではなく差の計算です。入力日付を別の暦の対応する年月日に置き換えることはありません。慣例上の日数差が必要な場合に本結果をご利用ください。年月日そのものを変換する場合は、暦変換ツールが適しています。

決定的な計算を行う仕組み

先頭の0を含むYYYY-MM-DD形式で、グレゴリオ暦のISO日付を一つ入力してください。年を使用する前に、月、その月に存在できる日数、グレゴリオ暦の閏年規則を検証します。その後、整数除算によって差を求めます。完了したユリウス暦の世紀閏日と、400年周期のグレゴリオ暦で維持される世紀閏日を比較します。JavaScriptのDateオブジェクトは生成しません。Dateの解析には、ホスト環境の挙動、タイムゾーン規則、暦計算とは無関係な表現上の制限が入り得るためです。同じ入力は、UTC、別のタイムゾーン、ブラウザー、エッジ処理のいずれでも同じJSONを生成します。計算は先発的であり、各国が歴史的にグレゴリオ暦を採用する以前の年にも数学的規則を一貫して延長します。0001から9999までの4桁の西暦年を受け付け、0000、形式不正の文字列、平年の2月29日のような存在しない日付は拒否します。

適切な歴史的解釈の選び方

暦の歴史には、混同しやすい二つの異なる問いがあります。一つはユリウス暦とグレゴリオ暦の規則上の数学的な差、もう一つは特定の場所が特定の日に実際に使用していた民用暦です。本機能が答えるのは前者だけです。国ごとの採用日、歴史上省略された日、教会固有の慣例、史料の不確実性は扱いません。また、年単位の規約により、入力年全体に対して意図的に一つの値を返します。400で割り切れないグレゴリオ暦の世紀年では、2月29日の扱いが両暦で分かれた後に、日付間の正確な差が変化します。そのため、1月または2月の特定日を変換すると、年単位の値と1日異なる場合があります。これは不決定性ではなく、問いの違いです。年ごとの差を明示する表、説明ラベル、検証規則、処理フローには本結果をご利用いただけます。系譜研究や法的年代解釈では、出来事を判断する前に、当時の法域と日付別の変換方針も併用してください。

活用例

歴史データセットへの注記

明示的なISO日付を持つ記録に、再現可能なユリウス暦・グレゴリオ暦の年単位差を追加します。

暦の参照表の作成

システムの日付ライブラリやタイムゾーン設定に頼らず、複数世紀にわたる一貫した差を生成します。

年代規則の確認

日付別の変換を実装する前に、ソフトウェアや文書が意図した暦差を使用しているか確認します。

よくある質問

正の日数差は何を意味しますか？

年単位の規約で、グレゴリオ暦がユリウス暦よりその日数だけ進んでいることを意味します。

入力日付は別の暦へ変換されますか？

いいえ。日付の年に対応する差を返し、入力されたISO日付自体は変更しません。

年だけを使うのに、完全な日付が必要なのはなぜですか？

入力契約を明確にし、年を使う前に形式不正または存在しないISO日付を拒否するためです。

各国がグレゴリオ暦を採用した時期も考慮しますか？

いいえ。先発的な数学規則を適用し、法域や歴史的な採用方針を推測しません。

世紀年の1月と2月には特別な扱いが必要ですか？

正確な日付変換では必要です。本機能は意図的に年単位の値を返すため、閏日の扱いが分かれる前の個別変換とは1日異なる場合があります。

APIリクエストの料金はいくらですか？

APIリクエスト1回の料金は$0.002です。ブラウザーでも同じ決定的なロジックを使用します。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/julian-gregorian-offset

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

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

curl -X POST https://api.kit.forhosting.com/date/julian-gregorian-offset \
  -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/julian-gregorian-offset", {
  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/julian-gregorian-offset",
    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/julian-gregorian-offset", 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/julian-gregorian-offset", 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.julian_gregorian_offset",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

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