ForHosting KIT · 開発者向けツール

ユリウス日からグレゴリオ暦の日時へ変換

この計算機は、天文学で使われるユリウス日を、対応する先発グレゴリオ暦の日付と時刻へ変換します。有限の数値を入力すると、年、月、日、時、分、秒、ミリ秒を別々の項目で返します。標準的な逆変換手順を用い、整数のユリウス日が深夜ではなく正午に始まるという天文学上の規約も反映します。ネットワーク、システム時計、タイムゾーンデータベースは参照しないため、同じ入力からは常に同じ結果が得られます。ブラウザーでは個別に確認でき、APIでは1回$0.002で科学技術処理を自動化できます。

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

無料で実行 API仕様を見る

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

変換前にユリウス日の規約をご確認ください

ユリウス日は、日とその端数を連続的に数える方式で、天文学、軌道解析、歴史資料、科学ソフトウェアで利用されています。歴史上のユリウス暦で表した日付とは異なります。天文学の計数では、整数の境界は市民時の深夜ではなく世界時の正午に置かれます。たとえば2451545.0は2000年1月1日12:00:00、2451544.5は同じ日の00:00:00です。この計算機は半日のずれを自動的に処理します。julian_dateには有限のJSON数値を指定してください。短い別名jdも利用できます。結果は年、月、日、時、分、秒、ミリ秒に分けて返されます。年には0年を含む天文学的紀年法を用い、歴史的な改暦以前にも先発グレゴリオ暦の規則を適用します。文字列、未指定値、NaN、無限大は、誤解を招く日付へ暗黙変換せずエラーにします。

逆変換で暦の各項目を求める仕組み

変換では、まず入力されたユリウス日に0.5日を加えます。整数部分が深夜から始まる市民日を示し、残りの端数がその日の経過時間を示します。標準的な逆変換アルゴリズムはグレゴリオ暦の世紀補正を適用し、複数の整数中間値を作り、切り捨て演算によって日、月、年を求めます。日の端数はミリ秒へ換算してから、時、分、秒、ミリ秒に分割します。ミリ秒単位に丸めるためJSON結果は安定し、一般に公開されるユリウス日の精度も十分に保てます。丸めが日の終端に一致した場合は、月末、年末、うるう日を含めて翌日へ正しく繰り上げます。Date、コンピューターのタイムゾーン、外部の暦表、乱数は使用しません。また、元データがUTC、TT、TAIなどのどの時間尺度かは推測しません。その意味はデータセット側で記録してください。

研究やソフトウェアで安全に利用する方法

観測表、宇宙機イベント一覧、暦表の書き出し、論文にユリウス日だけがあり、人が読めるグレゴリオ暦の項目が必要な場合に便利です。ホスト環境へ依存せず、暦ライブラリ用の再現可能なテストデータを作る用途にも適しています。取り込み処理では各セルが数値であることを先に確認し、追跡できるよう元のユリウス日も結果と一緒に保存してください。回答は地域形式の文章ではなく各要素を返すため、アプリケーション側でISO形式の文字列、データベース列、画面ラベルを容易に構成できます。ローカル時刻への変換は行いません。単発の確認にはブラウザーを、自動処理には1回$0.002のAPIをご利用ください。別のツールと比較する際は、天文学的ユリウス日、グレゴリオ暦、時間尺度、丸め精度が一致しているかをご確認ください。1日、12時間、秒未満の差の多くは、これらの条件の違いで説明できます。

活用例

天文観測記録

連続したユリウス日の時刻印を、報告書や索引用の読みやすいグレゴリオ暦項目へ変換します。

科学データの取り込み

数値のユリウス日列を、決定論的で個別の年月日・時刻項目として正規化します。

暦ライブラリのテスト

既知の元期、うるう日、月境界、日の端数について再現可能なテストケースを作成します。

よくある質問

APIでの変換料金はいくらですか？

APIは1回$0.002です。対話的な確認にはブラウザー版をご利用いただけます。

整数のユリウス日が正午になるのはなぜですか？

天文学の規約ではユリウス日は正午に始まるため、市民日を求める前に0.5日を加えます。

結果にはどの暦を使用しますか？

先発グレゴリオ暦を使用し、対応するすべての年へグレゴリオ暦のうるう年規則を適用します。

利用者のローカルタイムゾーンを使いますか？

いいえ。タイムゾーンやシステム時計を参照せず、ユリウス日に含まれる時刻を返します。

どのような入力がエラーになりますか？

入力は有限の数値である必要があるため、未指定、文字列、オブジェクト、NaN、正負の無限大は拒否します。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/astro/datetime-from-julian-date

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

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

curl -X POST https://api.kit.forhosting.com/astro/datetime-from-julian-date \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"julian_date":2451545}'

const res = await fetch("https://api.kit.forhosting.com/astro/datetime-from-julian-date", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "julian_date": 2451545
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/astro/datetime-from-julian-date",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "julian_date": 2451545
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"julian_date":2451545}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/datetime-from-julian-date", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "julian_date": 2451545
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.datetime_from_julian_date",
  "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の完全なドキュメントを見る →