Date time display

The date time display component renders any aspect of a date or time in a large variety of formats.

Usage

Date time display is an ideal component for any time-based use-case. With the locale support offered via authoring, even relative date time strings are easily managed.

Example

Oct 2, 2026

Variations

Relative

Relative times give a general idea of a past or future event. This is the format most common in Pega applications. Examples of usage include conversations or object updates.

Show relative times in the user’s current time zone. The order of dates and months should be valid for that region. Use of a 12-hour or 24-hour clock should also be valid for that region.

Time to displayPastFuture

Under a minute

Now

Now

Under 1 hour

11m ago

In 11m

Today

8:43am

3:10pm

This year

Jan 15

Dec 23

Other years

Jan 15, 2017

Dec 23, 2035

Exact

Exact timestamps are detailed and very technical. Reserve them for things such as audits and detailed histories. Exact times will always include a time, and almost always a date.

If the application has an international audience, use the ISO-8601 standard (Y-M-D). If the application is for a specific region, use the region appropriate layout (M/D/Y for USA; D/M/Y for most others). If the application is for no particular region, use the application's current locale as the default.

PrecisionFormat

General usage

Dec 31, 2017 2:13pm

Audits and logs

2017-12-31 14:13:30

Exact timestamp

2017-12-31T22:30+04

For internationalized guidance on month abbreviations, Princeton has a decent overview of the variations.

Configuration

No configuration is needed for this component in Constellation.

All components shown on this site are supported by the Constellation design system. To learn how to configure Theme Cosmos, visit Pega Documentation.

Related components