Components / Timestamp
Timestamp
Renders a point in time as relative ("2h ago") or absolute text inside a semantic <time> element, auto-refreshing relative values when live.
data-displayv0.8.0
Playground
Examples
Relative (live)
<cg-timestamp datetime="2026-07-03T09:00:00Z" live></cg-timestamp>Absolute datetime
<cg-timestamp datetime="2026-07-03T09:00:00Z" format="datetime"></cg-timestamp>Date only
<cg-timestamp datetime="2026-07-03T09:00:00Z" format="date"></cg-timestamp>Import
import { CgTimestamp } from '@cognivo/components';// Or tree-shake: import '@cognivo/components/cg-timestamp';Per-component imports ship only that component (~8 kB gzip).
API Reference
| Prop | Type | Default | Description |
|---|---|---|---|
datetime | string | "" | ISO 8601 string or epoch ms |
format | "relative" | "datetime" | "date" | "time" | "relative" | Display mode |
live | boolean | false | Auto-refresh relative value every 60s |