Inizio e fine del secolo

Questa capacità accetta una sola data di calendario ISO esplicita in forma YYYY-MM-DD e restituisce il secolo gregoriano storico che la contiene: il numero e l’etichetta ordinali del secolo, il primo e l’ultimo anno, e le stringhe inclusive first_date e last_date. L’algoritmo è aritmetica intera pura solo a partire dal Suo input — nessuna chiamata di rete, nessun orologio di sistema e nessun fuso dell’host — così la stessa data produce sempre lo stesso JSON.

Come i secoli storici mappano gli anni ai limiti primo e ultimo

I giorni bisestili come il 29 febbraio 2024 sono accettati; il 29 febbraio in anni non bisestili e mesi o giorni impossibili sollevano invalid_input così le pipeline non inventano mai un secolo da una data rotta. Richieste identiche producono sempre lo stesso JSON perché il percorso non tocca Date, semi casuali o servizi remoti.

Come leggere first_year, last_year, first_date, last_date e le etichette di secolo

Le date di confine sono deliberate: un input del 31 dicembre 2000 restituisce il XX secolo che termina quel giorno, mentre il 1 gennaio 2001 restituisce il XXI secolo che inizia quel giorno. In caso di successo la risposta include la data di input ripetuta e i suoi componenti year, month e day; l’intero century; century_ordinal come 21st per il ventunesimo; e century_label come 21st century per la visualizzazione. I campi principali del prodotto sono first_year e last_year (interi inclusivi) più first_date e last_date come stringhe YYYY-MM-DD con zeri iniziali: first_date è sempre il primo gennaio del primo anno, e last_date è sempre il trentuno dicembre dell’ultimo anno. length_years è sempre cento in questo contratto. Il campo calendar è sempre gregorian e method è sempre historical_century così il codice a valle può ramificare senza ispezionare le forme. Usi first_date e last_date da soli per clausole SQL BETWEEN, filtri di partizione del data warehouse e intervalli di zoom della timeline; usi first_year e last_year quando costruisce aggregazioni a livello di secolo o tacche degli assi del grafico; usi century_label quando un badge dell’interfaccia o un titolo di lezione necessita di una breve frase umana. Anno fuori da 1–9999, date non stringa, forma ISO errata e giorni del mese impossibili falliscono con invalid_input citando il campo e non vengono addebitati.

Uso dell’API, prezzi, flussi e differenze rispetto agli strumenti di decade

Chiami lo strumento gratuito nel browser di inizio e fine del secolo per piani di lezione, etichette museali, controlli su fogli di calcolo e verifica rapida delle finestre di secolo senza installare una libreria di calendario. Invii un corpo JSON con il campo stringa obbligatorio date impostato a un giorno di calendario ISO esplicito. Usi l’API prepagata quando una pipeline d’archivio, una timeline CMS, un prodotto educativo o un cron di reportistica necessita di un contratto stabile con saldo KIT a $0.002 per elemento riuscito; i fallimenti di validazione non consumano mai saldo dopo il rifiuto del motore. Abbini questo endpoint agli strumenti di inizio e fine di settimana, mese o trimestre quando il passo successivo è un intervallo più fine nello stesso secolo, oppure all’etichettatura di decade e secolo quando ha solo un anno e necessita di tag di decade invece di limiti completi di date di secolo. Gli autori che pubblicano SDK possono mappare first_date e last_date su controlli di intervallo date e century_label su intestazioni. Questo prodotto non converte ere a.C., anno astronomico zero, secoli fiscali né soprannomi informali di secolo a due cifre — sono intenti di ricerca diversi — quindi mantenga le regole di cronologia specializzate nel Suo livello e chiami questa capacità per i limiti storici di secolo dell’era comune a partire da una data ISO.