Primo e ultimo giorno dell’anno
Per il 15 giugno 2024 l'anno va dal 2024-01-01 al 2024-12-31 e conta 366 giorni perché è bisestile. Usi queste due date come limiti pronti per report annuali, filtri, cartelle d'archivio o etichette di conservazione. 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-06-15
- Anno
- 2024
- Primo giorno
- 2024-01-01
- Ultimo giorno
- 2024-12-31
- Giorni dell'anno
- 366
Questo calcolatore riceve una data ISO esplicita e restituisce i due estremi inclusivi dello stesso anno civile. È utile quando un report, un filtro, un archivio o una regola di convalida richiede il 1° gennaio e il 31 dicembre senza consultare l’orologio attuale. Prima del risultato, l’input viene verificato come data gregoriana reale, comprese le regole secolari degli anni bisestili. L’elaborazione usa soltanto analisi fissa delle stringhe e aritmetica intera, non l’oggetto Date di JavaScript. Il fuso del server, l’ora legale, le impostazioni locali e l’istante di esecuzione non possono quindi modificare la risposta. Sono indicati anche l’anno, la sua natura bisestile e il numero totale di giorni.
Come vengono ricavati gli estremi dell’anno
Inserisca una data con esattamente quattro cifre per l’anno, due per il mese e due per il giorno, separate da trattini. Il calcolatore divide i componenti e li convalida secondo il calendario gregoriano prolettico. Il mese deve essere compreso tra 01 e 12, mentre il giorno ammesso dipende dal mese e dall’anno.
Febbraio ha 29 giorni se l’anno è divisibile per quattro, ma gli anni secolari devono essere divisibili anche per quattrocento: 2000 è bisestile, 1900 non lo è e 2024 sì. Dopo aver accertato che la data esiste, per gli estremi serve solo l’anno. Il primo giorno inclusivo è l’anno seguito da 01-01; l’ultimo è lo stesso anno seguito da 12-31.
In un anno bisestile gli estremi non cambiano, perché il giorno aggiuntivo cade in febbraio. Non consulta mai la data corrente e non usa Date, quindi un server UTC, un browser e un worker generano le medesime stringhe ISO. L’operazione è costante e non effettua chiamate esterne.
Convalida dell’input e campi della risposta
Invii un oggetto con il campo obbligatorio date, per esempio 2024-06-15. La sintassi è volutamente rigorosa: vengono rifiutati mesi abbreviati come 2024-6-15, barre, timestamp, spazi esterni ed espressioni localizzate. Ciò evita che due sistemi interpretino diversamente lo stesso testo.
La capacità rifiuta anche il mese zero, il mese tredici, il 31 aprile, il 30 febbraio e il 29 febbraio di un anno comune. La data è sempre esplicita e obbligatoria: se manca, non viene sostituita con oggi. Richieste salvate e lavori storici restano così riproducibili.
Uso sicuro degli estremi dell’anno civile
Gli estremi dell’anno civile sono utili per query annuali, intervalli di report, cartelle documentali, etichette di conservazione e valori iniziali nei selettori di data. Se un altro sistema richiede timestamp, applichi esplicitamente la sua politica di fuso orario dopo aver ricevuto il risultato. Per intervalli temporali semiaperti, si usa spesso il primo giorno come limite inferiore inclusivo e si calcola separatamente il 1° gennaio successivo come limite superiore esclusivo.
Questa capacità restituisce intenzionalmente l’ultimo giorno reale dell’anno richiesto, più chiaro per i calendari destinati alle persone. Non calcola anni fiscali o scolastici, periodi mobili, giorni lavorativi o l’anno corrente: sono concetti che richiedono regole ulteriori. Per i test scelga date vicine al 29 febbraio, ai confini secolari, al 1° gennaio e al 31 dicembre.
Casi d'uso
Filtri per report annuali
Trasformi ogni transazione datata negli estremi inclusivi dal 1° gennaio al 31 dicembre per interrogare coerentemente l’anno civile.
Nomi di archivi e cartelle
Ricavi limiti annuali stabili dalla data di un record senza dipendere dall’anno corrente o dal fuso orario del computer.
Domande frequenti
Il calcolatore usa l’anno corrente?
No. Richiede una data ISO esplicita e usa soltanto l’anno contenuto nell’input, quindi l’orologio corrente non influenza la risposta.
Quale formato deve avere la data?
Usi rigorosamente YYYY-MM-DD con componenti a larghezza fissa, come 2024-06-15. Timestamp, barre, componenti abbreviati e date impossibili vengono rifiutati.
Un anno bisestile modifica gli estremi restituiti?
No. Aggiunge il 29 febbraio tra gli estremi.
Il primo e l'ultimo giorno sono inclusi nell'intervallo?
Sì. Sia il 1° gennaio sia il 31 dicembre fanno parte dell'intervallo, quindi può usarli direttamente in un filtro da-a che includa entrambi gli estremi, senza aggiungere o togliere un giorno.
Come uso queste date se lavoro con orari precisi?
Le tratti come giorni del calendario, non come istanti, e applichi la sua regola sul fuso orario. Se serve un intervallo che si chiude appena prima dell'anno successivo, usi come fine il 1° gennaio di quell'anno.
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/year-start-end \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-06-15"}'const res = await fetch("https://api.kit.forhosting.com/date/year-start-end", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-06-15"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/year-start-end",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-06-15"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/year-start-end", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-06-15"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-06-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/year-start-end", 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-06-15"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.year_start_end",
"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
Come vengono ricavati gli estremi dell’anno
Il calcolo imposta days_in_year a 365 o 366 e fornisce is_leap_year.
Convalida dell’input e campi della risposta
Una risposta valida ripete la data controllata e include year come intero. first_day e last_day sono date ISO inclusive, pronte per filtri con confronti maggiore o uguale e minore o uguale. is_leap_year e days_in_year aiutano a dimensionare programmi annuali o verificare la gestione bisestile. Un input errato produce invalid_input con una spiegazione breve, senza slittare tacitamente in un altro mese. Browser e API condividono la stessa funzione pura solve.
Uso sicuro degli estremi dell’anno civile
Tratti first_day e last_day come date civili, non come istanti. Una richiesta API riuscita costa $0.002 per elemento; il browser esegue localmente lo stesso calcolo puro. Senza rete, orologio, casualità o stato locale nascosto, lo stesso input restituisce sempre lo stesso JSON.
Casi di integrazione
Test di regressione del calendario
Generi estremi prevedibili e metadati bisestili per casi con anni comuni, bisestili ed eccezioni secolari.
Domande tecniche
Il primo e l’ultimo giorno sono inclusivi?
Sì. first_day è il 1° gennaio e last_day è il 31 dicembre dell’anno civile indicato; entrambi appartengono a quell’anno.
Quanto costa una richiesta API?
Una richiesta API riuscita costa $0.002 per elemento. La versione nel browser esegue gratuitamente lo stesso calcolo deterministico in locale.