Calcolo della data del Black Friday per anno
Il calcolatore della data del Black Friday restituisce il venerdì immediatamente successivo al Giorno del Ringraziamento degli Stati Uniti per l’anno indicato da Lei.
Esegui gratis nel browser
Non dipende da un elenco di festività memorizzato né da un calendario online. Individua invece il quarto giovedì di novembre nel calendario gregoriano e avanza di un giorno. Il risultato comprende la data del Black Friday, l’indicazione del venerdì e la data del Ringraziamento usata nel calcolo, così può essere verificato con facilità e impiegato in calendari, relazioni, pianificazione commerciale e flussi automatizzati.
Come viene stabilita la data del Black Friday
Negli Stati Uniti il Black Friday è il giorno successivo al Ringraziamento. Questa festività ricorre il quarto giovedì di novembre, quindi il calcolo inizia stabilendo il giorno della settimana del 1º novembre nell’anno gregoriano richiesto. Individua poi il primo giovedì, aggiunge tre settimane intere per raggiungere il quarto giovedì e avanza di un giorno di calendario. La regola produce una data compresa fra il 23 e il 29 novembre. La capacità restituisce entrambe le date affinché Lei possa vedere la festività da cui deriva la risposta, invece di ricevere un valore privo di spiegazione. Non viene consultata alcuna tabella di festività, perciò il risultato non dipende dall’aggiornamento di un database. Lo stesso anno genera sempre la stessa risposta. Ciò è utile per pianificazioni future, confronti storici e sistemi che richiedono una regola stabile invece di un elenco mantenuto a mano. Il calcolo segue la relazione con la festività statunitense e non rappresenta iniziative promozionali estere che possono usare lo stesso nome in date differenti.
Aritmetica deterministica del calendario gregoriano
Il calcolatore usa aritmetica intera sul calendario gregoriano prolettico. Conta gli anni completati, applica la regola consueta degli anni bisestili e determina lo scarto settimanale prima di novembre. Un anno divisibile per quattro è normalmente bisestile; gli anni secolari sono esclusi, salvo quelli divisibili per quattrocento. Queste regole incidono sul giorno della settimana in cui comincia novembre, anche se il mese si trova molto dopo febbraio. L’implementazione non legge l’orologio, non presume un fuso locale, non contatta servizi di rete e non dipende dalle impostazioni regionali del computer. Una richiesta inviata in UTC, da New York, da Tokyo o da qualsiasi altro fuso riceve quindi la stessa data in formato ISO. Sono ammessi gli anni da 1 a 9999, rappresentati con quattro cifre e zeri iniziali per gli anni più antichi. L’intervallo conserva la compatibilità con la comune rappresentazione ISO e consente ampi calcoli storici e futuri. Il calendario viene applicato a ritroso con coerenza, anche prima della sua adozione ufficiale.
Uso del risultato nella pianificazione e nell’automazione
Invii un numero intero nel campo dell’anno e utilizzi la data restituita ovunque serva una scadenza commerciale annuale stabile. I gruppi marketing possono fissare le tappe delle campagne rispetto al risultato, i commercianti preparare blocchi di catalogo e piani del personale, mentre gli analisti possono allineare le relazioni annuali attorno a periodi festivi confrontabili. Poiché la risposta include anche thanksgiving_date, un’integrazione può verificare la distanza di un giorno o mostrare entrambe le tappe senza una seconda ricerca. Il campo day_of_week rende la risposta esplicita per lettori e interfacce, mentre date è il valore ISO principale per ordinamento e archiviazione. L’automazione tramite API costa $0.002 per richiesta e la versione nel browser esegue localmente lo stesso calcolo puro. Consideri la risposta una data di calendario, non una previsione di orari, promozioni, scadenze di spedizione o andamento del mercato. Le aziende possono anticipare le offerte e altri Paesi possono osservare festività diverse. Per gli orari operativi, abbini la data a un calendario aziendale autorevole.
Casi d'uso
Creare un calendario di campagne commerciali
Calcoli la ricorrenza annuale prima di programmare revisioni creative, lanci di prodotti e promemoria promozionali.
Confrontare i periodi di vendite festive
Allinei i rapporti di anni diversi al Black Friday effettivo di ciascun anno, non a una data fissa di novembre.
Generare date per piani futuri
Compili calendari e tappe dei flussi per molti anni senza mantenere una tabella delle festività.
Domande frequenti
Come viene calcolato il Black Friday?
Il calcolatore individua il quarto giovedì di novembre, il Ringraziamento statunitense, e restituisce il giorno seguente.
Quanto costa una richiesta API?
Ogni richiesta API costa $0.002. Lo stesso calcolo deterministico può essere eseguito localmente anche nel browser.
Il calcolo dipende dal mio fuso orario?
No. Usa aritmetica di calendario e restituisce la stessa data ISO indipendentemente dalla posizione o dal fuso.
Quali anni sono accettati?
Il valore deve essere un intero compreso fra 1 e 9999 nel calendario gregoriano prolettico.
Il Black Friday cade sempre a novembre?
Sì, secondo questa definizione statunitense. Cade fra il 23 e il 29 novembre perché segue il quarto giovedì.
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/black-friday \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026}'const res = await fetch("https://api.kit.forhosting.com/date/black-friday", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"year": 2026
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/black-friday",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"year": 2026
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/black-friday", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"year":2026}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"year":2026}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/black-friday", 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": 2026
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.black_friday",
"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. |