ForHosting KIT · Date e tempo

N. settimana con primo giorno a scelta

Scelga il giorno in cui iniziano le sue settimane e ottenga il numero di settimana di qualsiasi data, con la settimana 1 sempre quella del 1° gennaio: il 15 marzo 2024 cade nella settimana 11 se la settimana inizia di lunedì. 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-03-15
Primo giorno della settimana
monday
Ottiene
Anno
2024
Mese
3
Giorno
15
Giorno dell'anno
75

Questo calcolatore del numero di settimana riceve una data del calendario gregoriano in formato YYYY-MM-DD e il primo giorno della settimana che Lei sceglie, poi restituisce il numero di settimana dell’anno secondo una regola semplice ed esplicita: le settimane iniziano sempre nel giorno che Lei indica, e la settimana 1 è quella che contiene il 1º gennaio dell’anno civile. Tale convenzione rispecchia la prassi comune di fogli di calcolo e operazioni quando serve domenica, lunedì, sabato o un altro inizio senza adottare i confini di anno-settimana ISO-8601. Il motore usa solo aritmetica intera deterministica del calendario—anni bisestili, lunghezze dei mesi, giorno dell’anno e giorni della settimana di Sakamoto—senza chiamate di rete, casualità né orologio dell’host.

Che cos’è un numero di settimana a inizio personalizzato e cosa contiene la risposta

Un numero di settimana dell’anno risponde a «in quale settimana di quest’anno civile cade questa data?» una volta fissato come iniziano le settimane. A differenza della data di settimana ISO-8601, che inizia sempre di lunedì e può assegnare fine dicembre o inizio gennaio a un altro anno-settimana, questo calcolatore tiene fisso l’anno civile e cambia solo il giorno di inizio.

Casi rifiutati includono data mancante, forme come 2024/03/15, mesi impossibili, 29 febbraio non bisestile e token di giorno sconosciuti. Se Le servono coppie settimana e anno-settimana ISO, usi lo strumento dedicato del numero di settimana ISO; se Le servono solo settimane USA con inizio domenica, lo strumento settimana USA è una specializzazione fissa della stessa famiglia. Questa pagina è per team che scelgono di proposito il primo giorno della settimana e vogliono comunque un indice stabile nell’anno civile.

Dove i numeri di settimana a inizio personalizzato entrano in pianificazione e software

I team di operations e prodotto spesso servono un ritmo settimanale allineato alla cultura locale: molte bacheche europee iniziano di lunedì, il retail USA e alcuni calendari scolastici di domenica, e certi settori trattano il sabato come primo giorno dei turni. Un solo calcolatore che cambia solo il giorno di inizio tenendo la settimana 1 ancorata a quella del 1º gennaio consente di servire quei pubblici con lo stesso codice senza sette helper diversi.

Gli sviluppatori timbrano bucket di log, etichette di sprint e periodi di timesheet con un indice deterministico allineato alle aspettative stile WEEKNUM dei fogli di calcolo quando il tipo di ritorno si generalizza oltre la domenica. Educatori e redattori di standard possono mostrare affiancati che i numeri di settimana con inizio lunedì sotto la regola del 1º gennaio non sono quelli ISO vicino ai confini d’anno, evitando costosi errori di uno nei fogli di conformità.

Lo abbini agli strumenti di inizio e fine settimana quando Le servono i limiti di lunedì o domenica della stessa settimana, al numero di settimana ISO quando il reporting normativo richiede ISO-8601, e agli aiuti sul giorno della settimana quando serve solo il nome del giorno senza un indice di settimana.

Dashboard settimanali consapevoli della regione

Timbrare report con etichette di settimana dell’anno allineate al primo giorno regionale (lunedì, domenica o sabato) senza passare alle regole di anno-settimana ISO.

Indici di settimana compatibili con i fogli di calcolo

Rispecchiare il comportamento stile WEEKNUM di Excel generalizzato a qualsiasi giorno di inizio per import, timesheet e pacchetti finanziari che restano nell’anno civile.

Quanto costa il calcolatore del numero di settimana con primo giorno personalizzato?

È gratuito nel Suo browser in questa pagina.

Come è definita la settimana 1?

La settimana 1 è quella che contiene il 1º gennaio dell’anno civile. Le settimane durano sempre sette giorni a partire dal giorno della settimana che Lei sceglie. Non è la regola ISO del primo giovedì.

In che modo differisce dal calcolatore del numero di settimana ISO?

Le settimane ISO iniziano sempre di lunedì e possono assegnare un altro anno-settimana vicino al 1º gennaio. Questo strumento mantiene l’anno civile e cambia solo il primo giorno; la settimana 1 include sempre il 1º gennaio.

Usa fusi orari o l’orologio corrente?

No. Mappa solo una data di calendario convalidata e un primo giorno su campi di settimana con aritmetica pura. Non c’è oggetto Date, spostamento di fuso né dipendenza da oggi.

Quale giorno di inizio si usa se non ne scelgo nessuno?

Il lunedì. Può passare a qualsiasi giorno dalla domenica al sabato, e la settimana 1 resta quella che contiene il 1° gennaio, qualunque sia il giorno di inizio scelto.

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/week-number-custom-start

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/week-number-custom-start \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-03-15"}'
{
  "date": "2024-03-15"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.week_number_custom_start",
  "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 bacheche di pianificazione e calendari per regione, oppure chiami l’API a $0.002 per richiesta andata a buon fine quando le pipeline devono ottenere sempre la stessa etichetta di settimana.

Che cos’è un numero di settimana a inizio personalizzato e cosa contiene la risposta

Lei passa date come stringa stretta YYYY-MM-DD e first_weekday opzionale come nome inglese (sunday fino a saturday) oppure un intero da zero per domenica a sei per sabato; se first_weekday è omesso si assume lunedì. Dopo la convalida la risposta ripete la data normalizzata, anno civile, mese e giorno, l’ordinale day_of_year, il giorno della settimana dell’ingresso in minuscolo e in Title Case più un indice basato su zero, first_weekday e first_weekday_index risolti, quanti giorni la data dista dall’inizio della sua settimana, week_number da uno in su, weeks_in_year come numero di settimana del 31 dicembre con lo stesso giorno di inizio, week_1_rule uguale a contains_january_1, flag di anno bisestile e calendario, un tag method e una breve stringa di formula per la documentazione. Non c’è conversione di fuso orario né dipendenza da «oggi»: o gli input formano un giorno di calendario reale e un primo giorno valido, o la richiesta fallisce con invalid_input.

Come si leggono data e primo giorno affinché il risultato resti riproducibile

La stringa deve corrispondere a quattro cifre, un trattino, due cifre, un altro trattino e due cifre; spazi iniziali e finali vengono tagliati, ma date parziali, nomi di mese e il solo ordinale del giorno dell’anno non vengono espansi qui. L’anno deve stare 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 anni bisestili secondo la regola gregoriana (divisibile per quattro salvo secoli non divisibili per quattrocento). Il campo data preferito è date, ma sono accettati gli alias iso_date, d, value e calendar così che fogli di calcolo, query string e moduli riutilizzino il contratto senza rinominare colonne. Il campo first_weekday accetta nomi o indici numerici e ha alias week_start, start_day e first_day; valori vuoti o omessi predefinitano a lunedì così un inizio in stile ISO resta a un passo senza imporre la regola di anno-settimana ISO. Dal triplo convalidato il motore calcola day_of_year sommando le lunghezze dei mesi con aggiustamento di febbraio bisestile, poi i giorni della settimana della data di ingresso e del 1º gennaio con il metodo intero di Sakamoto (domenica zero, sabato sei). Lo scostamento del 1º gennaio nella settimana personalizzata è (giorno del 1º gennaio meno first_weekday più sette) modulo sette; il numero di settimana è il pavimento di day_of_year meno uno più quello scostamento, tutto diviso per sette, poi più uno. Il numero di settimana del 31 dicembre con lo stesso inizio torna come weeks_in_year così le dashboard sanno se l’anno arriva a 52, 53 o 54 etichette per quella configurazione. Abbini l’esecuzione gratuita del browser in questa pagina all’API a pagamento quando Le serve la stessa etichetta di settimana in una pipeline automatizzata.

Dove i numeri di settimana a inizio personalizzato entrano in pianificazione e software

Gli analisti che costruiscono dashboard anno su anno possono memorizzare week_number insieme a first_weekday_index così i filtri restano non ambigui quando due regioni non concordano sull’inizio settimana. In questa pagina il lavoro gira interamente nel Suo browser; tramite l’API ogni ricerca andata a buon fine costa $0.002, la convalida fallita non viene addebitata e nulla viene memorizzato dopo la risposta. Tale divisione—esplorazione interattiva gratuita e API identica a pagamento—corrisponde al resto del catalogo KIT di livello A e Le consente di passare da un controllo occasionale a una pipeline senza cambiare il risultato matematico.

Fixture di CI deterministiche

Generare valori week_number riproducibili per test unitari sotto diversi first_weekday senza distorsione di Date né della locale dell’host.

Quali valori può assumere first_weekday?

Nomi inglesi sunday fino a saturday (senza distinzione di maiuscole), oppure interi 0–6 con domenica = 0 e sabato = 6. Il valore predefinito è monday se il campo è omesso.

Leggi la documentazione completa del KIT →