Props
| Prop | Type | Default | Notes |
|---|---|---|---|
date | string | '' | |
format | long | short | narrow | long | |
numeric | auto | always | auto | |
live | boolean | false |
StellarUI
<stellar-relative-time>
Localized relative-time formatter with optional live updates.
Properties
Preview
Markup
<stellar-relative-time date="2024-01-01T12:00:00.000Z"></stellar-relative-time>API
Complete props, events, slots, and implementation notes for the shipped relative-time formatter.
Events
| Event | Source | Notes |
|---|---|---|
| custom events | none | stellar-relative-time is display-only and does not emit custom events. |
Slots
| Slot | Notes |
|---|---|
| none | This component has no slots. It renders one semantic <time> element. |
Notes
- The public tag is `stellar-relative-time`, and it keeps the shipped surface: `date`, `format`, `numeric`, and `live`.
- It renders one semantic `<time>` element using the platform `Intl.RelativeTimeFormat` API.
- `date` accepts ISO 8601 strings in markup, while the host `.date` property also accepts a `Date` object.
- When `live` is true, all connected instances share one timer and update together once per second instead of each component scheduling its own interval.
- `lang` on the host changes the formatter locale; otherwise the component falls back to the document language and then the browser locale.