KW 53 und Jahreswechsel: Datumsfehler im Shop vermeiden

Die Wochenzählung nach ISO 8601 folgt drei Regeln: Eine Woche beginnt am Montag, die Wochen eines Jahres werden von 01 bis 52 oder 53 durchnummeriert, und Woche 01 ist die erste Woche, von der mindestens vier Tage ins neue Jahr fallen (strftime(3)). Gleichbedeutend formuliert dieselbe Handbuchseite: Woche 01 ist die Woche mit dem ersten Donnerstag des Jahres, oder die Woche, in der der 4. Januar liegt. Daraus folgt der Kern des Problems. Eine Kalenderwoche gehört nicht zu dem Jahr, in dem ihr Montag liegt, sondern zu dem Jahr, in dem ihr Donnerstag liegt. Dieses Jahr heißt ISO-Wochenjahr, und es weicht an den Rändern vom Kalenderjahr ab.

Für den Jahreswechsel 2026/2027 bedeutet das: Der 1. Januar 2026 war ein Donnerstag, damit begann das ISO-Wochenjahr 2026 schon am Montag, 29. Dezember 2025. Die Woche vom 28. Dezember 2026 bis 3. Januar 2027 enthält den Donnerstag, 31. Dezember 2026, und zählt deshalb als Woche 53 des Jahres 2026. Neujahr sowie der 2. und 3. Januar 2027 liegen also im neuen Kalenderjahr, aber im alten Wochenjahr. Die KW 1 des Jahres 2027 beginnt erst am Montag, 4. Januar 2027. Die Python-Dokumentation beschreibt dasselbe aus Sicht des Kalenders: Ein ISO-Jahr besteht aus 52 oder 53 vollen Wochen, die am Montag beginnen und am Sonntag enden (Python-Dokumentation). Nach denselben Regeln hatten auch 2015 und 2020 eine KW 53, das nächste Mal folgt 2032.

Die Handbuchseite liefert ein Beispiel, das sich wie eine Vorlage für 2027 liest: Der 1. Januar 2010 war ein Freitag, nur drei Tage dieser Kalenderwoche fielen ins neue Jahr, und deshalb zählten sie als Woche 53 des Jahres 2009 (strftime(3)). Dieselbe Lage gab es zuletzt am 1. Januar 2021, und am 1. Januar 2027 kehrt sie zurück. Wer die Datumslogik seines Shops seitdem umgebaut oder um Erweiterungen ergänzt hat, sollte nicht davon ausgehen, dass sie den Fall noch beherrscht. Die Tabelle zeigt die betroffenen Tage.

Viele Wochenberichte entstehen nicht in PHP, sondern direkt in SQL: Umsatz je Kalenderwoche, Retouren je Woche, Bestellungen im Vergleich zur Vorjahreswoche. MariaDB berechnet die Wochennummer mit WEEK(), und das Ergebnis hängt von einem Modus ab. Die Modi 0 bis 7 unterscheiden, ob die Woche am Sonntag oder am Montag beginnt, ob die Zählung bei 0 oder 1 anfängt und welche Woche als erste gilt; nach ISO 8601 nummeriert nur Modus 3 (MariaDB-Dokumentation). Fehlt das zweite Argument, gilt der Wert der Systemvariablen default_week_format (MariaDB-Dokumentation), und dessen Voreinstellung ist 0, also Wochenbeginn am Sonntag und Zählung ab Woche 0 (MariaDB-Dokumentation).

Nachgemessen auf MariaDB 11.8 liefert der Aufruf ohne Modus für den 1. Januar 2027 die Woche 0, der ISO-Modus die Woche 53. Wer daneben YEAR() setzt, baut wieder die Kennung „2027-W53“ zusammen. Richtig ist YEARWEEK(datum, 3): Die Funktion gibt Jahr und Woche gemeinsam zurück, und die Dokumentation weist darauf hin, dass das Jahr im Ergebnis in der ersten und der letzten Woche vom Jahr des Datums abweichen kann (MariaDB-Dokumentation). Genau das ist hier gewollt.

Für Berichte folgt daraus eine einfache Regel: Die Wochenkennung wird an genau einer Stelle berechnet, als Paar aus ISO-Wochenjahr und ISO-Woche, und alle Berichte, Exporte und Dashboards übernehmen sie von dort. Wo eine Tabellenkalkulation die Daten weiterverarbeitet, gehört die fertige Kennung als Text in die Exportdatei, statt sie dort aus dem Datum neu berechnen zu lassen. Der Vergleich der KW 53 mit dem Vorjahr braucht zusätzlich eine Festlegung, denn 2025 hatte keine KW 53. Möglich ist der Vergleich mit der KW 52 des Vorjahres oder mit denselben Kalendertagen; welche Variante gilt, sollte im Bericht stehen, damit niemand im Januar einen Einbruch deutet, der nur aus der Zählweise kommt.

Nummernkreise sind ein bekannter Prüfpunkt zum Jahreswechsel und hier deshalb nur einer von mehreren. Shopware beschreibt Nummernkreise als Folgen aus Zeichen und Ziffern, mit denen Bestellungen, Kunden oder Belege eindeutig gekennzeichnet werden; je nach Anforderung kann es nötig sein, Tag, Monat oder Jahr in den Nummernkreis aufzunehmen (Shopware-Dokumentation). Im erweiterten Modus nimmt ein Muster dafür Platzhalter wie {date} oder {date_d.m.Y} auf, die fortlaufende Zahl steht in {n} und beginnt bei der angegebenen Startnummer (Shopware-Dokumentation). Einen automatischen Neubeginn zum 1. Januar beschreibt die Dokumentation nicht.

Für Rechnungen verlangt das Umsatzsteuergesetz eine fortlaufende Nummer mit einer oder mehreren Zahlenreihen, die der Rechnungsaussteller einmalig vergibt (§ 14 Abs. 4 Nr. 4 UStG). Ein Jahresanteil in der Nummer ist damit möglich, verlangt an der Jahresgrenze aber Sorgfalt: Er muss das Kalenderjahr wiedergeben und nicht das Wochenjahr, er muss in derselben Zeitzone entstehen wie das Rechnungsdatum, und eine Umstellung des Musters zum 1. Januar darf keine Nummer ein zweites Mal erzeugen. Ob und wie ein Nummernkreis zum Jahreswechsel neu beginnt, stimmen Sie mit Ihrer Steuerberatung ab. Technisch prüfen lässt sich vorab, welche Nummer der erste Beleg des neuen Jahres bekommt und welches Datum darauf steht.

An der Jahresgrenze hängen auch Löschläufe. Die Aufbewahrungsfrist beginnt nach der Abgabenordnung mit dem Schluss des Kalenderjahrs, in dem zum Beispiel der Buchungsbeleg entstanden ist (§ 147 AO). Bücher und Aufzeichnungen sind zehn Jahre, Buchungsbelege acht Jahre und sonstige Unterlagen sechs Jahre aufzubewahren, sofern andere Steuergesetze keine kürzeren Fristen zulassen (§ 147 AO). Ein Löschjob, der mit „Erstellungsdatum plus acht Jahre“ rechnet, löscht deshalb zu früh: Ein Buchungsbeleg vom 5. Januar 2026 darf nicht schon im Januar 2034 fallen, seine Frist endet frühestens mit Ablauf des Jahres 2034. Wie sich Aufbewahrung und Datenschutz im Shop vertragen, beschreibt der Beitrag zur DSGVO-konformen Datensicherung und Aufbewahrung.

Für den Handel fällt der Jahreswechsel in die umsatzstarke Zeit. Der Handelsverband Deutschland beziffert den Anteil der letzten beiden Monate am Jahresumsatz des Einzelhandels auf 18,5 Prozent (HDE). Für den Onlinehandel prognostiziert er im Weihnachtsgeschäft 2026 einen Umsatz von 23,1 Milliarden Euro (HDE). In einer vom Verband beauftragten Verbraucherumfrage planen 30 Prozent der Befragten, Geschenkgutscheine als Weihnachtsgeschenke zu kaufen; kein anderer Warenbereich wird häufiger genannt (HDE). Für die Datumslogik heißt das: Kurz vor dem Jahreswechsel laufen viele Aktionen aus, und kurz danach werden viele Gutscheine eingelöst.

Shopware-Aktionen haben je ein Feld für Beginn und Ende der Gültigkeit, mit denen sich festlegen lässt, ob und in welchem Zeitraum eine Aktion läuft (Shopware-Dokumentation). Am Jahresende lohnt der Blick auf drei Details. Erstens die Uhrzeit: Eine Aktion „bis 31. Dezember“ sollte bis 23:59 Uhr laufen und nicht um 0 Uhr desselben Tages enden. Zweitens die Zeitzone: Das Ende gehört im Probelauf mit Berliner Uhrzeit nachgesehen, nicht nur in der Maske. Drittens die Anschlussaktion: Eine Neujahrsaktion, die am 1. Januar um 0 Uhr beginnt, darf nicht mit der auslaufenden Aktion zusammentreffen, wenn beide nicht kombinierbar sein sollen. Wie Rabattcodes in der Spitzenzeit vor Missbrauch geschützt werden, steht im Beitrag zu Rabattcodes in der Black Week.

Gutscheine sind der zweite Punkt. Die regelmäßige Verjährungsfrist beträgt drei Jahre (§ 195 BGB) und beginnt, soweit nichts anderes bestimmt ist, mit dem Schluss des Jahres, in dem der Anspruch entstanden ist und der Gläubiger davon Kenntnis erlangt hat oder ohne grobe Fahrlässigkeit hätte erlangen müssen (§ 199 BGB). Eine Gültigkeit von „drei Jahren ab Kaufdatum“ und eine von „drei Jahren ab Jahresschluss“ ergeben deshalb verschiedene Enddaten, für einen Gutschein vom 20. Dezember 2026 den 20. Dezember 2029 oder den 31. Dezember 2029. Welche Gültigkeit für Ihre Gutscheine gilt, klärt die Rechtsberatung. Die Wartung sorgt dafür, dass die Einstellung im Shop dem entspricht, was in Ihren Bedingungen steht.

Auf den 31. Dezember zu warten, ist keine Teststrategie. Die meisten der beschriebenen Fehler lassen sich vorher auslösen, wenn eine Staging-Umgebung die Uhr auf die kritischen Zeitpunkte stellt: den 31. Dezember 2026 um 23:30 Uhr, den 1. Januar 2027 um 0:30 Uhr und den 4. Januar 2027 als ersten Werktag der KW 1. Auf Code-Ebene gibt es dafür eigene Werkzeuge. In PHP-Anwendungen auf Symfony-Basis stellt die Clock-Komponente eine Testuhr bereit, die mit einem festen Zeitpunkt startet und nicht von selbst weiterläuft (Symfony-Dokumentation). Eigener Code, der seine Zeit von einer solchen Uhr bezieht, lässt sich damit gezielt über den Jahreswechsel schieben.

Für einen Probelauf der ganzen Anwendung reicht das nicht, weil Datenbank, Cron-Dienst und Erweiterungen ihre Zeit selbst ermitteln. Dort wird die Systemzeit der Staging-Umgebung vorgestellt, und zwar nur dort. Ein paar Vorkehrungen gehören dazu: Mailversand und Zahlungsanbindungen im Testbetrieb, keine Verbindung zu Live-Schnittstellen und ein Blick auf Zertifikate und Tokens, deren Gültigkeit mit der vorgestellten Uhr anders aussehen kann. Wie eine Staging-Umgebung dafür aufgebaut wird, steht im Beitrag zu Staging-Umgebungen für sichere Updates.

Der Probelauf ist zugleich eine Gelegenheit, die Prüfung dauerhaft zu machen. Ein automatischer Test, der die Wochenkennung für den 29. Dezember 2025, den 1. Januar 2027 und den 3. Januar 2027 prüft, kostet wenige Zeilen und schlägt bei jeder späteren Änderung an, die o wieder durch Y ersetzt. Dasselbe gilt für einen Test, der eine Rechnung für 0:30 Uhr am Neujahrsmorgen erzeugt und ihr Datum prüft.

Datumsfehler zum Jahreswechsel sind selten spektakulär, aber sie sind teuer im Nachgang: Berichte müssen neu gerechnet, Belege geprüft und Exporte nachgeliefert werden, oft in einer Woche mit dünner Besetzung. In der Shopware-Wartung gehören die Überwachung und Pflege der Shopware-Cronjobs und Message-Queue-Worker sowie Updates mit vorheriger Prüfung auf einer Staging-Umgebung zum Umfang. Der Jahreswechsel lässt sich dort als fester Prüfpunkt in den Wartungsplan aufnehmen, mit Codesuche, Zeitzonenabgleich und Probelauf. Das Monitoring überwacht Erreichbarkeit und Fehlerlogs rund um die Uhr, auch in der Nacht zum 1. Januar.

Der Jahreswechsel ist nicht der einzige Termin, der in diesen Wochen in den Wartungsplan gehört. Wer vor dem Jahresende Zugänge und Zuständigkeiten durchgeht, sollte auch an Anrufe vom falschen Dienstleister denken, und wer für 2027 eine Sicherheitsprüfung plant, findet im Beitrag zum Penetrationstest für den Shop eine Entscheidungshilfe. Fragen zu Ihrem Shop klären wir über die Kontaktseite.