ForHosting KIT · Entwickler-Tools

Black-Friday-Datum für jedes Jahr berechnen

Der Rechner liefert für das von Ihnen angegebene Jahr den Freitag unmittelbar nach dem US-amerikanischen Thanksgiving.

● BetaKostenlos · im Browser
Nutzen Sie es über WebAPIE-MailTelegramApp bald

Er greift weder auf eine gespeicherte Feiertagsliste noch auf einen Onlinekalender zurück. Stattdessen bestimmt er im gregorianischen Kalender den vierten Donnerstag im November und geht einen Tag weiter. Das Ergebnis enthält das Black-Friday-Datum, die Angabe Freitag und das für die Berechnung verwendete Thanksgiving-Datum. Dadurch lässt es sich leicht prüfen und für Terminpläne, Berichte, Handelsplanung sowie automatisierte Abläufe verwenden.

So wird das Black-Friday-Datum bestimmt

In den Vereinigten Staaten ist Black Friday der Tag nach Thanksgiving. Thanksgiving fällt dort auf den vierten Donnerstag im November. Die Berechnung ermittelt deshalb zunächst, auf welchen Wochentag der 1. November des gewünschten gregorianischen Jahres fällt. Anschließend findet sie den ersten Donnerstag, addiert drei vollständige Wochen bis zum vierten Donnerstag und geht einen Kalendertag weiter. Damit liegt Black Friday stets zwischen dem 23. und 29. November. Die Funktion gibt beide Daten zurück, sodass Sie den Feiertag erkennen können, auf dem das Ergebnis beruht, statt nur einen unbegründeten Wert zu erhalten. Eine Feiertagstabelle wird nicht abgefragt; das Resultat hängt somit nicht vom Aktualisierungsstand einer Datenbank ab. Dasselbe Jahr führt immer zur selben Antwort. Das eignet sich für langfristige Planungen, historische Vergleiche und Systeme, die eine beständige Kalenderregel anstelle einer manuell gepflegten Datumsliste benötigen. Die Berechnung bildet die US-amerikanische Feiertagsbeziehung ab, nicht ausländische Verkaufsaktionen, die denselben Namen möglicherweise an anderen Terminen verwenden.

Deterministische gregorianische Kalenderarithmetik

Der Rechner verwendet Ganzzahlarithmetik im proleptischen gregorianischen Kalender. Er zählt abgeschlossene Jahre, wendet die bekannte Schaltjahrregel an und bestimmt den Wochentagsversatz bis November. Ein durch vier teilbares Jahr ist üblicherweise ein Schaltjahr; Jahrhundertjahre sind ausgenommen, sofern sie nicht zugleich durch vierhundert teilbar sind. Diese Regeln beeinflussen, an welchem Wochentag der November beginnt, obwohl der Zielmonat lange nach Februar liegt. Die Implementierung liest keine Uhr, nimmt keine lokale Zeitzone an, kontaktiert keinen Netzwerkdienst und hängt nicht von den Regionseinstellungen des Rechners ab. Daher erhält eine Anfrage aus UTC, New York, Tokio oder jeder anderen Zeitzone dasselbe ISO-formatierte Datum. Zulässig sind Jahre von 1 bis 9999; frühe Jahre werden vierstellig mit führenden Nullen ausgegeben. Dieser Bereich wahrt die übliche vierstellige ISO-Darstellung und ermöglicht umfangreiche historische sowie zukünftige Berechnungen. Der Kalender wird auch für Zeiten vor seiner amtlichen Einführung einheitlich rückwärts fortgeführt.

Das Ergebnis für Planung und Automatisierung nutzen

Übermitteln Sie im Jahresfeld eine Ganzzahl und verwenden Sie das zurückgegebene Datum überall dort, wo ein beständiger jährlicher Handelstermin benötigt wird. Marketingteams können Kampagnenfristen relativ zum Ergebnis festlegen, Handelsteams Katalogsperren und Personalpläne vorbereiten und Analysten Jahresberichte an einem vergleichbaren Feiertagszeitraum ausrichten. Da die Antwort auch thanksgiving_date enthält, kann eine Integration den Abstand von einem Tag prüfen oder beide Termine ohne eine zweite Feiertagsabfrage anzeigen. day_of_week macht die Antwort für Leser und nachgelagerte Oberflächen eindeutig, während date den primären ISO-Wert zum Sortieren und Speichern liefert. Die Automatisierung per API kostet $0.002 je Anfrage; die Browserversion führt dieselbe reine Berechnung lokal aus. Verstehen Sie das Ergebnis als Kalenderdatum, nicht als Vorhersage für Öffnungszeiten, Aktionen, Versandfristen oder Marktverhalten. Einzelne Unternehmen können früher beginnen, und andere Länder kennen abweichende Feiertage. Für Betriebszeiten sollten Sie dieses Datum mit einem maßgeblichen Geschäftskalender verbinden.

Einen Kampagnenkalender für den Handel aufbauen

Berechnen Sie den jährlichen Bezugstermin, bevor Sie Kreativprüfungen, Produktstarts und Aktionshinweise planen.

Saisonale Verkaufszeiträume vergleichen

Richten Sie Berichte verschiedener Jahre am tatsächlichen Black Friday aus, nicht an einem festen Novemberdatum.

Termine für künftige Planungen erzeugen

Füllen Sie Kalender und Ablaufmeilensteine für viele Jahre, ohne eine Feiertagstabelle zu pflegen.

Wie wird Black Friday berechnet?

Der Rechner findet den vierten Donnerstag im November, das US-amerikanische Thanksgiving, und gibt den folgenden Tag zurück.

Was kostet eine API-Anfrage?

Jede API-Anfrage kostet $0.002. Dieselbe deterministische Berechnung lässt sich auch lokal im Browser ausführen.

Hängt die Berechnung von meiner Zeitzone ab?

Nein. Sie nutzt Kalenderarithmetik und liefert unabhängig von Standort und Zeitzone dasselbe ISO-Datum.

Welche Jahre sind zulässig?

Die Eingabe muss eine Ganzzahl von 1 bis 9999 im proleptischen gregorianischen Kalender sein.

Liegt Black Friday immer im November?

Ja, gemäß dieser US-amerikanischen Definition. Er liegt zwischen dem 23. und 29. November, da er auf den vierten Donnerstag folgt.

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

POSThttps://api.kit.forhosting.com/date/black-friday

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

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"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

HTTPCodeBedeutung
401unauthorizedDer API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
402insufficient_balanceIhr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
404unknown_typeUnbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
429rate_limitedZu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →