ForHosting KIT · Date e tempo

Inizio e fine settimana ISO

Inserisca un giorno e ottenga il lunedì che apre la sua settimana ISO e la domenica che la chiude: il 3 gennaio 2024 cade nella settimana dal 1° al 7 gennaio 2024. Contano entrambe le date. Gratis nel suo browser.

  • Gratis
  • Funziona nel suo browser
  • Senza registrazione
  • I suoi dati restano sul dispositivo
Usalo da WebAPIEmailTelegramApp presto
Se inserisce
Data
2024-01-03
Ottiene
Anno
2024
Mese
1
Giorno
3
Giorno della settimana ISO
3

Questo calcolatore di inizio e fine settimana ISO accetta una singola data del calendario gregoriano in formato YYYY-MM-DD e restituisce il lunedì che apre la settimana ISO-8601 contenente quel giorno e la domenica che la chiude. Le settimane ISO vanno sempre dal lunedì alla domenica e non dipendono mai dal primo giorno della settimana della località, ecco perché buste paga, pacchetti di produzione, etichette di sprint agile e report transfrontalieri le preferiscono alle settimane in stile USA che iniziano la domenica. Controlli classici includono 2024-01-03, che corrisponde alla settimana dal 2024-01-01 al 2024-01-07, e 2021-01-01, che corrisponde alla settimana dal 2020-12-28 al 2021-01-03 perché quel venerdì appartiene ancora alla settimana 53 dell'anno-settimana 2020. Il motore usa solo aritmetica di calendario intera e deterministica: anni bisestili, lunghezze dei mesi, giorno della settimana ISO, offset del numero del giorno giuliano e regole di confine del numero di settimana sono calcolati senza chiamate di rete, senza campionamento casuale e senza l'orologio dell'host.

Cosa significano inizio e fine di una settimana ISO e cosa contiene la risposta

Le date di settimana ISO-8601 collocano un giorno civile all'interno di una finestra di sette giorni basata sul lunedì, numerata da 1 a 52 o 53 all'interno di un anno di numerazione delle settimane. La settimana 1 è definita come la settimana che contiene il primo giovedì dell'anno, equivalente alla settimana che contiene il 4 gennaio.

Per quella regola, fine dicembre e inizio gennaio possono appartenere a un anno-settimana diverso dall'anno civile stampato sulla fattura, e il lunedì di inizio o la domenica di fine possono cadere in un mese o anno di calendario diversi dal giorno di input. Se Le serve un primo giorno della settimana personalizzato, solo il numero di settimana, o la conversione da anno-settimana più settimana in una data, usi quegli strumenti dedicati; questa pagina risponde solo ai limiti della finestra di settimana ISO per una data di calendario validata.

Come viene letta la data e come la finestra lunedì–domenica 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 date parziali, il solo giorno dell'anno ordinale e i nomi dei mesi non vengono espansi qui.

Dopo il parsing, l'anno deve essere 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 di divisibile per quattro tranne i secoli non divisibili per quattrocento.

Lo stesso percorso deriva anche il numero di settimana ISO come il pavimento di giorno dell'anno meno giorno della settimana più dieci, il tutto diviso per sette, con aggiustamento dell'anno-settimana quando la settimana provvisoria è minore di uno o supera il numero di settimane dell'anno civile. Un anno ha cinquantatré settimane ISO quando il primo o l'ultimo giorno è un giovedì.

Intervalli di date per report settimanali

Trasformi qualsiasi giorno di fattura o di log in limiti inclusivi lunedì–domenica ISO per dashboard, pack retail e report operativi.

Finestre di settimana al confine d'anno

Risolva date di fine dicembre e inizio gennaio la cui settimana ISO inizia o termina in un anno civile diverso prima di chiudere i libri.

Quanto costa il calcolatore di inizio e fine settimana ISO?

È gratuito nel Suo browser in questa pagina.

Perché il lunedì o la domenica possono cadere in un altro mese o anno?

Le settimane ISO sono blocchi continui di sette giorni. Un mercoledì di inizio gennaio può ancora appartenere a una settimana iniziata a fine dicembre dell'anno civile precedente.

Converte i fusi orari o usa l'orologio corrente?

No. Mappa solo una data di calendario validata a limiti lunedì–domenica di settimana ISO con aritmetica pura. Non c'è oggetto Date, scostamento di fuso né dipendenza da «oggi».

Il lunedì e la domenica sono compresi nell'intervallo?

Sì. Entrambi gli estremi sono inclusi, quindi l'intervallo copre sempre sette giorni: per il 3 gennaio 2024 va da lunedì 1 a domenica 7 gennaio, pronto per un riepilogo settimanale.

Posso far iniziare la settimana di domenica?

No. La settimana ISO va sempre dal lunedì alla domenica e l'inizio non si può cambiare, così i resoconti di Paesi diversi restano allineati. Per settimane che iniziano di domenica, usi uno strumento pensato per quella convenzione.

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.

POSThttps://api.kit.forhosting.com/date/iso-week-start-end

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/date/iso-week-start-end \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-01-03"}'
{
  "date": "2024-01-03"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.iso_week_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.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Lo usi gratis nel browser per fogli di pianificazione e controlli di conformità, oppure chiami l'API a $0.002 per richiesta andata a buon fine quando Le servono limiti di finestra settimanale riproducibili in CI, pipeline di report o funzioni di prodotto.

Cosa significano inizio e fine di una settimana ISO e cosa contiene la risposta

Questo calcolatore accetta un campo obbligatorio, date, come stringa stretta YYYY-MM-DD, verifica che il giorno esista davvero nel calendario gregoriano — incluso il 29 febbraio solo negli anni bisestili e la lunghezza corretta di ogni mese — quindi restituisce la data normalizzata, anno, mese e giorno civili, il giorno della settimana ISO da 1 per lunedì a 7 per domenica con un nome leggibile, quanti giorni dopo il lunedì si trova l'input, week_start e week_end come date ISO inclusive, il numero di settimana ISO e l'anno-settimana con una stringa compatta iso_week_string come 2020-W53, quante settimane contiene quell'anno-settimana, l'ordinale del giorno dell'anno, gli ancoraggi del numero del giorno giuliano per l'input e le estremità della settimana, length_days uguale a sette, e un breve promemoria della formula. Non c'è conversione di fuso orario, né primo giorno della settimana configurabile, né approssimazione in virgola mobile: o l'input è un giorno di calendario reale e la coppia lunedì–domenica è interamente determinata, oppure la richiesta fallisce con invalid_input. I casi rifiutati includono date assente, forma errata come 2024/01/03, mesi impossibili e giorni inesistenti come 2023-02-29.

Come viene letta la data e come la finestra lunedì–domenica resta riproducibile

Il campo preferito è date, ma sono accettati gli alias iso_date, d e value così che fogli di calcolo, query string e moduli tipizzati possano riusare lo stesso contratto senza rinominare le colonne. Dalla tripla validata il motore calcola il giorno della settimana ISO con il metodo intero puro di Sakamoto mappato così che lunedì sia uno e domenica sette, converte il giorno civile in un numero del giorno giuliano astronomico con l'algoritmo di Fliegel–Van Flandern, sottrae days_from_monday uguale a iso_weekday meno uno per atterrare sul lunedì, e aggiunge sei giorni per atterrare sulla domenica. Abbini l'esecuzione gratuita nel browser di questa pagina all'API a pagamento quando Le serve la stessa finestra settimanale in una pipeline automatizzata.

Dove l'inizio e la fine della settimana ISO rientrano in pianificazione, report e software

I team di operations e finanza hanno bisogno del lunedì e della domenica di una settimana ISO quando una cadenza settimanale deve allineare paesi che non iniziano tutti la settimana di domenica: pianificazioni di produzione, pack retail, etichette di sprint agile e report statutari che citano la settimana dell'anno traggono vantaggio da una finestra inclusiva senza ambiguità. Gli sviluppatori chiamano lo stesso contratto da script per etichettare bucket di log, generare intervalli predefiniti di timesheet o produrre vettori di test deterministici per sistemi di busta paga che chiudono la domenica sera. Formatori e redattori di standard usano lo strumento per dimostrare date di confine come 2005-01-01 in una settimana iniziata a dicembre 2004, senza affidarsi a numeri seriali di foglio di calcolo che differiscono tra Excel e ISO. Gli analisti che costruiscono dashboard anno su anno evitano filtri con errore di uno quando memorizzano sia week_start sia week_end invece di solo un numero di settimana che va ancora espanso in predicati di data. In questa pagina il lavoro gira interamente nel Suo browser; tramite l'API ogni consultazione riuscita costa $0.002, la validazione fallita non viene addebitata e nulla viene memorizzato dopo la risposta. Questa suddivisione — esplorazione interattiva gratuita e API a pagamento identica — combacia con il resto del catalogo tier A del KIT e Le consente di passare da un controllo una tantum a una pipeline senza cambiare il risultato matematico. Lo abbini alla ricerca del numero di settimana ISO quando Le serve solo l'id della settimana, a week_start_end configurabile quando contano i primi giorni della settimana della località, e ad altri helper deterministici gratuiti mentre assembla un piccolo laboratorio di utilità di data.

Fixture di test deterministiche

Generi valori riproducibili di week_start e week_end per test unitari, controlli di proprietà e asserzioni di CI senza distorsione di Date.

Quali giorni sono week_start e week_end?

Secondo ISO-8601, week_start è sempre lunedì e week_end è sempre domenica. Non c'è opzione per iniziare la settimana di domenica o in un altro giorno.

Quali formati di data sono accettati?

Solo date di calendario strette YYYY-MM-DD. Valori come 2024/01/03, 01-03-2024 o 2023-02-29 (non bisestile) vengono rifiutati con invalid_input.

Leggi la documentazione completa del KIT →