| Time to display | Past | Future |
|---|---|---|
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 |
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
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.
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.
| Precision | Format |
|---|---|
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.