DateField

DateField(props): Element

Defined in: packages/ui/src/fields/date-field.tsx:64

Read-only display component that formats date values.

Accepts Date objects, ISO strings, or Unix timestamps. Renders a <time> element with the formatted date and a machine-readable datetime attribute. Returns an em-dash for null/undefined values and “Invalid date” for unparseable input.

Parameters

props

DateFieldProps

See DateFieldProps.

Returns

Element

A <time> element with the formatted date, or a placeholder <span>.

Example

<DateField value={post.createdAt} format="relative" />
// -> "3 days ago"

<DateField value="2026-03-11" format="short" locale="en" />
// -> "Mar 11, 2026"