Date

Date construction and accessors. Floe has no new keyword, so the Date module bridges the gap for creating JS Date objects and reading their fields.

Functions

Function	Signature	Description
Date.now	() -> Date	Current date and time
Date.from	(string) -> Date	Parse a date string
Date.fromMillis	(number) -> Date	Create from Unix milliseconds
Date.year	(Date) -> number	Full year (e.g. 2024)
Date.month	(Date) -> number	Month (1-12, 1-indexed!)
Date.day	(Date) -> number	Day of month (1-31)
Date.hour	(Date) -> number	Hour (0-23)
Date.minute	(Date) -> number	Minute (0-59)
Date.second	(Date) -> number	Second (0-59)
Date.millis	(Date) -> number	Unix timestamp in milliseconds
Date.toIso	(Date) -> string	ISO 8601 string

Examples

// Create dates
let now = Date.now()
let release = Date.from("2024-06-15")
let epoch = Date.fromMillis(0)

// Read fields with pipes
let year = release |> Date.year         // 2024
let month = release |> Date.month       // 6 (1-indexed, not 0!)
let day = release |> Date.day           // 15

// Convert to string or timestamp
let iso = now |> Date.toIso             // "2024-..."
let timestamp = now |> Date.millis      // 1718...

Date.month returns 1-12 (January = 1), unlike JavaScript’s getMonth() which returns 0-11. This fixes a common JS footgun.

For date arithmetic, formatting, and timezone handling, use npm libraries like date-fns via interop — the stdlib only covers construction and basic access.