StructuredDate

A pre-parsed human-friendly representation of a date and time.

Fields

Field	Type	Required	Description
date	\{ /** Full format, e.g., "Tuesday, October 3". */ EEEEMMMMd: string; /** Short weekday/month/day, e.g., "Tue, Oct. 3". */ EEEMMMd: string; /** Long date format, e.g., "Tuesday, October 3, 2023". */ long: string; /** Short numeric format, e.g., "10/03/2023". */ short: string; \}	✓	Formatted date strings.
time	string	✓	Time string (e.g., “3:00 PM”).
utc	string	✓	UTC timestamp (e.g., “2006-10-25T12:00:00Z”).
timezone	string	✓	IANA timezone (e.g., “America/New_York”).
local	string	✓	Local timestamp (e.g., “2006-10-25T12:00:00-04:00”).
upcoming	boolean	✓	Whether this date is in the future.
duration	\{ days: number; hours: number; minutes: number; weeks: number; months: number; \}	✓	Duration details from now to the date.