N. settimana USA
Calcoli il numero di settimana USA di qualsiasi data, con settimane dalla domenica al sabato e la settimana 1 come quella che contiene il 1° gennaio: il 15 marzo 2024 cade nella settimana 11. Vede anche quante settimane ha l'anno. 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-03-15
- Anno
- 2024
- Mese
- 3
- Giorno
- 15
- Giorno dell'anno
- 75
Negli Stati Uniti molti calendari, sistemi di paghe, pianificatori scolastici e modelli di foglio di calcolo numerano le settimane in modo che ciascuna inizi di domenica e la settimana uno sia semplicemente quella che contiene il primo gennaio. Tale regola differisce dal sistema di data settimana ISO 8601, che avvia le settimane di lunedì e definisce la settimana uno come quella che include il primo giovedì dell'anno. Quando un programma, un report o una traccia di audit deve corrispondere ai numeri di settimana USA anziché ISO, un piccolo convertitore deterministico evita le stranezze del Date dell'host e la deriva di locale.
Regole settimana USA rispetto alle settimane ISO, e come inviare una data
Secondo la convenzione USA usata qui, una settimana inizia sempre di domenica e termina di sabato. La settimana uno di un anno è quella che include il primo gennaio, anche se tale settimana è iniziata a dicembre dell'anno precedente sul calendario a muro. Le settimane successive si contano come blocchi completi da domenica a sabato fino al trentuno dicembre, che può cadere nella settimana cinquantadue o cinquantatre a seconda di dove è caduto il primo gennaio e se l'anno è bisestile.
Le settimane ISO 8601 sono diverse: iniziano di lunedì, e la settimana uno è quella del primo giovedì dell'anno, così lo stesso giorno civile può mappare a un indice di settimana diverso.
Come si calcola il numero e che aspetto hanno le date non valide
Il motore prima valida il giorno del calendario gregoriano, applicando le regole dell'anno bisestile così che febbraio abbia ventinove giorni solo quando l'anno è divisibile per quattro, salvo che gli anni di secolo debbano anche essere divisibili per quattrocento. Poi calcola il giorno dell'anno dalle lunghezze cumulative dei mesi e il giorno della settimana della data con aritmetica intera, senza usare un oggetto Date dell'host.
Il numero di settimana USA è il pavimento di giorno-dell'anno meno uno più il giorno della settimana del primo gennaio, il tutto diviso per sette, più uno, dove domenica è il giorno della settimana zero. Quella formula colloca il primo gennaio nella settimana uno e avanza di uno a ogni domenica successiva. Stringhe malformate che non siano anno a quattro cifre, mese a due cifre e giorno a due cifre separati da trattini sono ugualmente respinte.
Casi d'uso
Paghe e report di settimana lavorativa USA
Le pipeline HR e paghe che raggruppano le ore per settimane che iniziano di domenica etichettano ogni periodo di paga con il numero di settimana USA che contiene la data di lavoro, allineato alle comuni aspettative di WEEKNUM nei fogli di calcolo.
Calendari scolastici e di pianificazione retail
I calendari distrettuali e i piani di merchandising spesso numerano le settimane con il 1º gennaio nella settimana 1; converta le date ISO a tale indice per slide, digest e-mail e finestre di inventario.
Domande frequenti
È lo stesso del numero di settimana ISO?
No. Le settimane ISO iniziano di lunedì e definiscono la settimana 1 con la regola del primo giovedì. La stessa data civile può dare un indice diverso sotto le regole ISO.
Cosa succede se la data non è valida?
Esempi: formato YYYY-MM-DD errato, 30 febbraio, o 29 febbraio in un anno non bisestile. La validazione fallita non è addebitata.
Il calcolatore del numero di settimana USA è gratuito?
Lo strumento del browser gira gratis sul Suo dispositivo.
Un anno può avere 53 settimane?
Sì. Il 31 dicembre cade nella settimana cinquantadue o nella 53, a seconda del giorno della settimana del 1° gennaio e dell'anno bisestile. Nel 2024, per esempio, l'ultima settimana è la 53.
La settimana 1 può iniziare a dicembre?
Sì. La settimana 1 è quella dalla domenica al sabato che contiene il 1° gennaio, quindi se quel giorno cade a metà settimana, è iniziata negli ultimi giorni di dicembre dell'anno prima.
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/us-week-number \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-15","calendar":"valor-ejemplo"}'const res = await fetch("https://api.kit.forhosting.com/date/us-week-number", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-15",
"calendar": "valor-ejemplo"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/us-week-number",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-15",
"calendar": "valor-ejemplo"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/us-week-number", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-15","calendar":"valor-ejemplo"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-15","calendar":"valor-ejemplo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/us-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-03-15",
"calendar": "valor-ejemplo"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.us_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
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
Questo calcolatore del numero di settimana USA accetta una data di calendario ISO, applica l'aritmetica bisestile gregoriana e una formula pura del giorno della settimana, e restituisce l'indice di settimana insieme ai fatti di giorno della settimana e di anno in JSON stabile.
Regole settimana USA rispetto alle settimane ISO, e come inviare una data
Invii una stringa data in forma YYYY-MM-DD, oppure i campi strutturati year, month e day insieme. Alias come calendar, calendar_date e iso_date sono accettati per il percorso stringa. L'ingresso strutturato parziale senza tutte e tre le parti è respinto con invalid_input affinché chi chiama corregga il corpo invece di indovinare i valori mancanti. Ingressi identici producono sempre JSON identico perché il percorso non legge mai l'orologio a muro, la locale o la rete.
Come si calcola il numero e che aspetto hanno le date non valide
Date impossibili come il trentuno aprile, il trenta febbraio o il ventinove febbraio in un anno non bisestile falliscono con invalid_input e un messaggio che indica la lunghezza reale del mese. La risposta ripete week_starts uguale a Sunday, week_1_rule uguale a contains_january_1, e weeks_in_year uguale alla settimana USA del trentuno dicembre così che le dashboard mostrino l'intervallo annuale senza una seconda chiamata.
Uso dell'API, prezzi, flussi di lavoro e limiti pratici
Chiami il calcolatore gratuito del numero di settimana USA nel browser per controlli di compiti, demo di pianificazione e verifica rapida senza installare librerie di calendario. I limiti di anno seguono l'intervallo di parametri pubblicato per la sicurezza di isolamento. Invii un corpo JSON con date come YYYY-MM-DD, oppure con year, month e day come interi negli intervalli pubblicati. In caso di successo il payload include la data normalizzata, i componenti strutturati, day_of_year, day_of_week da zero per domenica a sei per sabato con un nome in inglese, week_number, weeks_in_year, is_leap_year, calendar uguale a gregorian, e method uguale a us_week_number per router e test che si ramificano sulle etichette. Usi l'API prepagata quando un export paghe, un calendario scolastico, uno strumento di pianificazione retail o un SDK necessita di un contratto stabile sotto saldo KIT a $0.002 per elemento riuscito; i fallimenti di validazione non consumano mai il saldo dopo il rifiuto del motore. Abbini questo endpoint a strumenti di ordinale ISO o di giorni nel mese quando serve indici di giorno o la lunghezza di febbraio, ma non si aspetti che l'indice di settimana coincida con le etichette di settimana-data ISO.
Casi di integrazione
Parità di foglio di calcolo nelle API
I servizi che devono corrispondere ai numeri di settimana basati sulla domenica di Excel o Google Sheets espongono un campo JSON stabile invece di reimplementare la matematica del giorno della settimana in ogni linguaggio client.
Domande tecniche
Come ottengo il numero di settimana USA per una data?
Invii JSON con date impostato a una stringa ISO come 2024-03-15, oppure year, month e day. La risposta include week_number e day_of_week_name.
Le settimane iniziano di domenica o di lunedì?
Di domenica. Questo calcolatore usa la convenzione USA: week_starts è sempre Sunday, e la settimana 1 è quella che contiene il 1º gennaio.