Gaokao-Countdown-Tool

Der Gaokao-Countdown zeigt die verbleibende Zeit bis zur chinesischen Hochschulaufnahmeprüfung in Tagen, Stunden, Minuten und Sekunden an. Er ist weniger ein Kalendergadget als ein klarer Zeitanker für die letzte Vorbereitungsphase: Lernpläne, Mock-Exams, Wiederholungsrunden, Schlafrhythmus und familiäre Organisation lassen sich an einem gemeinsamen Datum ausrichten. Besonders hilfreich ist er, wenn mehrere Personen denselben Prüfungszeitraum im Blick behalten müssen und nicht jedes Mal manuell nachrechnen wollen. Die Anzeige ersetzt keine Studienplanung, macht aber sichtbar, wie knapp oder komfortabel der Puffer tatsächlich ist. Bei gemeinsamer Nutzung sollten Eingaben, Annahmen und gewünschtes Ergebnis vorher klar sein, damit die Ausgabe nicht falsch interpretiert wird.

Der Countdown ist eine einfache Subtraktion, die in einer Aktualisierungsschleife läuft. Die verbleibende Dauer wird als `target.getTime() - Date.now()` in Millisekunden berechnet und dann durch ganzzahlige Division aufgelöst: Tage = `Math.floor(diff / 86400000)`, Stunden = `Math.floor(diff / 3600000) % 24`, Minuten = `Math.floor(diff / 60000) % 60`, Sekunden = `Math.floor(diff / 1000) % 60`. Der Zielzeitpunkt ist fest: Die Gaokao findet jährlich am 7. Juni ab 09:00 Uhr China Standard Time (UTC+8) statt, wobei einige Provinzen mit neuem Gaokao-Format auf einen vierten Tag erweitert sind. Die Überlaufregel vergleicht `Date.now()` mit `new Date(year, 5, 9, 17, 0)` – JS-Monate sind 0-indiziert, also ist 5 der Juni – und erhöht `year` um eins, sobald dieser Zeitpunkt vergangen ist. Zwei Timing-Fallen treiben die Aktualisierungsschleife an. Erstens driftet `setInterval(fn, 1000)`: Der Callback kann unter Last des Main-Threads 1003–1020 ms später feuern, und die Drift akkumuliert sich, weil die nächste Deadline vom vorherigen Feuerzeitpunkt und nicht von einer Wanduhr-Verankerung geplant wird. Die Lösung besteht darin, `setTimeout` mit einer Verzögerung von `1000 - (Date.now() % 1000)` zu planen, sodass jeder Tick auf die nächste volle Sekunde ausgerichtet wird, oder den angezeigten Wert bei jedem Feuern aus `Date.now()` neu zu berechnen statt einen Zähler zu inkrementieren. Zweitens drosseln die HTML5 Page Visibility API und die Browser-Politik Timer in Hintergrund-Tabs auf etwa einmal pro Minute (mindestens 1 Hz in modernen Chrome/Firefox/Safari bei verstecktem Tab); die Seite gleicht aus, indem sie bei `visibilitychange` aus `Date.now()` neu berechnet, anstatt Intervall-Feuerungen zu zählen. `requestAnimationFrame` ist für die sanfte Ziffern-Flip-Animation reserviert und pausiert automatisch, wenn der Tab versteckt ist, daher darf es nicht als Zeitstempelquelle dienen. Die Lokalisierung verwendet die Gerätezeitzone, die von `Intl.DateTimeFormat().resolvedOptions().timeZone` zurückgegeben wird. Für einen Kandidaten außerhalb von UTC+8 zeigt der Countdown weiterhin auf China Standard Time, daher wird das Ziel einmal mit `Date.UTC(year, 5, 7, 1, 0, 0)` konstruiert – 09:00 CST ist 01:00 UTC – statt mit dem lokalen `Date`-Konstruktor, der den Geräte-Offset stillschweigend verwenden würde. Schaltjahre sind nur relevant, wenn der Planungsanker des Benutzers auf den 29. Februar fällt: Ein 100-Tage-Sprint, der am 29. Februar beginnt, landet an einem anderen Kalenderdatum als derselbe Sprint, der am 28. Februar eines Nicht-Schaltjahrs beginnt. Die Speicherung erfolgt über `localStorage` für das optionale Theme und Ziel-Override; die optionale Benachrichtigung bei T-0 verwendet `Notification.requestPermission()` einmal pro Sitzung und `new Notification(title, { body })` für eine systemweite Warnung ohne die Seite zu verlassen.

• Kernformel: `diff = target.getTime() - Date.now()`; Tage = `Math.floor(diff / 86400000)`, dann `% 24`, `% 60`, `% 60` für Std/Min/Sek. Konstanten: 86.400.000 ms/Tag, 3.600.000 ms/Stunde, 60.000 ms/Min.
• Ziel: 7. Juni, 09:00 China Standard Time (UTC+8). JS-Monatsindex ist 5 für Juni. Überlauf wird ausgelöst, wenn `Date.now() > new Date(year, 5, 9, 17, 0)`; dann `year += 1`.
• Timer-Drift: `setInterval(fn, 1000)` driftet unter Last des Main-Threads. Selbstkorrigierendes Muster: `setTimeout(fn, 1000 - Date.now() % 1000)` richtet jeden Tick auf die nächste volle Sekunde aus.
• Hintergrund-Drosselung: Page Visibility API + Browser-Politik begrenzt Timer in versteckten Tabs auf 1 Hz (Chrome/Firefox/Safari). Abgleich durch Neuberechnung aus `Date.now()` bei `visibilitychange`, nicht durch Zählen der Feuerungen.
• Zeitzone: Das Ziel wird über `Date.UTC(year, 5, 7, 1, 0, 0)` erstellt (09:00 CST = 01:00 UTC), sodass Kandidaten außerhalb von UTC+8 weiterhin einen korrekten Countdown zum Prüfungszeitpunkt sehen, nicht zu ihrem lokalen 09:00.
• Persistenz: `localStorage.setItem(key, value)` (synchron, ~5 MB Origin-Quota) für Theme und Ziel-Overrides. Benachrichtigungen verwenden `Notification.requestPermission()` dann `new Notification(title, { body, icon })`.
• Rendering: `requestAnimationFrame` steuert die Ziffern-Flip-Animation (auto-pausiert bei Verstecken); die angezeigten Ziffern werden bei jedem Frame aus `Date.now()` neu berechnet, nicht inkrementiert, sodass ein verpasstes Frame nie zu wenig zählt.