/** * Converts a datetime-local input value (local time, no timezone info) * to a UTC ISO string for server submission. * * `datetime-local` inputs use the format "YYYY-MM-DDTHH:MM" and do NOT accept * ISO strings with a timezone designator (e.g. "2026-03-11T17:00:00.000Z"). * Setting an ISO UTC string directly on a datetime-local input causes the browser * to silently clear the field value. Use this function with a separate hidden input * to hold the converted UTC value before form submission. * * Returns null when value is empty, nullish, or not a valid date. * * NOTE: The returned ISO string (e.g. "2026-03-11T17:00:00.000Z") is intentionally * incompatible with datetime-local inputs, which only accept "YYYY-MM-DDTHH:MM". * Setting a Z-suffixed string on a datetime-local input causes browsers to silently * clear the field. Always write the result to a separate hidden input, not back to * the datetime-local input itself. */ import { format, parseISO } from "date-fns"; /** * Format a YYYY-MM-DD date string for display (e.g. "Apr 9"). * Returns null when the value is missing or unparseable — callers decide how to handle that case. */ export function formatEventDate(dateStr: string | null | undefined): string | null { if (!dateStr) return null; try { return format(parseISO(dateStr), "MMM d"); } catch { return null; } } /** * Produces a stable sort key for upcoming calendar events. * * Bracket events carry a full ISO game timestamp in `earliestGameTime`; all-compete * events (auto racing, golf) use the ISO timestamp in `earliestGameTime` when a start * time has been set, or fall back to the date-only `eventDate` string. Events with * neither sort to the far future so they appear last. * * The mixed comparison of ISO timestamps and "YYYY-MM-DD" strings works correctly via * lexicographic order because both share the same date prefix; a date-only string always * sorts before a same-day timestamp (shorter string < longer string with "T" suffix). */ export function toEventSortKey(e: { eventDate: string | null; earliestGameTime: string | null; }): string { return e.earliestGameTime ?? e.eventDate ?? "9999-12-31"; } export function localDateTimeToUtcIso(value: string | null | undefined): string | null { if (!value) return null; const date = new Date(value); if (isNaN(date.getTime())) return null; return date.toISOString(); }