Time visibility

See also: Date visibility

Actions – Abstract

The Time visibility action displays or hides the time in a Date/Time element at runtime. This element can also be a component in a Date range.

The Time visibility action displays or hides the time in a Date/Time element at runtime. This element can also be a component in a Date range.

images/download/attachments/189436769/image-2024-11-5_10-21-18-version-1-modificationdate-1730798477510-api-v2.png

  • A Target element of the type Date/Time must be linked so that the action appears under Action type.

  • The Display time option determines whether the date is displayed (checked) or hidden (unchecked).

►NOTE◄ If the date of a Date/Time element is not displayed when the time input area is hidden, the element only contracts to a minimum width. However, it remains relevant for validation. If the element uses the Required field option or if Validators are configured, they will continue to be evaluated although interactive access is no longer possible. If the validation triggers information texts, the field is automatically displayed wide enough for them to be readable.

Example

A portal is used in the field of 'intralogistics' to organize the collection of material. The individual 'pick-up orders' are initially only scheduled by date. The time when the material will be 'Ready for pick-up' is specified later. As long as the time is set to '00:00' in the Date/Time element, it should be considered 'undefined'. Then, no time should be displayed in the element and instead a Button labeled tbd (to be determined, i.e. 'not yet defined') should appear next to it. Clicking this Button, should make the time reappear in the Date/Time element so that a value other than 00:00 can be entered.

Runtime example:

images/download/attachments/189436769/image2020-6-10_15-30-6-version-1-modificationdate-1730798369169-api-v2.png

Configuration:

images/download/attachments/189436769/image-2024-11-5_12-7-17-version-1-modificationdate-1730804836919-api-v2.png

Two behaviours are set up for the Date/Time element as shown on the left:

  • The first behaviour ('timeTBD') is not shown in detail here. It contains no actions and only checks if the value of the Date/Time element contains a time (<>00:00:00.0000). The check result is polled by a Logical condition in the second behaviour ('dateTimeSpecial').

  • The 'dateTimeSpecial' behaviour is triggered by the Triggering events Changed and Focus out, so that in these cases the layout around the Date/Time element is adjusted according to its value, as desired.

  • The Behaviour type Logical condition refers to the check from the behaviour 'timeTBD', which is only passed, if the date value of the executing element does not indicate a time (different from 00:00:00.000).

  • The Actions on 'true' are executed if the time is 'undefined'. Specifically, the Show element action displays the tbd Button and the time in the Target element is hidden by Time visibility (with the option Display time not set).

  • If a time (<>0 o'clock) is specified, the Actions on 'false' are executed. Specifically, the Hide element hides the tbd Button and the time is displayed in the Target element by Time visibility (with the option Display time set).

    ►NOTE◄ These actions are also configured for the behaviour that is triggered when you click the 'Today' Button. No details are given here.