Data come anno frazionario
Il convertitore di anno frazionario trasforma una data e ora ISO 8601 esplicita in un anno decimale come 2024.5.
Esegui gratis nel browser
Prima normalizza in UTC lo scostamento indicato, quindi misura i millisecondi esatti trascorsi dall’inizio di quell’anno UTC e li divide per la durata completa dell’anno. La parte intera identifica l’anno UTC, mentre quella decimale colloca l’istante al suo interno. Il calcolo non consulta orologio, posizione, rete o valori predefiniti nascosti: la stessa entrata produce sempre la stessa uscita.
Che cosa rappresenta un anno decimale frazionario
Un anno frazionario riunisce in un solo numero l’etichetta dell’anno civile e una posizione continua al suo interno. La parte intera è l’anno civile UTC che contiene l’istante fornito. La parte decimale è la durata esatta trascorsa dal 1° gennaio alle 00:00:00.000 UTC, divisa per la durata dell’intero anno. Di conseguenza, il primo istante del 2024 vale esattamente 2024 e il punto medio di quell’anno bisestile vale 2024.5. Verso la fine del 2024 il risultato si avvicina a 2025 senza raggiungerlo; il primo istante del 2025 appartiene al nuovo anno e vale esattamente 2025. Questa definizione misura una durata, non pagine di calendario, date completate, mesi, trimestri o giorni lavorativi. Ore, minuti, secondi e millisecondi contribuiscono in proporzione. La risposta comprende la data normalizzata in UTC, l’anno UTC selezionato, i millisecondi trascorsi e quelli totali dell’anno. Lei può quindi esaminare ogni componente o verificare il calcolo in modo indipendente quando una coordinata annuale compatta risulta più comoda di un timestamp, senza perdere l’identità dell’anno civile.
Effetto della normalizzazione UTC e degli anni bisestili
L’entrata deve identificare un istante reale terminando con Z o con uno scostamento numerico come +05:30 o -04:00. Il convertitore applica lo scostamento prima di scegliere l’anno e misurare il tempo trascorso. L’ordine è importante ai confini dell’anno: un’ora locale subito dopo la mezzanotte del 1° gennaio può essere ancora il 31 dicembre in UTC, mentre un’ora locale tarda di dicembre può essere già il 1° gennaio UTC. Le regole gregoriane degli anni bisestili vengono poi applicate all’anno UTC risultante. Gli anni divisibili per quattro hanno 366 giorni, tranne gli anni secolari non divisibili per quattrocento; gli altri ne hanno 365. Il denominatore cambia quindi con l’anno scelto ed evita la deriva prodotta da una durata fissa di 365 giorni. Ogni giorno civile è modellato con esattamente 86,400 secondi e non vengono aggiunti secondi intercalari. Il parser rifiuta scostamenti assenti o errati, date impossibili, giorni bisestili in anni comuni, ore oltre 23, minuti o secondi oltre 59 e più di tre cifre di millisecondi. Rifiutare è preferibile a indovinare un fuso o correggere un timestamp, perché tali scelte comprometterebbero la riproducibilità tra sistemi e browser.
Impiego nei dati e nei flussi scientifici
Gli anni frazionari sono coordinate compatte per osservazioni distribuite su molti anni civili. Una pipeline di serie temporali può convertire timestamp dotati di scostamento prima di regressione, interpolazione, grafici o esportazione, assegnando a ogni record un valore numerico ordinabile e conservando altrove il timestamp originale. I rapporti scientifici usano spesso anni decimali per collocare misure su un asse annuale, mentre le migrazioni possono dover riprodurre valori generati da vecchi sistemi analitici. La risposta deterministica aiuta anche nei test: Capodanno, giorno bisestile, punto medio, attraversamento di fuso e ultimo millisecondo possono essere fissati senza simulare l’orologio di sistema. Conservi la definizione insieme ai dati, poiché altri programmi possono usare conteggi di giorni, convenzioni basate sul mezzogiorno, anni fissi di 365.25 giorni o arrotondamenti diversi. Questa capacità divide i millisecondi UTC esatti trascorsi per la durata esatta dell’anno gregoriano prolettico UTC interessato. Eviti arrotondamenti intermedi e arrotondi soltanto per presentare grafici o rapporti. Non sostituisca un timestamp assoluto con questo valore quando servono reversibilità o ordinamento di istanti estremamente vicini. Una richiesta API riuscita costa $0.002; lo stesso calcolo puro può essere eseguito nel browser.
Casi d'uso
Normalizzare osservazioni temporali
Converta timestamp espliciti con scostamento in coordinate annuali continue per grafici, regressione e interpolazione.
Riprodurre assi di rapporti scientifici
Generi anni frazionari verificabili con una convenzione documentata di durata gregoriana UTC.
Creare test deterministici sulle date
Verifichi anni bisestili e passaggi di fuso senza leggere né simulare l’ora corrente del sistema.
Domande frequenti
Quale formula viene utilizzata?
Il risultato è l’anno UTC più i millisecondi trascorsi dal suo inizio divisi per i millisecondi totali dello stesso anno UTC.
Perché la data deve includere il fuso?
Senza Z o uno scostamento numerico, il testo non identifica un solo istante e può dare risposte diverse in ambienti differenti.
Come vengono gestiti gli anni bisestili?
L’anno UTC interessato usa 366 giorni secondo le regole gregoriane e 365 giorni negli altri casi.
Sono inclusi i secondi intercalari?
No. Ogni giorno civile vale esattamente 86,400 secondi per garantire un risultato portabile e deterministico.
Quanto costa un calcolo tramite API?
Ogni richiesta API riuscita costa $0.002. Il calcolo puro può anche essere eseguito localmente nel browser.
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
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/fractional-year \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"datetime":"2024-07-02T00:00:00Z"}'const res = await fetch("https://api.kit.forhosting.com/date/fractional-year", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"datetime": "2024-07-02T00:00:00Z"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/fractional-year",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"datetime": "2024-07-02T00:00:00Z"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/fractional-year", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"datetime":"2024-07-02T00:00:00Z"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"datetime":"2024-07-02T00:00:00Z"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/fractional-year", 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
{
"datetime": "2024-07-02T00:00:00Z"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.fractional_year",
"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
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. |