Convertitore data ordinale ISO
Il 15 marzo 2024 è il 75° giorno dell'anno, scritto 2024-075 in forma ordinale ISO. Converta qualsiasi data nel suo numero di giorno dell'anno e viceversa, con gli anni bisestili già considerati. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Data
- 2024-03-15
- Anno
- 2024
- Mese
- 3
- Giorno
- 15
- Giorno dell'anno
- 75
La norma ISO 8601 definisce due forme di data civile che condividono lo stesso anno ma esprimono il giorno in modo diverso: la consueta tripletta anno-mese-giorno e la forma ordinale con l'anno più il giorno dell'anno, da 1 a 365 oppure 366. Pipeline che archiviano numeri di giorno sequenziali, dataset scientifici, bolle logistiche e registri di conformità hanno spesso bisogno di un ponte senza perdite tra queste due forme, senza dipendere dagli oggetti Date del linguaggio ospite né dalle ambiguità dei fusi orari.
Forma di calendario, forma ordinale e quando usare ciascuna direzione
Una data di calendario ISO si scrive con l'anno a quattro cifre, il mese a due cifre e il giorno a due cifre separati da trattini, ad esempio 2024-03-15 per il 15 marzo. Una data ordinale ISO usa lo stesso anno, un trattino e un giorno dell'anno a tre cifre che va da 001 il 1° gennaio fino a 365 in un anno comune o 366 in un anno bisestile gregoriano.
Converta dal calendario all'ordinale quando le serve un indice di giorno compatto per un anno, nomi di file sequenziali o analisi che trattano ogni giorno come un asse intero. Converta dall'ordinale al calendario quando un flusso fornisce solo il giorno dell'anno mentre la sua interfaccia, fattura o validatore si aspetta mese e giorno.
Anni bisestili, lunghezza dell'anno ed errori sul giorno dell'anno
Secondo le regole gregoriane un anno è bisestile quando è divisibile per quattro, con l'eccezione che gli anni secolari devono essere divisibili anche per quattrocento. Gli anni bisestili hanno 366 giorni e un febbraio di 29 giorni; gli anni comuni hanno 365 giorni e un febbraio di 28 giorni. Ecco perché il 2000 è bisestile, il 1900 non lo è, e il 2024 è bisestile mentre il 2023 non lo è.
Anche gli input di calendario con un giorno impossibile per il mese, come il 31 aprile o il 29 febbraio in un anno non bisestile, vengono rifiutati.
Casi d'uso
Indici di giorno scientifici e da sensori
Le pipeline di ricerca archiviano i campioni come anno più giorno dell'anno; li converta in date di calendario per i report e di nuovo in forma ordinale per archivi compatti senza derive dell'oggetto Date.
Logistica e denominazione di file batch
Magazzini e lavori batch nominano i file con sequenze YYYY-DDD e hanno bisogno di un ponte affidabile verso etichette YYYY-MM-DD leggibili nelle interfacce e nelle fatture.
Validazione di flussi ordinali
Le integrazioni che ricevono il giorno dell'anno dai partner rifiutano valori in eccesso, come il giorno 366 in un anno non bisestile, prima che entrino nei sistemi di fatturazione o pianificazione.
Domande frequenti
Cosa succede se il giorno ordinale supera la lunghezza dell'anno?
Ad esempio il giorno 366 in un anno non bisestile, o qualsiasi giorno oltre 366, viene rifiutato e non viene addebitato.
Il convertitore di data ordinale ISO è gratuito?
Lo strumento nel browser funziona gratuitamente sul suo dispositivo.
Qual è la data ordinale del 15 marzo 2024?
È 2024-075, perché il 15 marzo è il 75° giorno del 2024. Prima viene l'anno, poi un conteggio di tre cifre che parte da 001 il 1 gennaio.
Perché un anno bisestile cambia il numero dei giorni dopo febbraio?
L'anno bisestile aggiunge il 29 febbraio, quindi ogni data dal 1 marzo in poi riceve un numero più alto di uno rispetto a un anno comune. Per questo il conteggio arriva a 366 e non a 365.
Posso trasformare un numero di giorno dell'anno in una data normale?
Sì. Inserisca l'anno e il numero del giorno, ad esempio 2024-075, e otterrà mese e giorno, in questo caso il 15 marzo 2024. Un numero più grande della durata di quell'anno viene rifiutato.
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
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/ordinal-date \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-15","calendar":"valor-ejemplo"}'const res = await fetch("https://api.kit.forhosting.com/date/ordinal-date", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-15",
"calendar": "valor-ejemplo"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/ordinal-date",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-15",
"calendar": "valor-ejemplo"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/ordinal-date", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-15","calendar":"valor-ejemplo"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-15","calendar":"valor-ejemplo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/ordinal-date", 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-03-15",
"calendar": "valor-ejemplo"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.ordinal_date",
"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. |
Note tecniche
Questo convertitore di data ordinale ISO mappa YYYY-MM-DD in YYYY-DDD e nella direzione inversa con aritmetica gregoriana deterministica, rifiuta i giorni dell'anno che superano la lunghezza reale dell'anno e restituisce entrambe le rappresentazioni più i campi strutturati in un unico payload JSON.
Forma di calendario, forma ordinale e quando usare ciascuna direzione
Invii una stringa data, una stringa ordinale, anno più mese più giorno, oppure anno più day_of_year; alias come calendar_date, ordinal_date, doy e ddd sono accettati quando documentati. Non mescoli modalità opposte in una sola richiesta: il motore rifiuta i payload ambigui con invalid_input, così il chiamante corregge il corpo invece di indovinare quale campo prevale. Input identici producono sempre JSON identici, perché il percorso non legge mai l'orologio di sistema, la locale o la rete.
Anni bisestili, lunghezza dell'anno ed errori sul giorno dell'anno
Nella conversione da ordinale a calendario, qualsiasi giorno dell'anno inferiore a uno o superiore alla lunghezza dell'anno fallisce con invalid_input e un messaggio che indica i giorni effettivi di quell'anno: ad esempio il giorno 366 nel 2023 supera la lunghezza dell'anno. La risposta riporta is_leap_year e days_in_year, così i cruscotti possono mostrare i dati dell'anno senza una seconda chiamata.
Uso dell'API, prezzi, flussi di lavoro e limiti pratici
Usi il convertitore gratuito nel browser per verifiche di compiti, dimostrazioni di inserimento dati e controlli rapidi senza installare librerie di calendario. I limiti dell'anno seguono l'intervallo di parametri pubblicato per la sicurezza dell'isolamento e la compatibilità con i comuni strumenti civili ISO. Invii un corpo JSON con una modalità chiara: date come YYYY-MM-DD, ordinal come YYYY-DDD, anno mese giorno strutturati, oppure anno e day_of_year strutturati. In caso di successo il payload include calendar_date, ordinal_date, le componenti numeriche, direction uguale a to_ordinal o to_calendar, calendar uguale a gregorian e method uguale a iso_ordinal_date, utili per router e test che si diramano sulle etichette. Usi l'API prepagata quando una piattaforma logistica, una pipeline scientifica, un archivio di conformità o un SDK necessita un contratto stabile con saldo KIT a $0.002 per elemento riuscito; i fallimenti di validazione non consumano mai saldo dopo che il motore ha rifiutato la richiesta. Abbini questo endpoint agli strumenti sui giorni del mese quando le serve solo la lunghezza di febbraio, oppure ai formattatori quando il passo successivo è la visualizzazione localizzata di una data di calendario già normalizzata.
Domande tecniche
Come converto YYYY-MM-DD in una data ordinale ISO?
Invii JSON con date impostato a una stringa di calendario come 2024-03-15, oppure invii year, month e day. La risposta include ordinal_date come YYYY-DDD e day_of_year come intero.
Come riconverto YYYY-DDD in una data di calendario?
Invii ordinal come 2024-075, oppure year più day_of_year. La risposta restituisce calendar_date come YYYY-MM-DD con month e day compilati.
Usa l'oggetto Date di JavaScript o i fusi orari?
No. La conversione usa pura aritmetica gregoriana degli anni bisestili e lunghezze cumulative dei mesi, quindi i risultati sono identici in ogni ambiente e sicuri per i test golden.