ForHosting KIT · Strumenti per sviluppatori

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.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

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.

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à.

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ì.

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/black-friday

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/black-friday \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'
{
  "year": 2026
}
{
  "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.

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.

Leggi la documentazione completa del KIT →