import { test, describe } from "node:test"; import assert from "node:assert/strict"; import { getStartOfWeek, getDayName, isSameDay, formatDateToISO, parseCalendarDate, formatHour, getTimeSlots, getHourFromSlot, getWeekNumber, getCWReferenceDate, getSelectedDay, splitEventByDay, groupEventSegmentsByDay, segmentStartMinutes, segmentEndMinutes, } from "../../src/lib/weekly/date-utils.ts"; /** * Unit-Tests der Datums- und Zeitraster-Helfer. * * Läuft ohne Browser, ohne Datenbank, ohne laufende App: `npm run test:unit`. * * Die Erwartungen sind bewusst gegen unabhängig überprüfbare Fakten formuliert * (Kalenderdaten, ISO-8601-Regeln) und nicht gegen die Implementierung — ein Test, * der nur nachspricht, was der Code tut, findet keine Fehler. */ describe("getWeekNumber (ISO 8601)", () => { // Die Wochenzahl wird prominent in der Kopfzeile angezeigt ("KW 34 | August 2026"), // ein Fehler hier fällt sofort jedem Nutzer auf. test("Donnerstag 01.01.2026 liegt in KW 1", () => { assert.equal(getWeekNumber(new Date(2026, 0, 1)), 1); }); test("Samstag 22.08.2026 liegt in KW 34", () => { assert.equal(getWeekNumber(new Date(2026, 7, 22)), 34); }); test("Mittwoch 02.09.2026 liegt in KW 36", () => { assert.equal(getWeekNumber(new Date(2026, 8, 2)), 36); }); test("Montag 01.01.2024 liegt in KW 1", () => { assert.equal(getWeekNumber(new Date(2024, 0, 1)), 1); }); test("Sonntag 01.01.2023 gehört noch zu KW 52 des Vorjahres", () => { // ISO 8601: Die Woche gehört dem Jahr, in dem ihr Donnerstag liegt. assert.equal(getWeekNumber(new Date(2023, 0, 1)), 52); }); test("Freitag 01.01.2021 gehört zu KW 53 des Vorjahres", () => { assert.equal(getWeekNumber(new Date(2021, 0, 1)), 53); }); }); describe("getStartOfWeek", () => { test("Wochenstart Montag: Donnerstag 03.09.2026 → Montag 31.08.2026", () => { const r = getStartOfWeek(new Date(2026, 8, 3), 1); assert.equal(formatDateToISO(r), "2026-08-31"); }); test("Wochenstart Montag: Sonntag gehört zur ablaufenden Woche", () => { // Der klassische Stolperstein — Sonntag ist Tag 0, liegt aber am Wochenende. const r = getStartOfWeek(new Date(2026, 8, 6), 1); assert.equal(formatDateToISO(r), "2026-08-31"); }); test("Wochenstart Sonntag: Sonntag ist bereits der Wochenstart", () => { const r = getStartOfWeek(new Date(2026, 8, 6), 0); assert.equal(formatDateToISO(r), "2026-09-06"); }); test("Ein Tag, der bereits der Wochenstart ist, bleibt unverändert", () => { const r = getStartOfWeek(new Date(2026, 7, 31), 1); assert.equal(formatDateToISO(r), "2026-08-31"); }); test("verändert das übergebene Datum nicht", () => { const input = new Date(2026, 8, 3); getStartOfWeek(input, 1); assert.equal(formatDateToISO(input), "2026-09-03"); }); }); describe("formatDateToISO", () => { test("formatiert mit führenden Nullen", () => { assert.equal(formatDateToISO(new Date(2026, 0, 5)), "2026-01-05"); }); test("nutzt die lokale Zeit, nicht UTC", () => { // Kern der Sache: toISOString() würde bei einem späten Abendtermin in einer // Zeitzone östlich von UTC auf den Folgetag rutschen. Genau daraus entstehen // Termine, die im Kalender einen Tag daneben landen. const spaeterAbend = new Date(2026, 8, 7, 23, 30, 0); assert.equal(formatDateToISO(spaeterAbend), "2026-09-07"); }); test("früher Morgen bleibt am selben Tag", () => { assert.equal(formatDateToISO(new Date(2026, 8, 7, 0, 30, 0)), "2026-09-07"); }); }); describe("parseCalendarDate", () => { test("reines Datum wird als lokale Mitternacht gelesen", () => { const d = parseCalendarDate("2026-09-07"); assert.equal(d.getFullYear(), 2026); assert.equal(d.getMonth(), 8); assert.equal(d.getDate(), 7); assert.equal(d.getHours(), 0); }); test("Round-Trip mit formatDateToISO ist verlustfrei", () => { // Diese beiden Funktionen sind die Brücke zwischen Datenbank und Anzeige. // Wenn sie auseinanderlaufen, verschieben sich Aufgaben um einen Tag. for (const s of ["2026-01-01", "2026-06-15", "2026-12-31", "2026-02-28"]) { assert.equal(formatDateToISO(parseCalendarDate(s)), s); } }); }); describe("getTimeSlots", () => { test("30-Minuten-Raster von 8 bis 10 Uhr", () => { assert.deepEqual(getTimeSlots(30, 8, 10), ["08:00", "08:30", "09:00", "09:30"]); }); test("15-Minuten-Raster ergibt vier Einträge pro Stunde", () => { assert.deepEqual(getTimeSlots(15, 9, 10), ["09:00", "09:15", "09:30", "09:45"]); }); test("volle Stunden über den ganzen Tag ergeben 24 Einträge", () => { const slots = getTimeSlots(60, 0, 24); assert.equal(slots.length, 24); assert.equal(slots[0], "00:00"); assert.equal(slots[23], "23:00"); }); test("Endstunde ist exklusiv", () => { assert.equal(getTimeSlots(60, 8, 9).length, 1); }); test("leeres Ergebnis, wenn Ende nicht nach Start liegt", () => { assert.deepEqual(getTimeSlots(30, 10, 10), []); }); }); describe("formatHour", () => { test("24h-Format, kurz, ohne Minuten", () => { assert.equal(formatHour(9, 0, "short", "24h"), "9"); }); test("24h-Format mit Minuten wird zweistellig", () => { assert.equal(formatHour(9, 30, "short", "24h"), "09:30"); }); test("12h-Format: Nachmittag", () => { assert.equal(formatHour(13, 0, "short", "12h"), "1 PM"); }); test("12h-Format: Mitternacht ist 12 AM, nicht 0 AM", () => { assert.equal(formatHour(0, 0, "short", "12h"), "12 AM"); }); test("12h-Format: Mittag ist 12 PM", () => { assert.equal(formatHour(12, 0, "short", "12h"), "12 PM"); }); }); describe("getHourFromSlot", () => { test("liest die Stunde aus dem Slot", () => { assert.equal(getHourFromSlot("08:30"), 8); assert.equal(getHourFromSlot("23:45"), 23); }); test("führende Null wird nicht als Oktalzahl gelesen", () => { assert.equal(getHourFromSlot("09:00"), 9); }); }); describe("isSameDay", () => { test("gleicher Tag, verschiedene Uhrzeit", () => { assert.equal(isSameDay(new Date(2026, 8, 7, 8, 0), new Date(2026, 8, 7, 22, 0)), true); }); test("aufeinanderfolgende Tage sind nicht gleich", () => { assert.equal(isSameDay(new Date(2026, 8, 7), new Date(2026, 8, 8)), false); }); test("gleicher Tag im anderen Jahr ist nicht gleich", () => { assert.equal(isSameDay(new Date(2026, 8, 7), new Date(2025, 8, 7)), false); }); }); describe("getCWReferenceDate", () => { test("liefert den Montag der Woche des ersten sichtbaren Tages", () => { const days = [new Date(2026, 8, 3), new Date(2026, 8, 4)]; // Do, Fr assert.equal(formatDateToISO(getCWReferenceDate(days)), "2026-08-31"); }); test("Sonntag gehört zur ablaufenden Woche, nicht zur kommenden", () => { const days = [new Date(2026, 8, 6)]; // Sonntag assert.equal(formatDateToISO(getCWReferenceDate(days)), "2026-08-31"); }); test("leere Liste liefert ein Datum statt zu werfen", () => { assert.ok(getCWReferenceDate([]) instanceof Date); }); }); describe("getSelectedDay", () => { test("ohne ausdrückliche Auswahl wird ein Tag aus der Liste geliefert", () => { const days = [new Date(2026, 8, 7), new Date(2026, 8, 8)]; assert.ok(days.some((d) => isSameDay(d, getSelectedDay(days)))); }); test("eine ausdrückliche Auswahl aus der Liste wird übernommen", () => { const days = [new Date(2026, 8, 7), new Date(2026, 8, 8)]; assert.equal(formatDateToISO(getSelectedDay(days, days[1])), "2026-09-08"); }); }); describe("getDayName", () => { test("deutscher Wochentag, lang", () => { assert.equal(getDayName(new Date(2026, 8, 7), "de-DE"), "Montag"); }); test("eigene Namen werden nach Wochentag zugeordnet", () => { const namen = "So,Mo,Di,Mi,Do,Fr,Sa"; assert.equal(getDayName(new Date(2026, 8, 7), "de-DE", "custom", namen, 0), "Mo"); }); test("eigene Namen mit falscher Anzahl fallen auf das Gebietsschema zurück", () => { assert.equal(getDayName(new Date(2026, 8, 7), "de-DE", "custom", "nur,drei,Namen"), "Montag"); }); test("Großschreibung ist einstellbar", () => { assert.equal(getDayName(new Date(2026, 8, 7), "de-DE", undefined, undefined, 0, "uppercase"), "MONTAG"); }); }); /** * Termine über Mitternacht. * * Erwartetes Nutzerverhalten: Ein Termin von 22:00 bis 02:00 verlängert nicht den * Starttag, sondern wird an der Tagesgrenze geteilt und läuft am Folgetag weiter — * so, wie es Kalender-Apps zeigen. */ describe("splitEventByDay", () => { const iso = (y: number, m: number, d: number, h: number, min = 0) => new Date(y, m, d, h, min, 0, 0).toISOString(); const event = (startTime: string, endTime: string, id = "e1") => ({ id, title: "Termin", startTime, endTime, source: "google" as const, }); test("Termin innerhalb eines Tages bleibt ein Abschnitt", () => { const segments = splitEventByDay(event(iso(2026, 8, 10, 9), iso(2026, 8, 10, 10, 30))); assert.equal(segments.length, 1); assert.equal(segments[0].continuesFromPreviousDay, false); assert.equal(segments[0].continuesOnNextDay, false); assert.equal(segments[0].segmentKey, "e1"); }); test("22:00 bis 02:00 ergibt zwei Abschnitte an der Tagesgrenze", () => { const segments = splitEventByDay(event(iso(2026, 8, 10, 22), iso(2026, 8, 11, 2))); assert.equal(segments.length, 2); const first = new Date(segments[0].startTime); const firstEnd = new Date(segments[0].endTime); assert.equal(first.getHours(), 22); assert.equal(firstEnd.getDate(), 11); assert.equal(firstEnd.getHours(), 0); assert.equal(segments[0].continuesOnNextDay, true); const second = new Date(segments[1].startTime); const secondEnd = new Date(segments[1].endTime); assert.equal(second.getDate(), 11); assert.equal(second.getHours(), 0); assert.equal(second.getMinutes(), 0); assert.equal(secondEnd.getHours(), 2); assert.equal(segments[1].continuesFromPreviousDay, true); assert.equal(segments[1].continuesOnNextDay, false); }); test("kein Abschnitt verliert Zeit: Summe der Abschnitte ist die Termindauer", () => { const start = iso(2026, 8, 10, 22); const end = iso(2026, 8, 13, 3, 15); const segments = splitEventByDay(event(start, end)); const total = segments.reduce( (sum, s) => sum + (new Date(s.endTime).getTime() - new Date(s.startTime).getTime()), 0, ); assert.equal(total, new Date(end).getTime() - new Date(start).getTime()); }); test("Termin über drei Tage ergibt drei Abschnitte mit vollem Mitteltag", () => { const segments = splitEventByDay(event(iso(2026, 8, 10, 23), iso(2026, 8, 12, 1))); assert.equal(segments.length, 3); const middle = segments[1]; assert.equal(new Date(middle.startTime).getHours(), 0); assert.equal(new Date(middle.endTime).getDate(), 12); assert.equal(middle.continuesFromPreviousDay, true); assert.equal(middle.continuesOnNextDay, true); }); test("Ende exakt um Mitternacht erzeugt keinen leeren Abschnitt am Folgetag", () => { const segments = splitEventByDay(event(iso(2026, 8, 10, 22), iso(2026, 8, 11, 0))); assert.equal(segments.length, 1); assert.equal(segments[0].continuesOnNextDay, false); }); test("Abschnitte eines Termins haben unterschiedliche Keys, aber dieselbe Event-Id", () => { const segments = splitEventByDay(event(iso(2026, 8, 10, 22), iso(2026, 8, 11, 2))); assert.notEqual(segments[0].segmentKey, segments[1].segmentKey); assert.equal(segments[0].id, "e1"); assert.equal(segments[1].id, "e1"); assert.equal(segments[1].sourceEvent.startTime, iso(2026, 8, 10, 22)); assert.equal(segments[1].sourceEvent.endTime, iso(2026, 8, 11, 2)); }); test("Ganztagstermin wird nicht geteilt", () => { const segments = splitEventByDay(event("2026-09-10", "2026-09-12")); assert.equal(segments.length, 1); assert.equal(segments[0].segmentCount, 1); }); test("Ende vor Start bleibt ein Abschnitt und wirft nicht", () => { const segments = splitEventByDay(event(iso(2026, 8, 10, 12), iso(2026, 8, 10, 11))); assert.equal(segments.length, 1); }); }); describe("Tagesgruppierung und Minutenumrechnung der Abschnitte", () => { const iso = (y: number, m: number, d: number, h: number, min = 0) => new Date(y, m, d, h, min, 0, 0).toISOString(); test("Abschnitte landen im jeweiligen Tag", () => { const byDay = groupEventSegmentsByDay([ { id: "a", title: "Nacht", startTime: iso(2026, 8, 10, 22), endTime: iso(2026, 8, 11, 2), source: "google" }, { id: "b", title: "Tag", startTime: iso(2026, 8, 11, 9), endTime: iso(2026, 8, 11, 10), source: "google" }, ]); assert.equal(byDay.get("2026-09-10")?.length, 1); assert.equal(byDay.get("2026-09-11")?.length, 2); }); test("bis Mitternacht laufender Abschnitt endet bei Minute 1440, nicht bei 0", () => { const [first] = splitEventByDay({ id: "a", title: "Nacht", startTime: iso(2026, 8, 10, 22), endTime: iso(2026, 8, 11, 2), source: "google", }); assert.equal(segmentStartMinutes(first), 22 * 60); assert.equal(segmentEndMinutes(first), 24 * 60); }); });