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.
<nve-format-datetime date-style="long">2023-07-28T04:20:17.434Z</nve-format-datetime>
2023-07-28T04:20:17.434Z
Installation
<script type="module">
import '@nvidia-elements/core/format-datetime/define.js';
</script>
<nve-format-datetime date-style="long">2023-07-28T04:20:17.434Z</nve-format-datetime>
nve api.get nve-format-datetime
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.
<nve-format-datetime date-style="long">2023-07-28T04:20:17.434Z</nve-format-datetime>
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.
<div nve-layout="column gap:sm">
<nve-format-datetime date-style="full">2023-07-28T04:20:17.434Z</nve-format-datetime>
<nve-format-datetime date-style="long">2023-07-28T04:20:17.434Z</nve-format-datetime>
<nve-format-datetime date-style="medium">2023-07-28T04:20:17.434Z</nve-format-datetime>
<nve-format-datetime date-style="short">2023-07-28T04:20:17.434Z</nve-format-datetime>
</div>
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.
<div nve-layout="column gap:sm">
<nve-format-datetime date-style="long" time-style="long">2023-07-28T04:20:17.434Z</nve-format-datetime>
<nve-format-datetime date-style="short" time-style="short">2023-07-28T04:20:17.434Z</nve-format-datetime>
</div>
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.
<div nve-layout="column gap:sm">
<nve-format-datetime weekday="long" month="short" day="numeric" year="numeric"
>2023-07-28T04:20:17.434Z</nve-format-datetime
>
<nve-format-datetime month="long" year="numeric">2023-07-28T04:20:17.434Z</nve-format-datetime>
</div>
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.
<div nve-layout="column gap:sm">
<nve-format-datetime hour="numeric" minute="2-digit">2023-07-28T04:20:17.434Z</nve-format-datetime>
<nve-format-datetime hour="2-digit" minute="2-digit" second="2-digit">2023-07-28T04:20:17.434Z</nve-format-datetime>
</div>
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.
<div nve-layout="column gap:sm">
<nve-format-datetime locale="de-DE" date-style="long">2023-07-28T04:20:17.434Z</nve-format-datetime>
<nve-format-datetime locale="ja" date-style="long">2023-07-28T04:20:17.434Z</nve-format-datetime>
<nve-format-datetime locale="fr-FR" date-style="long">2023-07-28T04:20:17.434Z</nve-format-datetime>
</div>
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.
<nve-format-datetime date="2023-07-28T04:20:17.434Z" date-style="long"></nve-format-datetime>
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.
<div nve-layout="column gap:sm">
<nve-format-datetime date-style="long" time-style="long" time-zone="America/New_York"
>2023-07-28T04:20:17.434Z</nve-format-datetime
>
<nve-format-datetime date-style="long" time-style="long" time-zone="Asia/Tokyo"
>2023-07-28T04:20:17.434Z</nve-format-datetime
>
</div>
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.
<div nve-layout="column gap:sm">
<nve-format-datetime
locale="en-US"
month="long"
day="numeric"
year="numeric"
hour="numeric"
minute="2-digit"
time-zone="America/New_York"
time-zone-name="short"
>2023-07-28T04:20:17.434Z</nve-format-datetime
>
<nve-format-datetime
locale="en-US"
month="long"
day="numeric"
year="numeric"
hour="numeric"
minute="2-digit"
time-zone="America/New_York"
time-zone-name="long"
>2023-07-28T04:20:17.434Z</nve-format-datetime
>
</div>
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