Skip to main content
CYPEX Documentation
Support
v2.0.0 Latest stable release View changelog ->
Various Referencegenerated

Date Time Field

Display a date and time value

Technical id
default_date_time_field

A read-only typography block formatting timestamps into absolute patterns or descriptive human-readable relative timelines.

When to use

  • Presenting a read-only date, timestamp, or temporal string formatted cleanly for user viewports.
  • Displaying historical records or future milestone markers utilizing relative time statements (e.g., ‘6 years ago’).

What you need

  • ISO timestamps, Date objects, or string representations processed dynamically via custom expressions.

Examples

  • Displaying a record creation timestamp as ‘dd.MM.yyyy HH:mm’.
  • Rendering audit track histories using relative phrase transformations like ‘3 days ago’.

Avoid

  • Attempting to capture or mutate dates, use input-based date selectors instead.
  • Enabling both ‘Is Relative’ and specialized absolute ‘Custom’ formats simultaneously, as relative processing completely overrides layout format specifiers.

Editor properties

Configure these in the Application Designer property panel. Group headings mirror the editor where possible. Data Source is where the element gets its rows or field binding (a view/query, a connector operation, or a parent form field). References appear only for view-backed sources and map foreign-key ID columns to readable labels from another view.

Date Time
ValuerequiredCustom expression
The timestamp to display. Accepts a date-time string or an expression.
Example 2020-01-01T00:00
Default: 01/01/2020 00:00:00
Show Date PartoptionalYes / no
Boolean toggle controlling whether the day, month, and year parts are integrated into the output display.
Default: true
Show Time PartoptionalYes / no
Boolean toggle controlling whether hours, minutes, and seconds parameters are integrated into the output display.
Default: true
Format StringoptionalCustom expression (text)
Format pattern for the displayed date/time (platform presets or a custom token string such as dd.MM.yyyy HH:mm).
Default: none
TimezoneoptionalCustom expression
Expression input box targeting specific timezone offsets. Initialized to null by default.
Example null
Default: none
Formatting
Is RelativeoptionalYes / no
Boolean toggle transforming absolute timestamps into human-centric sentences describing elapsed intervals (e.g., ‘over 6 years ago’).
Default: none

Sizing

  • No size of its own: dropped at the platform default of 1 × 1 grid cells and resized on the page.

Accessibility

Renders as standard semantic text layers. Utilizes raw layout string formats to offer unambiguous temporal interpretations to screen readers.

Where you can place it

Drag this element into one of these containers:

1
2
3
4
5
{
  "config": {
    "value": "@@expression:'value'"
  }
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
  "config": {
    "value": "@@expression:'value'",
    "isRelative": false,
    "showDatePart": false,
    "showTimePart": false,
    "timezone": "@@expression:'value'",
    "formatString": "@@expression:'value'"
  }
}