Differenza in decenni tra due date

Inserisca una data iniziale e una finale nel formato YYYY-MM-DD: riceverà un intero positivo se la seconda data è successiva, negativo se è precedente e zero se non sono trascorsi dieci anni interi. Il calcolo applica regole fisse del calendario gregoriano in UTC, senza dipendere dall’ora corrente, dal fuso orario del browser o da servizi esterni.

Che cosa indica un decennio intero in questo calcolo

Un decennio intero è un intervallo completo di dieci anni di calendario misurato dalla prima data, non un semplice confronto tra i nomi dei decenni. Dal 15 giugno 2000 al 14 giugno 2020 è trascorso un solo decennio intero, perché manca ancora un giorno al secondo anniversario decennale. Il 15 giugno 2020 il risultato diventa due. Questa distinzione impedisce di arrotondare per eccesso date vicine a un anniversario solo perché i rispettivi anni differiscono di venti. Significa inoltre che due date possono trovarsi in decenni nominali diversi e produrre comunque zero. L’output è volutamente un intero e scarta qualsiasi resto incompleto successivo all’ultimo anniversario di dieci anni. Tale comportamento è utile quando una politica, un archivio, un contratto o una regola di rendicontazione fa riferimento a decenni compiuti anziché a una durata approssimativa. Entrambi gli input devono essere date ISO esplicite in formato YYYY-MM-DD, affinché l’interpretazione sia chiara e riproducibile.

Segno, regole UTC e giorni bisestili

Il segno segue l’ordine in cui Lei fornisce le date. Se la seconda data è successiva alla prima, il conteggio è positivo. Se è precedente, lo stesso numero di decenni interi viene restituito come intero negativo. Date uguali producono zero. Invertendo la coppia cambia quindi il segno ma non il valore assoluto, un comportamento pratico per ordinamenti, confronti e calcoli direzionali. La convalida e l’aritmetica adottano il calendario gregoriano prolettico e non utilizzano l’oggetto Date di JavaScript. Non intervengono conversioni di fuso locale, passaggi all’ora legale, orologio corrente, richieste di rete o parser dipendenti dalla lingua. Se la data iniziale è il 29 febbraio, l’anniversario viene considerato il 28 febbraio quando l’anno di destinazione non è bisestile. Questa regola esplicita stabilizza il risultato ai confini bisestili e rimane coerente con la normale aritmetica delle durate di calendario. Sono ammessi gli anni da 0001 a 9999.

Come utilizzare correttamente il risultato

Invii la data ISO iniziale nel campo from e quella finale nel campo to. La risposta ripete entrambi gli input convalidati, fornisce il numero di decenni con segno e indica la direzione come avanti, indietro o zero. Utilizzi direttamente l’intero quando occorrono periodi completi di dieci anni, per esempio per raggruppare programmi di lunga durata, verificare il superamento di una ricorrenza o descrivere la distanza tra documenti storici. Non lo consideri una stima decimale degli anni: un risultato pari a tre dichiara che sono trascorsi tre decenni completi di calendario, non che le date distino esattamente trent’anni senza mesi o giorni residui. Questa capacità non ricava date da frasi in linguaggio naturale, formati regionali, timestamp o dal momento presente. Tali esclusioni sono intenzionali, perché input espliciti rendono deterministiche le chiamate ripetute all’API. Una richiesta via API costa $0.002; la versione nel browser utilizza lo stesso calcolo puro e restituisce un risultato corrispondente.