ForHosting KIT · Date e tempo

Numero settimana ISO 8601

Inserisca una data e ottenga il numero di settimana ISO 8601 e l'anno-settimana: il 25 luglio 2026 cade nella settimana 30, scritta 2026-W30. Le settimane vanno dal lunedì alla domenica e la settimana 1 contiene il primo giovedì dell'anno. 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: 2026-07-25

Ottiene

Settimana: 30
Anno della settimana: 2026
Settimana ISO: 2026-W30
Giorno della settimana: 6

A differenza delle settimane in stile statunitense, che spesso iniziano di domenica e non sconfinano in un altro anno, una settimana ISO inizia sempre di lunedì e la settimana 1 è quella che contiene il primo giovedì dell’anno gregoriano. Questa regola implica che fine dicembre e inizio gennaio possano appartenere a un anno-settimana ISO diverso dall’anno civile stampato sulla data. Questa capacità riceve una stringa di data ISO, la interpreta come giorno civile UTC e restituisce il numero di settimana (1–53), l’anno-settimana ISO, un’etichetta compatta YYYY-Www e il giorno della settimana — in modo deterministico, senza indovinare il fuso orario.

Cosa significa davvero un numero di settimana ISO

Spesso si dice «numero di settimana» per tre cose diverse: la settimana ordinale dell’anno civile a partire dal 1º gennaio, la settimana del mese (prima-quinta all’interno di un mese), o la settimana ISO 8601 definita dallo standard internazionale. Solo l’ultima è stabile nei paesi che seguono i calendari ISO. Secondo ISO 8601, ogni settimana ha sette giorni da lunedì a domenica.

La settimana 1 dell’anno Y è quella che include il primo giovedì di Y — equivalente alla settimana che contiene il 4 gennaio. Un anno può quindi avere 52 o 53 settimane ISO. Quando ce ne sono 53, il 29, 30 o 31 dicembre può restare nella settimana 53 di quell’anno ISO, e l’1–3 gennaio dell’anno civile successivo può ancora appartenere alla settimana 52 o 53 dell’anno-settimana ISO precedente.

Confondere l’anno civile con l’anno-settimana è il bug più comune in helper di data artigianali, dashboard e report SQL.

Contratto di input e valutazione solo in UTC

Invii un campo obbligatorio, date, come stringa ISO-8601. La forma preferita è YYYY-MM-DD (ad esempio 2026-07-25). È accettato un datetime completo con ora e suffisso di zona opzionale, ma si usa solo il giorno di calendario dopo il parsing della stringa; il calcolo gira sempre su quel giorno civile a mezzanotte UTC.

Valori mancanti o non stringa falliscono pure la validazione e non vengono addebitati.

Dove le pipeline usano il numero di settimana e come chiamare

KPI settimanali, bacheche di sprint, report fiscali che seguono le settimane ISO, slot logistici etichettati per settimana e job di arricchimento CSV necessitano di un indice di settimana affidabile. Solo questi tre catturano errori di uno su lunedì/domenica, sbagli di anno-settimana al confine d’anno e il padding delle settimane a una cifra. Mantenga il contratto UTC: se le servono mezze notti locali in un’altra zona, converta prima alla data civile locale e passi quel YYYY-MM-DD qui così il calcolo della settimana resta puro e riproducibile.

Casi d'uso

Analitica settimanale e rollup di KPI

Raggruppi gli eventi per settimana ISO e anno-settimana così il traffico di dicembre e gennaio finisca nella settimana di reporting corretta, non nell’anno civile sbagliato.

Calendari di paghe e produzione

Etichetti fogli presenze, turni e lotti di produzione con numeri di settimana ISO allineati a sistemi europei e di pianificazione ISO.

Domande frequenti

Cos’è il numero di settimana ISO 8601?

È l’indice di settimana da 1 a 53 definito da ISO 8601: le settimane iniziano di lunedì e la settimana 1 è quella che contiene il primo giovedì dell’anno (o, in modo equivalente, il 4 gennaio).

Il calcolo è in ora locale o in UTC?

Solo UTC. La data è trattata come giorno civile UTC (YYYY-MM-DD). I suffissi orari opzionali sono ignorati per la matematica della settimana così i risultati restano deterministici tra fusi orari.

Perché i primi giorni di gennaio possono appartenere alla settimana dell'anno prima?

Perché la settimana ISO appartiene a un anno-settimana che può differire dall'anno di calendario. Dal 1° al 3 gennaio i giorni possono ancora cadere nella settimana 52 o 53 dell'anno ISO precedente.

Quante settimane ISO ha un anno?

Ne ha 52 o 53. La settimana 1 è quella che contiene il 4 gennaio, quindi negli anni da 53 settimane il 29, 30 o 31 dicembre possono trovarsi ancora nella settimana 53.

Posso inserire una data con l'ora?

Sì. Una data con ora, anche con fuso orario, viene accettata, ma si usa solo il giorno di calendario. La settimana viene sempre calcolata su quel giorno a mezzanotte UTC.

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

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

import os, requests

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

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

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

Esempio di risposta

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

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

La numerazione delle settimane ISO 8601 è lo standard usato nei report europei, nei calendari di paghe, nella pianificazione industriale e in molte API.

Cosa significa davvero un numero di settimana ISO

Questo endpoint isola quella regola così i chiamanti ottengono un’unica risposta verificata invece di risultati divergenti da librerie dipendenti dalla locale.

Contratto di input e valutazione solo in UTC

Date impossibili come 2026-02-30 vengono rifiutate con invalid_input invece di essere fatte avanzare dall’implementazione host di Date. La risposta include la data normalizzata, week (1–53), week_year (l’anno-settimana ISO, che può differire dall’anno gregoriano vicino ai confini), iso_week in forma compatta 2026-W30, più weekday (lunedì=1 … domenica=7) e weekday_name per la leggibilità.

Dove le pipeline usano il numero di settimana e come chiamare

Usi lo strumento gratuito del browser per controlli occasionali, o l’API prepagata quando normalizza migliaia di righe: ogni elemento riuscito è tariffato alla base pubblicata di $0.002, e l’input non valido è gratuito. Abbini questa capacità alla normalizzazione delle date quando i dati sorgente sono disordinati, poi mappi ogni giorno ISO pulito su week e week_year prima di raggruppare.

Casi di integrazione

Arricchimento CSV e data warehouse

Aggiunga le colonne week e iso_week alle esportazioni così gli strumenti BI raggruppano le righe senza reimplementare le regole ISO nei dialetti SQL.

Domande tecniche

Perché week_year può differire dall’anno civile?

Vicino al Capodanno, giorni di fine dicembre o inizio gennaio possono appartenere all’anno-settimana ISO precedente o successivo. Il giovedì di quella settimana decide l’anno-settimana, non l’anno gregoriano del giorno stesso.

Quali formati di data sono accettati?

Si preferisce YYYY-MM-DD. I datetime ISO completi sono accettati se iniziano con una data di calendario valida; date impossibili e valori mancanti restituiscono invalid_input.

Quanto costa l’API del numero di settimana ISO?

Lo strumento del browser è gratuito. Le chiamate API riuscite usano il saldo prepagato al prezzo base pubblicato di $0.002 per elemento; l’input non valido non viene addebitato.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser

Esempio risolto

Cosa significa davvero un numero di settimana ISO

Contratto di input e valutazione solo in UTC

Dove le pipeline usano il numero di settimana e come chiamare

Casi d'uso

Analitica settimanale e rollup di KPI

Calendari di paghe e produzione

Domande frequenti

Strumenti correlati

Per sviluppatori — accesso via API

Endpoint

Chiamala dal tuo stack

Esempio di richiesta

Esempio di risposta

Prezzi

Errori

Note tecniche

Cosa significa davvero un numero di settimana ISO

Contratto di input e valutazione solo in UTC

Dove le pipeline usano il numero di settimana e come chiamare

Casi di integrazione

Arricchimento CSV e data warehouse

Domande tecniche

grazie