ForHosting KIT · Date e tempo

Equazione del tempo approssimata

L'11 febbraio 2024, giorno 42 dell'anno, una meridiana è indietro di circa quattordici minuti e mezzo rispetto a un orologio medio. Inserisca una data e ottenga l'equazione del tempo approssimata in minuti: positiva se la meridiana anticipa, negativa se ritarda. Gratis nel suo browser.

Gratis
Funziona nel suo browser
Senza registrazione
I suoi dati restano sul dispositivo

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Esempio risolto

Se inserisce

Data: 2024-02-11

Ottiene

Anno: 2024
Mese: 2
Giorno: 11
Giorno dell'anno: 42

L'equazione del tempo è il numero di minuti che separano la lettura di una meridiana da un orologio medio uniforme sullo stesso meridiano. Nasce perché l'orbita terrestre è leggermente ellittica e l'asse è inclinato, così il mezzogiorno solare vero anticipa o ritarda rispetto al mezzogiorno civile fino a circa sedici minuti nel corso dell'anno. Chi progetta meridiane, inseguitori solari e dimostrazioni didattiche ha bisogno di un valore riproducibile per un giorno di calendario scelto senza richiamare un servizio di effemeridi. Questo calcolatore dell'equazione del tempo approssimata accetta una sola data ISO nel formato YYYY-MM-DD, la converte in giorno dell'anno secondo le regole gregoriane prolettiche di bisestilità e valuta la formula classica a tre termini dei testi di ingegneria solare. Il calcolo è puro e deterministico nello spazio di calendario UTC a partire dalla sola data di ingresso — senza rete, senza casualità e senza dipendere dall'orologio di sistema dell'host.

Cosa significa l'equazione del tempo e l'approssimazione a tre termini

Il tempo solare apparente è ciò che mostra una meridiana correttamente orientata: l'angolo orario del Sole vero. Il tempo solare medio è il giorno uniforme di ventiquattro ore degli orologi civili alla stessa longitudine. La loro differenza è l'equazione del tempo.

Nel corso di un anno lo scostamento oscilla da circa meno quattordici minuti (meridiana in ritardo, spesso a metà febbraio) a circa più sedici minuti (meridiana in anticipo, spesso a inizio novembre), con zeri vicino a metà aprile, metà giugno, inizio settembre e fine dicembre a seconda del modello.

Questa capacità implementa l'approssimazione a tre termini ampiamente insegnata: E uguale a 9.87 volte sin di 2B meno 7.53 volte cos di B meno 1.5 volte sin di B, dove B è due pi su trecentosessantacinque volte N meno ottantuno, e N è il giorno dell'anno con il primo gennaio uguale a uno. Lo sfasamento di ottantuno giorni ancora la fase vicino alla regione dell'equinozio di marzo della formula classica.

L'approssimazione è volutamente semplice: non include serie orbitali di ordine superiore né nutazione, ma è sufficiente per il tracciamento di meridiane, controlli in aula e stime di mezzogiorno solare che richiedono solo una guida al minuto. Gli anni bisestili alimentano comunque il vero giorno di calendario in N tramite le regole gregoriane, mentre il periodo angolare resta fisso a trecentosessantacinque come nel modello da manuale.

Convenzione di segno meridiana meno orologio: un'equazione del tempo positiva significa che il mezzogiorno solare apparente avviene prima del mezzogiorno medio; Lei sottrae quindi E minuti dalla meridiana per allinearsi al tempo medio, oppure aggiunge E al tempo medio per stimare l'ora della meridiana.

Dove l'equazione del tempo è utile

Costruttori di meridiane e guide di siti patrimoniali usano un calcolatore dell'equazione del tempo perché i visitatori comprendano perché il mezzogiorno sul quadrante non è sempre mezzogiorno sull'orologio da polso. Gli installatori di energia solare stimano il mezzogiorno solare vero per controlli di azimut dei pannelli senza erigere un'effemeride planetaria completa. I siti documentali che si posizionano su equazione del tempo approssimata beneficiano di un percorso browser gratuito il cui modulo puro coincide byte per byte con l'automazione a pagamento.

Poiché l'implementazione è matematica analitica parse di livello A, la latenza nel caso peggiore resta trascurabile e la validazione fallita non consuma saldo.

Casi d'uso

Progettazione e interpretazione di meridiane

Converta una data ISO scelta in minuti di scostamento meridiana versus orologio così tabelle di correzione incise e targhe per visitatori restano coerenti con il modello a tre termini.

Valutazione automatica in aula e LMS

Valuti i compiti sull'equazione del tempo con un oracolo deterministico che rifiuta date non valide e restituisce sempre gli stessi minuti per lo stesso YYYY-MM-DD.

Domande frequenti

Cosa significa un'equazione del tempo positiva?

E positivo significa che la meridiana (tempo solare apparente) è avanti rispetto all'orologio medio. E negativo significa che la meridiana è indietro.

Il calcolatore usa il mio fuso orario locale?

No. L'ingresso è solo una data di calendario (etichetta di giorno UTC). Longitudine e offset di fuso civile non vengono applicati; li aggiunga Lei se le serve il mezzogiorno solare locale.

Come si converte la lettura di una meridiana nell'ora dell'orologio?

Sottragga l'equazione del tempo dalla lettura della meridiana. L'11 febbraio 2024 il valore è negativo, circa quattordici minuti e mezzo, quindi deve aggiungere quella quantità all'ora della meridiana per ottenere il tempo medio.

In quale periodo dell'anno la differenza è massima?

Arriva a circa quattordici minuti di ritardo a metà febbraio e a sedici minuti di anticipo all'inizio di novembre. Meridiana e orologio coincidono verso metà aprile, metà giugno, inizio settembre e fine dicembre.

Quanto è precisa l'approssimazione a tre termini?

Tralascia i termini orbitali di ordine superiore e la nutazione, quindi è una guida al minuto e non un'effemeride esatta. Basta per tracciare una meridiana, correggere esercizi in classe o stimare il mezzogiorno solare.

Strumenti correlati

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

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

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

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)

Esempio di richiesta

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

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.equation_of_time_approx",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Note tecniche

Il risultato è equation_of_time_min (identico a sundial_minus_clock_min): positivo quando la meridiana è avanti rispetto all'orologio medio, negativo quando è indietro.

Contratto di ingresso, campi di risposta ed errori di validazione

La data è trattata solo come etichetta di giorno di calendario UTC; longitudine e offset civili locali sono fuori ambito. L'intervallo valido dell'anno è da 0001 a 9999 secondo le regole gregoriane prolettiche di bisestilità (febbraio ha ventinove giorni quando l'anno è divisibile per quattro ma non per cento, salvo se è anche divisibile per quattrocento). Invii con POST un oggetto JSON con il campo stringa obbligatorio date in forma ISO rigorosa YYYY-MM-DD — anno a quattro cifre, mese a due e giorno a due, senza componente oraria né suffisso di fuso. Sono accettati gli alias iso, day e d per lo stesso campo. Valori non stringa, mancanti, stringhe vuote, forme errate come 2024/02/11 e giorni di calendario impossibili come 2023-02-29 falliscono con invalid_input e non vengono addebitati. In caso di successo il corpo restituisce date, year, month, day, day_of_year e is_leap_year; restituisce equation_of_time_min e l'identico sundial_minus_clock_min arrotondati per goldens stabili tra runtime; include b_rad (l'angolo intermedio B in radianti); e fornisce formula, method uguale a three_term_approx e un breve sign_note. Flusso di esempio: invii date 2024-02-11, riceva day_of_year quarantadue e un'equazione del tempo negativa vicino all'estremo di metà febbraio (meridiana indietro rispetto all'orologio medio), adatta a correggere una lettura di meridiana orizzontale verso il tempo medio. Abbini i minuti alla propria correzione di longitudine (quattro minuti per grado di longitudine dal meridiano standard) se le serve il mezzogiorno solare locale rispetto a un orologio di zona; questo endpoint restituisce solo la parte equazione del tempo.

Dove un'API di equazione del tempo approssimata conviene

I laboratori scolastici e i correttori automatici di MOOC necessitano di un oracolo deterministico che associ sempre la stessa data ISO agli stessi minuti, inclusi gli sfasamenti del giorno dell'anno negli anni bisestili, così schede studenti e controlli API non discordano mai. Script di automazione che annotano foto o log con l'ora solare possono chiamare l'API prepagata al prezzo base pubblicato $0.002 per elemento riuscito, senza token di modello e senza rete in uscita dal worker. Mantenga la richiesta a una sola data di calendario, fissi equation_of_time_min arrotondato nei test e otterrà scostamenti meridiana–orologio riproducibili per didattica, UX di prodotto e worker di bordo senza incorporare librerie astronomiche proprie.

Casi di integrazione

Stime di mezzogiorno solare per installatori

Combini equation_of_time_min con i minuti di longitudine dal meridiano per approssimare il mezzogiorno solare apparente locale rispetto a un orologio di zona senza servizio di effemeridi.

Domande tecniche

Come si calcola l'equazione del tempo approssimata per una data?

Invii {"date":"YYYY-MM-DD"}. L'API restituisce equation_of_time_min (e sundial_minus_clock_min) da E=9.87·sin(2B)−7.53·cos(B)−1.5·sin(B) con B=2π/365·(N−81) e N=giorno dell'anno.

Quali date vengono rifiutate?

Data assente o non stringa, forme diverse da YYYY-MM-DD, anni fuori da 0001–9999 e giorni impossibili come 2023-02-29 falliscono con invalid_input e non vengono addebitati.

Quanto costa il calcolatore dell'equazione del tempo approssimata?

Lo strumento nel browser è gratis. Le richieste API usano il saldo prepagato KIT a $0.002 per chiamata riuscita; l'ingresso non valido non viene addebitato.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser