Usage
Time pairs a machine-readable dateTime with a human-readable label, so a visible date or time stays perceivable by assistive tech and structured-data tooling. It carries no typography or visual styling of its own.
<time> element would otherwise be reached for directly.Text around Time, since Text has no as/asChild escape hatch and cannot render <time> itself.Time is a single, unstyled wrapper - it does not offer size, color, or weight variants.
A <time> element carrying the dateTime attribute, the forwarded className, and a forwarded ref. children is the visible, human-readable label.
dateTime should be a valid machine-readable instant, e.g. an ISO 8601 timestamp, and should correspond to the same moment the visible label describes.children should be the localized, human-readable label already formatted for the product's date/time conventions - Time does not format or localize its content.Time is not interactive and has no states.
dateTime and the visible label describing the same instant - a mismatch misleads assistive tech and structured-data consumers even when the visible text looks correct.Text around Time when the label needs typography.Time for a value that has no underlying machine-readable instant - use Text/Text instead.Time - wrap it instead of styling it.children is what assistive tech announces; the dateTime attribute is not read aloud, so the label alone must convey the meaning.