dogfather-universe/server/helfer-zeit.mjs

/* WELCHER TAG IST HEUTE? — für Prüfungen.

   DER FEHLER, DEN DAS VERHINDERT, gefunden am 06.09.2026 um 00:10.

   Der Gesamtlauf meldete plötzlich 13 Fehlschläge in
   pruef-teilnehmer.mjs -- an einer Datei, die seit Stunden niemand
   angefasst hatte. "der alte Termin ist da: FEHL", "sein Teilnehmer
   wurde uebernommen: LEER". Es sah aus, als sei die Teilnehmerfunktion
   kaputt.

   Sie war es nicht. Es war zehn nach Mitternacht.

       Ortszeit (MESZ):  06.09.2026, 00:10
       UTC:              05.09.2026, 22:10

   Die Prüfung bildete ihr Datum mit
   `new Date().toISOString().slice(0, 10)` -- das ist UTC und ergab den
   5. September. Die Anwendung rechnet den Tag dagegen LOKAL
   (heuteLokal() in workspace.js) und suchte am 6. Die Prüfung legte
   ihre Termine also auf gestern und wunderte sich, dass sie heute
   keine fand.

   ZWEI STUNDEN AM TAG war diese Prüfung damit rot -- zwischen
   Mitternacht und zwei Uhr, im Winter eine Stunde. Wer nur tagsüber
   läuft, sieht das nie; wer nachts arbeitet, sucht stundenlang an der
   falschen Stelle. Dieselbe Sorte Fehler wie die Layout-Messung, die
   je nach Serverlaune anschlug: Ein Ergebnis, das von der Uhrzeit
   abhängt, ist kein Ergebnis.

   Deshalb gibt es das hier EINMAL statt viermal in Kopie. Die
   Rechenweise ist bewusst dieselbe wie in workspace.js -- eine
   Prüfung, die den Tag anders bestimmt als die Anwendung, prüft nicht
   die Anwendung, sondern sich selbst.
   ===================================================================== */

/** Der heutige Tag in ORTSZEIT, als "JJJJ-MM-TT". */
export function heuteLokal() {
  const d = new Date();
  const p = (n) => String(n).padStart(2, "0");
  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
}

/** Derselbe Tag, um `versatz` Tage verschoben. Negativ heißt zurück.
 *
 *  ZWEI DINGE AM 22.09.2026 NACHGEZOGEN, beide durch einen echten Schaden:
 *
 *  (1) `versatz = 0`. Dogi-Media rief `tagLokal()` ohne Argument auf und
 *      bekam `"NaN-NaN-NaN"` zurück -- eine Zeichenkette, die aussieht
 *      wie ein Datum und sich wie keines verhält. Im Vergleich
 *      `"2026-12-31" < "NaN-NaN-NaN"` gewinnt das N, also galt JEDES
 *      Stück mit Enddatum vom ersten Tag an als abgelaufen, und
 *      "Kommt noch" gab es nie. Kein Absturz, keine Meldung, keine
 *      Zeile im Protokoll -- nur eine Seite, die etwas anderes zeigt
 *      als die Wahrheit. Die drei Kopien dieser Funktion waren an
 *      dieser Stelle auseinandergelaufen: helfer-tag.mjs hatte die
 *      Vorbelegung, die beiden anderen nicht.
 *
 *  (2) Der Wurf bei einer Zahl, die keine ist. Eine Vorbelegung deckt
 *      nur den leeren Aufruf ab; `tagLokal(irgendwas)` mit einer
 *      undefinierten Variablen läge weiter still daneben. Ein Datum,
 *      das sich nicht ausrechnen lässt, muss SCHEITERN und nicht
 *      schweigen -- sonst wandert der Unsinn in die Datenbank und in
 *      die Anzeige, und gefunden wird er Wochen später.
 *
 *  Gerechnet wird über die Millisekunden und danach lokal ausgelesen.
 *  `setDate(getDate() + n)` täte es auch, hat aber an den zwei
 *  Umstellungstagen im Jahr seine Tücken. */
export function tagLokal(versatz = 0) {
  if (!Number.isFinite(Number(versatz))) {
    throw new TypeError(`tagLokal: "${versatz}" ist keine Zahl von Tagen.`);
  }
  const d = new Date(Date.now() + versatz * 86400_000);
  const p = (n) => String(n).padStart(2, "0");
  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
}