ForHosting KIT · Date e tempo

Da settimana ISO a data

Trasformi un'etichetta di settimana ISO in un giorno reale: il lunedì della settimana 1 del 2024 è il 1° gennaio 2024, e quello della settimana 1 del 2015 torna al 29 dicembre 2014. 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

Anno: 2024
Settimana: 1
Giorno della settimana: 1

Ottiene

Nome del giorno della settimana: Monday
Data: 2024-01-01
Anno di calendario: 2024
Mese: 1

Questo convertitore da settimana ISO a data mappa un anno di numerazione delle settimane ISO-8601, un numero di settimana da uno a cinquantadue o cinquantatré, e un giorno della settimana ISO da lunedì uguale uno a domenica uguale sette nel giorno di calendario gregoriano corrispondente come AAAA-MM-GG. La datazione a settimane ISO è lo standard usato in logistica, calendari di buste paga, programmi di produzione e molti sistemi aziendali europei: la settimana uno contiene sempre il quattro gennaio, le settimane iniziano sempre di lunedì, e alcuni anni hanno una cinquantatreesima settimana. Potreste già sapere che il lunedì della settimana uno del 2024 è 2024-01-01, che il lunedì della settimana uno del 2015 ricade indietro nel dicembre 2014, e che una richiesta per la settimana cinquantatré di un anno di cinquantadue settimane deve fallire. Il motore usa solo aritmetica gregoriana a interi pura, senza chiamate di rete, campionamento o oggetto Date, così gli stessi input producono sempre la stessa data.

Cosa restituisce la conversione da settimana ISO a data e quando fallisce

La datazione ISO-8601 a settimane identifica un giorno con tre numeri: l'anno di numerazione delle settimane Y, il numero di settimana W da uno fino all'ultima settimana di quell'anno, e il giorno della settimana D dove lunedì è uno e domenica è sette. La settimana uno dell'anno Y è definita come la settimana che contiene il quattro gennaio di Y, che è anche la settimana che contiene il primo giovedì di Y; da questo ancoraggio il motore avanza o retrocede di settimane e giorni interi.

Vicino ai confini d'anno l'anno gregoriano del risultato può differire dall'anno di settimana ISO: per esempio il lunedì di 2015-W01 è 2014-12-29, e il venerdì di 2020-W53 è 2021-01-01. Vengono rifiutati anche i valori mancanti o non interi di anno, settimana o giorno della settimana, i giorni della settimana fuori dall'intervallo uno-sette, e gli anni fuori dall'intervallo supportato uno-novemilanovecentonovantanove.

Come vengono letti anno, settimana e giorno della settimana e come la data resta riproducibile

Le stringhe intere e i bigint sicuri sono accettati quando si interpretano come numeri interi dentro gli intervalli documentati; decimali, stringhe vuote e token non numerici vengono rifiutati così una cella sbagliata non diventa un giorno di spedizione sbagliato. Il calcolo parte dal quattro gennaio dell'anno di settimana, trova il suo giorno della settimana ISO con aritmetica a interi puri in stile Sakamoto, retrocede al lunedì della settimana uno, quindi aggiunge sette per settimana meno uno più giorno della settimana meno uno giorni.

Gli ordinali che cadono prima del primo gennaio o dopo il trentuno dicembre vengono normalizzati attraverso i confini d'anno gregoriani con piena gestione degli anni bisestili, inclusa la regola dei quattrocento anni.

Dove si inserisce la conversione da settimana a data in pianificazione, logistica e software

I team operativi incontrano le etichette di settimana ISO su ordini d'acquisto, finestre di consegna e piani di produzione che dicono settimana quarantadue senza nominare un mese. I calendari finanziari e delle risorse umane spesso chiudono i periodi per settimana ISO, e gli strumenti di reportistica devono trasformare quelle etichette in date di inizio e fine concrete per filtri ed esportazioni.

Gli sviluppatori richiamano lo stesso contratto dagli script per generare vettori di test deterministici per selettori di data, per normalizzare stringhe di settimana inserite dall'utente prima della memorizzazione, o per soddisfare enunciati di sfide di programmazione che richiedono un giorno di calendario invece di un'approssimazione a occhio. Gli insegnanti lo usano quando insegnano ISO-8601: gli studenti possono verificare che la settimana uno copra sempre il quattro gennaio e che solo gli anni lunghi accettino la settimana cinquantatré.

Gli strumenti di prodotto e integrazione usano la conversione quando un form raccoglie anno, settimana e giorno della settimana e il backend deve memorizzare un singolo AAAA-MM-GG per ordinamenti e join.

Casi d'uso

Programmi di logistica e produzione

Trasformate le etichette di settimana ISO su ordini e piani in date concrete AAAA-MM-GG di spedizione e produzione.

Calendari di buste paga e reportistica

Risolvete i periodi di settimana ISO in giorni di inizio e fine gregoriani per filtri, esportazioni e chiusure di periodo.

Domande frequenti

Quando la settimana 53 viene rifiutata?

Quando l'anno di settimana ISO ha solo 52 settimane.

L'anno di calendario può differire dall'anno di settimana ISO?

Sì. I giorni vicini ai confini d'anno cadono spesso nell'anno gregoriano precedente o successivo pur appartenendo all'anno di settimana ISO richiesto.

Questo strumento converte una data di calendario in una settimana ISO?

No. Mappa solo anno di settimana, settimana e giorno della settimana in una data. Usate il calcolatore del numero di settimana ISO per la direzione inversa.

Cosa indicano i tre numeri da inserire?

Il primo è l'anno di settimana ISO, il secondo il numero di settimana, da 1 a 52 o 53, e il terzo il giorno, da 1 per il lunedì a 7 per la domenica. Così 2024, 1 e 1 danno il 1° gennaio 2024.

Posso inserire un decimale o lasciare un valore vuoto?

No. I tre valori devono essere numeri interi; decimali, valori vuoti e testo vengono rifiutati, così una cella sbagliata del foglio di calcolo non diventa un giorno di spedizione sbagliato.

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-to-date

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-to-date \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2024,"week":1,"weekday":1}'

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

import os, requests

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

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

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

{
  "year": 2024,
  "week": 1,
  "weekday": 1
}

Esempio di risposta

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

Cosa restituisce la conversione da settimana ISO a data e quando fallisce

Questo convertitore risolve quella terna in una singola stringa data in forma estesa AAAA-MM-GG, più campi strutturati di anno, mese e giorno di calendario, il nome leggibile del giorno della settimana, la canonica iso_week_string come 2024-W01, e il conteggio weeks_in_iso_year usato per la validazione. La richiesta viene rifiutata con invalid_input quando il numero di settimana supera il conteggio delle settimane dell'anno — la maggior parte degli anni ha cinquantadue settimane, e solo gli anni il cui primo o ultimo giorno è un giovedì ne hanno cinquantatré — così la settimana cinquantatré del 2024 fallisce perché il 2024 ha solo cinquantadue settimane.

Come vengono letti anno, settimana e giorno della settimana e come la data resta riproducibile

I campi preferiti sono year per l'anno di numerazione delle settimane ISO, week per il numero di settimana, e weekday per il giorno della settimana ISO, con gli alias iso_week_year, week_year e y per year; iso_week, week_number e w per week; e iso_weekday, day e dow per weekday così fogli di calcolo, query string e form tipizzati possono riusare lo stesso contratto. Abbinate l'esecuzione gratuita nel browser di questa pagina all'API a pagamento quando vi serve lo stesso risultato matematico dentro una pipeline automatizzata, un connettore ERP o un generatore di calendario buste paga senza spedire una seconda libreria di calendario.

Dove si inserisce la conversione da settimana a data in pianificazione, logistica e software

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 una dimostrazione di pianificazione a una pipeline automatizzata senza cambiare il risultato matematico. Abbinatelo al calcolatore del numero di settimana ISO quando vi serve la mappatura inversa da una data di calendario a settimana e anno di settimana, e agli altri endpoint di data quando state costruendo un piccolo laboratorio di helper di calendario gratuiti e deterministici.

Casi di integrazione

Fixture di test deterministiche

Generate date di calendario riproducibili da terne anno/settimana/giorno per unit test e asserzioni CI.

Domande tecniche

Quanto costa il convertitore da settimana ISO a data?

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

Come sono definiti anno, settimana e giorno della settimana?

Year è l'anno di numerazione delle settimane ISO, week è da 1 a 52 o 53, e weekday è lunedì=1 fino a domenica=7 secondo ISO-8601.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser

Esempio risolto

Cosa restituisce la conversione da settimana ISO a data e quando fallisce

Come vengono letti anno, settimana e giorno della settimana e come la data resta riproducibile

Dove si inserisce la conversione da settimana a data in pianificazione, logistica e software

Casi d'uso

Programmi di logistica e produzione

Calendari di buste paga e reportistica

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

Cosa restituisce la conversione da settimana ISO a data e quando fallisce

Come vengono letti anno, settimana e giorno della settimana e come la data resta riproducibile

Dove si inserisce la conversione da settimana a data in pianificazione, logistica e software

Casi di integrazione

Fixture di test deterministiche

Domande tecniche

grazie