Event management: fields, sorting, and availability.

Events come in two types:

  • Standard — fixed capacity with optional date
  • Daily — date-based booking with holiday exclusions

Functions

f
addDays(
dateStr: string,
days: number
): string

Add days to a YYYY-MM-DD date string

f
addMonthsIso(
fromIso: string,
months: number
): string

Add N months to an ISO timestamp, clamping to the last day of the target month. e.g. 2026-01-31 + 1mo → 2026-02-28 Preserves the time component (hour/minute/second/ms). Zero months returns the input with canonical ISO string formatting.

f
daysAgo(utcIso: string): number | null

Compute how many days ago an event started, relative to today in the configured timezone. Returns null if the event date is today or in the future, or if the date is empty/invalid. For past events, returns a positive integer (1 = yesterday).

f
eventDateToCalendarDate(utcIso: string): string | null

Convert a UTC ISO datetime to a YYYY-MM-DD calendar date in the given timezone. Returns null if the input is empty or invalid. Used by the calendar view to map standard event dates to calendar days.

f
formatDateLabel(dateStr: string): string

Format a YYYY-MM-DD date for display. Returns "Monday 15 March 2026"

f
formatDateRangeLabel(
startIso: string | null,
endIso: string | null
): string

Format a booking's stored [start_at, end_at) ISO range as a human label. 1-day bookings collapse to formatDateLabel; multi-day bookings use the compact English range formatter (inclusive — subtracts 1 day from end_at, which is the first midnight after the booked window).

f
formatDateRangeLabelCompactEn(
startDateStr: string,
endDateStr: string
): string

Compact English date-range formatter. Uses an en dash (–) for ranges.

f
formatDatetimeLabel(iso: string): string

Format an ISO datetime string for display in the given timezone. Returns e.g. "Monday 15 June 2026 at 14:00 BST"

f
formatDatetimeShort(iso: string): string

Compact ISO datetime formatter for table cells. Returns e.g. "07/04/2026 14:00" in the configured timezone.

f
getAvailableDates(
event: Event,
holidays: Holiday[]
): string[]

Compute available booking dates for a daily event. Filters by bookable days of the week and excludes holidays. For events with duration_days > 1, excludes start dates whose full range would hit a non-bookable day or extend past the booking window. Returns sorted array of YYYY-MM-DD strings.

f
getNextBookableDate(
event: Event,
holidays: Holiday[]
): string | null

Get the next available booking date for a daily event. More efficient than getAvailableDates()[0] — stops at first match. Returns null if no bookable dates are available.

f
mergeEventFields(fieldSettings: EventFields[]): EventFields

Determine which contact fields to collect for multiple events. Returns the union of all field settings, sorted by canonical CONTACT_FIELDS order.

f
normalizeDatetime(
value: string,
label: string
): string

Normalize datetime-local "YYYY-MM-DDTHH:MM" to full UTC ISO string. The input is interpreted as local time in the given timezone and converted to UTC.

f
parseEventFields(fields: EventFields): ContactField[]

Parse a comma-separated fields string into individual ContactField names

f
sortEvents<T extends Event>(
events: T[],
holidays: Holiday[]
): T[]

Sort events in unified 3-tier order. Works with any Event subtype (Event, EventWithCount, etc.).

f
startOfHour(date: Date): Date

Round a date down to the start of the current hour for cache-stable signatures

f
withRequiredEmail(fields: EventFields): EventFields

Ensure "email" is included in an event fields setting

Interfaces

Variables

Usage

import * as mod from "docs/events.ts";