ForHosting KIT · Date e tempo

Calcolatore numero settimana ISO

Inserisca una data e veda la sua settimana ISO: il 1° gennaio 2024 è la settimana 1 del 2024, mentre il 1° gennaio 2021 resta nella settimana 53 del 2020. Compare anche l'anno di settimana. Gratis nel suo browser.

Gratis
Funziona nel suo browser
Senza registrazione
I suoi dati restano sul dispositivo

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Esempio risolto

Se inserisce

Data: 2024-01-01

Ottiene

Anno: 2024
Mese: 1
Giorno: 1
Settimana ISO: 1

Questo calcolatore del numero di settimana ISO prende una singola data del calendario gregoriano in forma AAAA-MM-GG e restituisce il suo numero di settimana ISO-8601 insieme all'anno di numerazione a cui appartengono quei due valori. Le settimane ISO iniziano sempre di lunedì e finiscono di domenica, e la settimana 1 di un anno è quella che contiene il primo giovedì di quell'anno — per questo fine dicembre e inizio gennaio spesso riportano un anno di settimana diverso dall'anno civile sul calendario. I controlli classici includono 2024-01-01 che corrisponde alla settimana 1 del 2024, e 2021-01-01 che corrisponde alla settimana 53 del 2020. Il motore usa solo aritmetica di calendario a interi deterministica: anni bisestili, lunghezze dei mesi, giorno ordinale dell'anno e giorno della settimana ISO vengono calcolati senza chiamate di rete, campionamento casuale o l'orologio dell'host.

Cos'è un numero di settimana ISO e cosa contiene la risposta

Le date a settimane ISO-8601 rispondono a una domanda diversa dai calendari mese-e-giorno: localizzano un giorno dentro una settimana su base lunedì, numerata da 1 a 52 o 53 dentro un anno di numerazione delle settimane. La settimana 1 è definita come la settimana che contiene il primo giovedì dell'anno, il che equivale alla settimana che contiene il 4 gennaio.

A causa di questa regola, dal 29 dicembre al 3 gennaio possono appartenere all'anno di settimana precedente o successivo anche quando l'anno civile sulla fattura riporta ancora il numero vecchio o nuovo. Se vi servono epoche Unix, analisi multi-formato o aritmetica dei giorni lavorativi, usate quegli strumenti dedicati; questa pagina risponde solo al numero di settimana ISO e all'anno di settimana per una data di calendario validata.

Come viene letta la data e come la settimana 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 e i nomi dei mesi 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.

Dalla terna validata il motore calcola il giorno dell'anno sommando le lunghezze dei mesi, il giorno della settimana ISO tramite il metodo a interi puri di Sakamoto mappato così lunedì è uno e domenica è sette, poi il numero di settimana come la parte intera di giorno dell'anno meno giorno della settimana più dieci, tutto diviso per sette. Quando quella settimana è minore di uno, la data appartiene all'ultima settimana dell'anno di settimana precedente; quando supera il numero di settimane nell'anno civile, appartiene alla settimana uno dell'anno di settimana successivo.

Un anno ha cinquantatré settimane ISO quando il suo primo o ultimo giorno è un giovedì.

Dove si inseriscono i numeri di settimana ISO in pianificazione, reportistica e software

I team operativi e finanziari usano i numeri di settimana ISO quando una cadenza settimanale deve allinearsi tra paesi che non iniziano tutti la settimana di domenica: calendari di produzione, pacchetti di vendita al dettaglio, etichette di sprint agile e reportistica statutaria che cita la settimana dell'anno beneficiano tutti di un unico id di settimana inequivocabile.

Gli sviluppatori richiamano lo stesso contratto dagli script per timbrare bucket di log, per generare vettori di test deterministici per sistemi di buste paga e fogli ore, o per soddisfare requisiti di prodotto che richiedono etichette da W01 a W53 invece di una numerazione locale delle settimane ad hoc.

Educatori e redattori di standard usano lo strumento per dimostrare date di confine come 2005-01-01 nella settimana 53 del 2004 rispetto a 2005-01-03 nella settimana 1 del 2005 senza affidarsi a numeri seriali di foglio di calcolo che differiscono tra Excel e ISO. Abbinatelo alla conversione epoch o alla normalizzazione delle date quando vi servono passaggi di calendario correlati, e ad altri helper gratuiti e deterministici quando state assemblando un piccolo laboratorio di utility per le date.

Casi d'uso

Etichette di reportistica settimanale

Timbrate dashboard, pacchetti retail e report operativi con coppie stabili di settimana ISO e anno di settimana invece di settimane locali dipendenti dalla lingua.

Controlli di conformità sul confine d'anno

Verificate le date di fine dicembre e inizio gennaio che appartengono all'anno di settimana precedente o successivo prima di chiudere i bilanci o depositare statistiche basate sulla settimana.

Domande frequenti

Come è definito il numero di settimana ISO?

Le settimane vanno da lunedì a domenica. La settimana 1 è quella che contiene il primo giovedì dell'anno (la settimana che contiene il 4 gennaio). Il risultato può usare un anno di settimana diverso dall'anno civile.

Converte fusi orari o usa l'orologio attuale?

No. Mappa solo una data di calendario validata sui campi di settimana ISO con aritmetica pura. Non c'è oggetto Date, spostamento di fuso orario o dipendenza da "oggi".

Perché il 1° gennaio 2021 cade nella settimana 53 del 2020?

Perché la settimana 1 di un anno è quella che contiene il suo primo giovedì, e il 1° gennaio 2021 viene prima. Quel giorno resta quindi nell'ultima settimana del 2020, la numero 53.

Cosa mostra il risultato oltre al numero di settimana?

Mostra il giorno della settimana da 1 (lunedì) a 7 (domenica) con il nome, un'etichetta breve come 2024-W01, quante settimane ha quell'anno di settimana e la posizione del giorno nell'anno.

Quali date non vengono accettate?

Le date che non esistono, come il 29 febbraio 2023, i mesi impossibili e le scritture diverse da anno-mese-giorno con trattini, come 2024/01/01. L'anno deve essere compreso tra 1 e 9999.

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

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

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/iso-week-number \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-01-01"}'

const res = await fetch("https://api.kit.forhosting.com/date/iso-week-number", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-01-01"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/iso-week-number",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-01-01"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/iso-week-number", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2024-01-01"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2024-01-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/iso-week-number", 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-01-01"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.iso_week_number",
  "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

per richiesta$0.002

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

Limiti

`year_min`	1
`year_max`	9999

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

Usatelo gratis nel browser per pianificazione, buste paga e schede di conformità, oppure chiamate l'API a $0.002 per richiesta riuscita quando vi servono etichette di settimana riproducibili in CI, pipeline di reportistica o funzionalità di prodotto.

Cos'è un numero di settimana ISO e cosa contiene la risposta

Questo calcolatore accetta un campo obbligatorio, date, come stringa rigorosa AAAA-MM-GG, 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 civile, mese e giorno, il numero di settimana ISO come iso_week, l'anno di numerazione come iso_week_year, il giorno della settimana ISO da 1 per lunedì a 7 per domenica con un nome leggibile, una compatta iso_week_string come 2020-W53, quante settimane contiene quell'anno di settimana, l'ordinale del giorno dell'anno, e un breve promemoria della formula. Non c'è conversione di fuso orario, nessun primo giorno della settimana dipendente dalla lingua, e nessuna approssimazione in virgola mobile: o l'input è un vero giorno di calendario e i campi di settimana sono completamente determinati, oppure la richiesta fallisce con invalid_input. I casi rifiutati includono date mancanti, forma errata come 2024/01/01, mesi impossibili e giorni inesistenti come 2023-02-29.

Come viene letta la data e come la settimana resta riproducibile

Il campo preferito è date, ma sono accettati gli alias iso_date, d e value così fogli di calcolo, query string e form tipizzati possono riusare lo stesso contratto senza rinominare colonne. Abbinate l'esecuzione gratuita nel browser di questa pagina all'API a pagamento quando vi serve la stessa etichetta di settimana dentro una pipeline automatizzata.

Dove si inseriscono i numeri di settimana ISO in pianificazione, reportistica e software

Gli analisti che costruiscono dashboard anno su anno evitano il classico errore di uno per cui i primi giorni di gennaio appartengono ancora alla settimana 52 o 53 dell'anno di settimana precedente se memorizzano sia iso_week sia iso_week_year invece del solo anno civile. 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.

Casi di integrazione

Fixture di test deterministiche

Generate valori riproducibili di iso_week e iso_week_string per unit test, controlli di proprietà e asserzioni CI senza deriva di Date.

Domande tecniche

Quanto costa il calcolatore del numero di settimana ISO?

È gratuito nel browser su questa pagina. Tramite l'API una richiesta riuscita costa $0.002; gli input non validi non vengono addebitati.

Perché iso_week_year può differire dall'anno civile?

Le date dal 29 dicembre circa al 3 gennaio cadono spesso nell'ultima settimana dell'anno di settimana precedente o nella settimana 1 di quello successivo secondo le regole ISO-8601.

Quali formati di data sono accettati?

Solo date di calendario rigorose AAAA-MM-GG. Valori come 2024/01/01, 01-01-2024 o 2023-02-29 (non bisestile) vengono rifiutati con invalid_input.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser

Esempio risolto

Cos'è un numero di settimana ISO e cosa contiene la risposta

Come viene letta la data e come la settimana resta riproducibile

Dove si inseriscono i numeri di settimana ISO in pianificazione, reportistica e software

Casi d'uso

Etichette di reportistica settimanale

Controlli di conformità sul confine d'anno

Domande frequenti

Strumenti correlati

Per sviluppatori — accesso via API

Endpoint

Chiamala dal tuo stack

Esempio di richiesta

Esempio di risposta

Prezzi

Limiti

Errori

Note tecniche

Cos'è un numero di settimana ISO e cosa contiene la risposta

Come viene letta la data e come la settimana resta riproducibile

Dove si inseriscono i numeri di settimana ISO in pianificazione, reportistica e software

Casi di integrazione

Fixture di test deterministiche

Domande tecniche

grazie