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

Default Interval Field

Display time interval

Technical id
default_interval_field

A read-only single row duration string that outputs individual segmented time measurements separated by unit letters based on configuration toggles.

When to use

  • Displaying specific time durations or elapsed period chunks (e.g., ‘3y, 5m, 3d’) cleanly in the interface.
  • Rendering structured ISO 8601 duration intervals parsed from technical database columns into human-readable segmented blocks.

What you need

Accepts a raw ISO 8601 interval duration text string (e.g., ‘P3Y5M3DT3H3M3S’) or an expressional codebase script returning equivalent data logs. Alternatively can be hardcoded manually using individual numeric inputs across six chronological time parameter buckets.

  • Standard ISO duration format strings, interval objects, or mathematical difference summaries processed via expression lines.

Examples

  • Displaying a product warranty duration line structured from an interval data column.
  • Showing the exact computed processing time length down to the second using localized unit toggles.

Avoid

  • Using for single point-in-time stamps or calendar dates, use the date_time_field component instead.
  • Leaving all time unit switches turned off, which causes an empty text line output rendering in the layout grid cell.

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.

Value
ValuerequiredCustom expression
A standard duration code text box value mapped directly from database paths or expressions.
Example P3Y5M3DT3H3M3S
Default: P0Y0M0DT0H0M0S
Formatting
Display ConfigrequiredList of One of: years, months, days, hours, minutes, seconds
Array of units to display in the read-only interval output.
Default: Object.keys(defaultBounds())

Sizing

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

Accessibility

Renders as raw flat semantic text layout blocks. Screen reader screen gear translates time segment letters directly to ensure logical temporal readings.

Where you can place it

Drag this element into one of these containers:

1
2
3
4
5
6
7
8
{
  "config": {
    "value": "@@expression:'value'",
    "displayConfig": [
      "years"
    ]
  }
}

Ready-made setups

Configuring a clean interval field that isolates and highlights strictly years, months, and days parameters from an explicit data string statement.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
  "config": {
    "value": "P3Y5M3DT3H3M3S",
    "displayConfig": [
      "years",
      "months",
      "days"
    ]
  }
}