Duration

Duration is a gh-element that allows to set some time value. When the user clicks on the field, a Time Picker window opens. There the user can enter their value or select it.

It is an element that is much more useful together with other elements such as Table, Schedule, Date, Smart Input, and others, or when used in automation chains than on its own.

Time Picker

This is the pop-up window that allows users set the value of the field. It consists of two fields for entering hours and minutes and two buttons.

When the Show Seconds option is enabled, three input fields are displayed.

So, the input fields are designed for entering different types of time values. That is, there are separate input fields for hours, minutes, and seconds. At the same time, each of them has separate buttons that allow you to adjust the value by one for hours and seconds and by 5 units for minutes.

There only two buttons in the Time Picker:

• Clear - allows user to clear the field
• Close - allows the user to close the picker while saving the value

All these options allow the user to work comfortably with the current element.

Functional Characteristics

This gh-element has several different types of use. This element can be used to save any time or duration of any events. For example, it can be the length of a movie in the user's movie list or the duration of events in their schedule.

The Duration element also allows you to configure some of others gh-element. This includes a table and a schedule.

In addition, like other gh-elements that store values, it can be used in automation processes. For example, use it with the Date and Smart Input elements to track the duration of tasks. You can configure them so that when user clicks on the Smart Input button, the start and end dates of the task are stored in the Date element. Then the automation will calculate the difference between the start and end time of the task, which will then be stored in the Duration element.

Element Options

Duration has two type of settings. Despite that, it has not a big number of options.

Field Settings

Duration field settings only contains standard options: Field Name and Name Space.

Show seconds

The Duration element usually accept and displays only hour and minute values. But this option adds an additional field to time picker if enabled. That allows user to enter seconds to its value. Accordingly, the seconds will be displayed in the element.

This allows you to configure how precisely you need to record the time.

Default Value Settings

As you may have gathered, you can set a default value for duration element. These settings will help you.

Use Default Value

The first setting of this block allows you to determine whether the default value will be available or not. This is a switch, so if it is enabled, the default value will be used when creating an item. In turn, the value can be entered in the next setting, which appears if you enable the Use default values option.

Default value

This is a setting that allows you to enter the default value for the current field. This means that the duration field will be filled with this value if it is empty when the item is created.

Regardless of whether the default value is entered or not, it will not be used if Use Default Value is disabled.

In addition, this option is not displayed unless Use Default Value is enabled.

Element Style

The style of duration element can be configured with the help of standard options about that you can read in Setting Overview. Also, read about interpretation below.

Filtration

The duration element can be filtered out by filters what compare full values:

• Equals
• Not equals
• Is bigger than
• Is lower than
• Value

Interpretation

There are only two interpretations for this element.

Default

This one allows to update duration value with the help of time picker which appears after clicking on the field.

Plain Text

The interpretation allows to display the set value and does not update it.

Value

This type allows you to display an uninterpreted value of the element.

Value Format

The duration value is the set time in milliseconds. In application it is saved as a string type data.

{
    "field_value": "900000"
}

User can enter the value with the help of Time Picker.

Data Model

The data model of this element contains only values of default options and interpretations, so it is quite simple.

{
    "data_model":{
        "default_value": "any default value",
        "interpretation": [],
        "use_default_value": false
    }
}