NV Elements Catalog Starters Repo System Themes About Getting Started Changelog Metrics Support Accessibility Contributions Requests Migration Integrations Installation MCP CLI Lint Angular Bundles Extensions Golang Hugo Import Maps Lit NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue Foundations 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 Panel 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 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 Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Format Datetime

beta:  0.1.1 Coverage: unknown Bundle: 10kb Lighthouse: 100 Axe Core Released: 0.0.0
Overview API Examples

Formats a date/time value as localized text using the Intl.DateTimeFormat API. Renders inside a semantic time element. Granular options (weekday, year, month, day, hour, minute, second) mirror the Intl.DateTimeFormat API. 'numeric' omits zero-padding, '2-digit' zero-pads.

2023-07-28T04:20:17.434Z

Installation


    

    
CLI / MCP

By default, the component formats the date string from its text content. That text also serves as the SSR fallback. Use the date property or attribute when the value already comes from JavaScript or bound data. If both are present, date wins.

Preset date-style and time-style options take precedence over granular date and time part options. Treat time-zone-name as a granular option and use it only when preset styles are absent.

Date Style

Basic date formatting with the long date style preset. Use for displaying human-readable dates in content areas, tables, or metadata.

2023-07-28T04:20:17.434Z

Date style presets for controlling output density. Use full or long for detail-rich contexts and medium or short for compact layouts like data tables or cards.

2023-07-28T04:20:17.434Z 2023-07-28T04:20:17.434Z 2023-07-28T04:20:17.434Z 2023-07-28T04:20:17.434Z

Time Style

Combined date and time style presets for full timestamps. Use for audit logs, event schedules, or activity feeds that need both date and time. Preset styles take precedence over granular formatting options when both appear.

2023-07-28T04:20:17.434Z 2023-07-28T04:20:17.434Z

Granular

Granular date part options for precise formatting control. Use when presets don't match your layout, such as weekday and month only. Do not combine with date-style or time-style; style presets take priority if both appear.

2023-07-28T04:20:17.434Z 2023-07-28T04:20:17.434Z

Time Only

Time-only formatting with granular hour, minute, and second options. Use for clocks, time labels, or timestamps where the date is unnecessary.

2023-07-28T04:20:17.434Z 2023-07-28T04:20:17.434Z

Locale

Explicit locale settings for internationalized date output. Use when the target audience locale differs from the browser default, such as multilingual dashboards or region-specific reports.

2023-07-28T04:20:17.434Z 2023-07-28T04:20:17.434Z 2023-07-28T04:20:17.434Z

Date Attribute

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.

Time Zone

Time zone conversion for displaying dates in a specific region. Use for global teams, scheduling interfaces, or when UTC or server timestamps need a fixed time zone.

2023-07-28T04:20:17.434Z 2023-07-28T04:20:17.434Z

Time Zone Name

Time zone name labels in short and long form alongside the formatted date. Use with granular options when the viewer needs to know which time zone applies, such as meeting schedulers or cross-region dashboards.

2023-07-28T04:20:17.434Z 2023-07-28T04:20:17.434Z

Release Status

All elements and features go through 3 phases of stability, pre-release, beta and stable.

pre-release
Docs Preview API Documentation Fully Themeable
beta
Robust unit test coverages Passed API Review Passed Designer VQA Review Included in library package
stable
No known outstanding AA WCAG issues No known outstanding performance issues Adapts to different screen/container sizes No breaking API changes for at least 90 days