ForHosting KIT · 日付・時間

近似均時差計算

Q: 計算機は現地のタイムゾーンを使いますか？

いいえ。 入力は暦日のみ（UTC の日ラベル）です。経度や民用ゾーンオフセットは適用されません。現地太陽正午が必要ならご自身で加えてください。

2024年2月11日（その年の42日目）には、日時計は平均時計より約十四分半遅れます。日付を入力すると、日時計が進むときは正、遅れるときは負の値で、近似の均時差を分単位で求めます。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

日付: 2024-02-11

結果

年: 2,024
月: 2
日: 11
年間通算日: 42

均時差とは、同一子午線上で日時計の示す時刻と一様な平均時計との差を分で表したものです。地球軌道がわずかに楕円であることと地軸の傾きにより、真太陽正午は民用正午に対して年間で最大およそ十六分ほど進んだり遅れたりします。日時計・太陽追尾・教育デモの設計者は、暦日を選んだときに天文暦サービスを呼ばず再現可能な数値が必要です。本近似均時差計算機は YYYY-MM-DD 形式のISO日付を一つ受け取り、先発グレゴリオ閏年規則で通日に変換し、太陽工学テキストで用いられる古典的三項公式を評価します。計算は入力日付のみからUTC暦空間で純粋かつ決定的に行われ、ネットワークも乱数もホストのシステム時計にも依存しません。

均時差の意味と三項近似

視太陽時は正しく向き付けられた日時計が示すもので、真の太陽の時角です。平均太陽時は同じ経度の民用時計の一様な二十四時間日です。

その差が均時差です。一年を通じてオフセットはおよそマイナス十四分（日時計が遅れる、しばしば二月中旬）からおよそプラス十六分（日時計が進む、しばしば十一月初旬）まで振れ、モデルにより四月中旬・六月中旬・九月初旬・十二月下旬付近で零になります。本機能は広く教えられる三項近似を実装します。

E は 9.87 倍の 2B の sin から 7.53 倍の B の cos と 1.5 倍の B の sin を引いたもので、B は二πを三百六十五で割ったものに N から八十一を引いた値を掛けたもの、N は一月一日を一とする通日です。八十一日のずれは古典公式の三月分点付近の位相を固定します。

近似は意図的に単純で、高次の軌道級数や章動は含みませんが、日時計の配置、教室での確認、分単位の指針で足りる太陽正午推定には十分です。閏年でもグレゴリオ規則で真の暦日が N に入り、角度周期は教科書どおり三百六十五のままです。符号は日時計マイナス時計です。

正の均時差は視太陽正午が平均正午より早いことを意味し、平均時に合わせるには日時計から E 分を引き、日時計時刻を推定するには平均時に E を加えます。

均時差が役立つ場面

日時計製作者や文化財解説者は、盤面の正午が腕時計の十二時と一致しない理由を来訪者に示すために均時差計算機を使います。太陽光設置者は完全な惑星暦を立てずにパネル方位確認用の真太陽正午を推定します。近似均時差で検索される文書サイトは、有料自動化経路とバイト一致する純粋モジュールの無料ブラウザ経路から恩恵を受けます。

モデルトークンも worker からの外向きネットワークも不要です。実装は parse ティア A の解析数学のため最悪遅延は無視でき、検証失敗は残高を消費しません。

活用例

日時計の設計と解説

選んだ ISO 日付を日時計対時計の分差に変換し、刻印補正表と来訪者向け銘板を三項モデルと一致させます。

教室・LMS の自動採点

無効日付を拒否し同一 YYYY-MM-DD には常に同じ分を返す決定的オラクルで均時差の課題を採点します。

よくある質問

正の均時差は何を意味しますか？

正の E は日時計（視太陽時）が平均時計より進んでいることを意味します。負の E は日時計が遅れていることです。

計算機は現地のタイムゾーンを使いますか？

いいえ。入力は暦日のみ（UTC の日ラベル）です。経度や民用ゾーンオフセットは適用されません。現地太陽正午が必要ならご自身で加えてください。

日時計の読みを時計の時刻に直すには？

日時計の読みから均時差を引きます。2024年2月11日は値が約十四分半のマイナスなので、日時計の示す時刻にその分を足すと平均時になります。

1年のうち差が最も大きくなるのはいつですか？

2月中旬ごろに約十四分の遅れ、11月初めごろに約十六分の進みになります。4月中旬、6月中旬、9月初め、12月下旬ごろには日時計と時計がほぼ一致します。

3項の近似式はどのくらい正確ですか？

高次の軌道の項や章動を省いているため、正確な天体暦ではなく分単位の目安です。日時計の設計や授業の確認、南中時刻の見積もりには十分な精度です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/date/equation-of-time-approx

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

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

curl -X POST https://api.kit.forhosting.com/date/equation-of-time-approx \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-02-11"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/equation-of-time-approx",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-02-11"
},
)
task_id = res.json()["task_id"]

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

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

リクエスト例

{
  "date": "2024-02-11"
}

レスポンス例

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

技術的な注記

結果は equation_of_time_min（sundial_minus_clock_min と同一）で、日時計が平均時計より進んでいれば正、遅れていれば負です。

入力契約・応答フィールド・検証エラー

日付はUTC暦日ラベルとしてのみ扱われ、経度や現地民用オフセットは範囲外です。年の有効範囲は先発グレゴリオ閏年規則の下で 0001 から 9999 です（年が四で割り切れ百で割り切れない場合、または四百でも割り切れる場合に二月は二十九日）。標準子午線からの経度一度につき四分の経度補正をご自身で組み合わせればゾーン時計に対する現地太陽正午が得られます。必須文字列フィールド date を厳密な ISO 形式 YYYY-MM-DD（四桁年・二桁月・二桁日、時刻成分なし・タイムゾーン接尾辞なし）で含む JSON オブジェクトを POST してください。同一フィールドに alias の iso、day、d も受け付けます。文字列以外、欠落、空文字列、2024/02/11 のような誤形式、2023-02-29 のような存在しない暦日は invalid_input で失敗し課金されません。例：date に 2024-02-11 を送ると day_of_year 四十二と二月中旬の極付近で負の均時差（日時計が平均時計より遅れ）が返り、水平日時計の読みを平均時へ補正するのに適します。本エンドポイントは均時差部分のみを返します。

近似均時差 API が役立つ場面

教室ラボや MOOC の自動採点は、閏日による通日ずれを含め同一 ISO 日付を常に同一の分に写す決定的オラクルを必要とし、課題票と API 検査が食い違わないようにします。写真やログに太陽時注釈を付ける自動化スクリプトは、成功一件あたり公開の基本料金 $0.002 でプリペイド API を呼べます。リクエストを単一日付に保ち、テストで丸めた equation_of_time_min を固定すれば、自前の天文ライブラリなしに教育・製品 UX・エッジ worker 向けに再現可能な日時計対時計オフセットが得られます。

連携の活用例

設置者向け太陽正午の見積り

equation_of_time_min と子午線からの経度分を組み合わせ、暦サービスなしにゾーン時計に対する現地視太陽正午を近似します。

技術的な質問

ある日付の近似均時差はどう計算しますか？

{"date":"YYYY-MM-DD"} を送ってください。API は E=9.87·sin(2B)−7.53·cos(B)−1.5·sin(B)、B=2π/365·(N−81)、N=通日から equation_of_time_min（および sundial_minus_clock_min）を返します。

どの日付が拒否されますか？

欠落や非文字列の date、YYYY-MM-DD 以外の形、0001–9999 外の年、2023-02-29 のような存在しない日は invalid_input で失敗し課金されません。

近似均時差計算機の料金は？

ブラウザツールは無料です。API は成功した呼び出しごとにプリペイド KIT 残高から $0.002 です。無効入力は課金されません。

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