ForHosting KIT · Strumenti per sviluppatori

Calcolatore del giorno dell’anno da una data

Questo calcolatore converte una data di calendario nella sua posizione ordinale nell’anno.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Inserendo una data nel formato YYYY-MM-DD, Lei ottiene un intero da 1 a 365, oppure fino a 366 in un anno bisestile. Il calcolo applica le regole gregoriane, verifica il numero effettivo di giorni di ogni mese e rifiuta le date impossibili anziché correggerle senza avviso. È utile quando una data leggibile deve diventare un indice annuale compatto.

Converta una data in un numero ordinale

Il giorno dell’anno indica quanti giorni di calendario sono trascorsi dal 1 gennaio alla data specificata, contando il 1 gennaio come giorno 1. Inserisca quattro cifre per l’anno, due per il mese e due per il giorno, separate da trattini. Una data dei primi giorni di gennaio restituisce un numero basso, mentre una di fine dicembre produce un valore vicino a 365 o 366. Il risultato contiene un solo intero day_of_year, semplice da archiviare, confrontare o riutilizzare. Il formato è volutamente rigoroso: anni abbreviati, componenti riordinati, timestamp e forme locali vengono rifiutati perché possono essere interpretati diversamente dai sistemi. Il calcolatore usa il calendario gregoriano e accetta gli anni da 0001 a 9999. Non dipende dall’orologio del server, dal fuso orario, dall’ora legale o dalla data corrente; pertanto lo stesso input genera sempre lo stesso output.

Gestione degli anni bisestili e della durata dei mesi

L’ordinale si calcola sommando la durata completa dei mesi precedenti e il giorno richiesto. Febbraio è l’unico mese variabile. Secondo le regole gregoriane, un anno divisibile per quattro è normalmente bisestile, ma un anno secolare lo è soltanto se è divisibile anche per quattrocento. Quindi 2024 e 2000 includono il 29 febbraio, mentre 1900 e 2100 no. La differenza incide su ogni data successiva: il 1 marzo è il giorno 61 in un anno bisestile e il giorno 60 in uno comune. Le stesse regole convalidano la data prima della somma. Il 31 aprile, il 30 febbraio, il giorno zero, il tredicesimo mese e il 29 febbraio di un anno comune causano un errore. Il calcolatore non sposta mai una data non valida al mese seguente, evitando che un ordinale plausibile nasconda un dato sorgente errato.

Utilizzi il risultato in dati e pianificazioni

I giorni ordinali sono utili quando conta la posizione nell’anno ma non la separazione tra mesi. Le osservazioni ambientali possono essere raggruppate per stagione, i registri industriali possono identificare un giorno produttivo e i report possono creare sequenze annuali coerenti per i grafici. Il valore agevola anche il confronto tra date dello stesso anno, ma non dovrebbe sostituire la data originale se i record coprono anni diversi: il giorno 32 ricorre ogni anno. Conservi l’anno accanto all’ordinale quando identità o ordinamento attraversano il confine annuale. Per eventi ricorrenti, consideri che gli anni bisestili spostano gli ordinali dopo il 28 febbraio; uno stesso anniversario può avere numeri diversi. Viceversa, un ordinale fisso può indicare un’altra data vicino a febbraio. L’API costa $0.002 per richiesta; il browser esegue localmente lo stesso calcolo deterministico, senza rete, posizione geografica o impostazioni di fuso orario.

Casi d'uso

Indicizzare osservazioni annuali

Converta rilevazioni meteorologiche, agricole o di laboratorio in una posizione annuale coerente per l’analisi stagionale.

Verificare le etichette di produzione

Confronti l’ordinale usato in produzione, logistica o registri di lotto con la data originale.

Preparare le date per i report

Aggiunga il giorno dell’anno a set di dati e grafici senza dipendere dalle impostazioni locali o dal fuso orario del foglio di calcolo.

Domande frequenti

Quale intervallo può avere il risultato?

Il risultato va da 1 a 365 in un anno comune e da 1 a 366 in un anno bisestile.

Quale formato di data è accettato?

Utilizzi esattamente YYYY-MM-DD, inclusi gli zeri iniziali per mesi e giorni a una cifra.

Come vengono determinati gli anni bisestili?

Gli anni divisibili per quattro sono bisestili, salvo quelli secolari, che devono essere divisibili anche per quattrocento.

Che cosa accade se la data non è valida?

La richiesta restituisce un errore di input non valido per formati errati e date impossibili.

Il calcolo dipende dal fuso orario?

No. Esegue direttamente l’aritmetica del calendario senza convertire la data in un timestamp.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Lo stesso calcolo può essere eseguito anche 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

POSThttps://api.kit.forhosting.com/astro/day-of-year

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/astro/day-of-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-12-31"}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/astro/day-of-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-12-31"
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"date":"2024-12-31"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/astro/day-of-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

{
  "date": "2024-12-31"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "astro.day_of_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

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.

Leggi la documentazione completa del KIT →