NV Elements Catalog Starters Repo System Themes Getting Started Getting Started Installation CLI MCP Skills Lint Integrations Getting Started Angular Bundles CDN Custom Elements Golang Hugo Import Maps Lit Lit Library MCP Apps NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue About Changelog Metrics Support Accessibility Contributions Requests Migration Foundations Overview Typography Iconography Themes Design Tokens Size & Space Objects Interactions Support Status Color Animation Fonts Layers Custom Layout Horizontal Vertical Grid Popovers i18n Visualization View Transitions Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Color Combobox Copy Button Datagrid Integrations Column Action Column Alignment Column Fixed Column width Container Card Display Settings Footer Heatmap Keynav Multi Select Pagination Panel Detail Panel Grid Performance Placeholder Row Action Row Groups Row Sort Scroll Height Single Select Stripe Date Datetime Dialog Divider Dot Drawer Dropdown Dropdown Group Dropzone File Format Datetime Format Number Format Relative Time Forms Validation Actions Control Icon Icon Button Input Input Group Logo Menu Month Notification Page Page Header Page Loader Pagination Progressive Filter Chip Progress Bar Progress Ring Password Preferences Input Pulse Radio Range Resize Handle Search Select Skeleton Sort Button Sparkline Star Rating Steps Switch Tabs Tag Textarea Time Toast Toggletip Toolbar Tooltip Tree Week Patterns Authentication Browse Chat Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend Code Codeblock Monaco Input Diff Input Editor Diff Editor Problems Markdown Markdown CSS Utility Labs Responsive Layout Viewport Container Patterns Forms API Design Properties & Attributes Slots Registration CustomEvents Stateless Composition Styles Packaging Glossary Logs Internal Guidelines Agent Harness Agent Tooling Agent Ownership Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Format Relative Time

beta:  2.0.1 Coverage: 94.11% Bundle: 10kb Lighthouse: 100 Axe Core Released: 0.0.0
Overview API Examples
DefaultNumericFormatStyleUnitLocaleDateAttributeSync

Default

2020-01-15T12:00:00.000Z 2024-06-15T12:00:00.000Z 2025-12-01T12:00:00.000Z
Edit Example

Formats a date/time value as localized relative text using the Intl.RelativeTimeFormat API. Renders inside a semantic time element. Options mirror the Intl.RelativeTimeFormat API. When unit is 'auto', the component selects the best unit based on the time difference.

Numeric

2025-01-15T12:00:00.000Z 2025-01-15T12:00:00.000Z
Edit Example

Numeric formatting: 'always' | 'auto'. When 'auto', enables natural language forms such as 'yesterday' instead of '1 day ago'.

Numeric Description always auto

Format Style

2020-01-15T12:00:00.000Z 2020-01-15T12:00:00.000Z 2020-01-15T12:00:00.000Z
Edit Example

Formatting length: 'long' | 'short' | 'narrow'. Controls verbosity (such as '3 days ago' vs '3d ago'). Maps to Intl.RelativeTimeFormat style option.

FormatStyle Description long short narrow

Unit

2020-01-15T12:00:00.000Z 2020-01-15T12:00:00.000Z 2020-01-15T12:00:00.000Z
Edit Example

Time unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year' | 'auto'. Use 'auto' to let the component select the most appropriate unit based on the time difference.

Unit Description second minute hour day week month year auto

Locale

2020-01-15T12:00:00.000Z 2020-01-15T12:00:00.000Z 2020-01-15T12:00:00.000Z
Edit Example

Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default.

Locale Description string default

Date Attribute

Edit Example

Date attribute input for values supplied by JavaScript or bound data. By default, the component formats text content, which also serves as the SSR fallback, and date wins when both are present.

Sync

2020-01-15T12:00:00.000Z
Edit Example

When present, auto-updates the displayed relative time at appropriate intervals.

Sync Description true false