Giorni trascorsi nell'anno

Cosa significano i giorni trascorsi e cosa contiene la risposta

Fornite una singola data come stringa rigorosa AAAA-MM-GG; il calcolatore verifica che il giorno sia un vero giorno di calendario gregoriano — 29 febbraio solo negli anni bisestili, trenta giorni in aprile, mai il giorno trentadue — quindi restituisce la stringa data normalizzata, i componenti year, month e day, day_of_year come ordinale a base uno, days_elapsed come day_of_year meno uno, is_leap come booleano, days_in_year come trecentosessantacinque o trecentosessantasei, e un breve promemoria della formula. Non c'è un inizio settimana dipendente dalla lingua, nessuna approssimazione in virgola mobile della lunghezza di un giorno, e nessun affidamento all'oggetto Date dell'host: o l'input è un vero giorno di calendario dentro la finestra d'anno supportata e il conteggio trascorso è completamente determinato, oppure la richiesta fallisce con invalid_input. I casi rifiutati includono un campo date mancante, forme errate come 2024/03/15, mesi impossibili, giorni inesistenti come 2023-02-29, e anni fuori dall'intervallo uno-9999.

Come viene letta la data e come il conteggio resta riproducibile

La stringa deve corrispondere a quattro cifre, un trattino, due cifre, un altro trattino e due cifre; gli spazi iniziali o finali vengono rimossi, ma le date parziali, il solo giorno ordinale dell'anno, i nomi dei mesi e gli orari incorporati non vengono espansi qui. Dopo l'analisi, l'anno deve essere compreso tra 1 e 9999, il mese tra 1 e 12, e il giorno tra 1 e la vera lunghezza di quel mese in quell'anno, con gli anni bisestili che seguono la regola gregoriana: divisibili per quattro tranne i secoli non divisibili per quattrocento. Il campo preferito è date, ma sono accettati gli alias iso_date, d, value e day così fogli di calcolo, query string e form tipizzati possono riusare lo stesso contratto senza rinominare colonne. Internamente il motore somma i giorni in ogni mese completo precedente al mese dato, aggiunge il giorno del mese per ottenere day_of_year, quindi imposta days_elapsed a day_of_year meno uno — aritmetica a interi pura, stabile bit per bit tra i runtime. Il 1° gennaio produce sempre zero trascorsi e day_of_year uno; il 31 dicembre produce trecentosessantaquattro trascorsi in un anno comune e trecentosessantacinque in un anno bisestile. Abbinate l'esecuzione gratuita nel browser di questa pagina all'API a pagamento quando vi serve lo stesso numero di giorni trascorsi dentro una pipeline automatizzata.

Dove si inserisce l'aritmetica del progresso annuale in pianificazione, reportistica e software

Gli sviluppatori richiamano il contratto dagli script per generare vettori di test deterministici per barre di progresso, per verificare i campi del giorno dell'anno nei payload di analytics, o per soddisfare requisiti di prodotto che richiedono uno scostamento puramente calendariale senza deriva di fuso orario dall'oggetto Date dell'host. In questa pagina il lavoro viene svolto interamente nel browser; tramite l'API ogni ricerca riuscita costa $0.002, la convalida fallita non viene addebitata e nulla viene conservato dopo la restituzione della risposta. Questa divisione — esplorazione interattiva gratuita e API a pagamento identica — corrisponde al resto del catalogo tier A del KIT e permette di passare da un controllo occasionale a una pipeline senza cambiare il risultato matematico.