Function: a!dateTimeField()
Displays and allows entry of a single date and time (year, month, day, hour, minute, second). When the field is editable, users can input dates by typing or by picking from a calendar and then select the time from a dropdown. The date and time is shown in the current user's time zone and calendar format.
When working with a date (year, month, day), use a date component. To display a time (hour, minute, second), use a time component. To display a read-only date and time using a custom format, use a text component.
Name | Keyword | Types | Description |
---|---|---|---|
Label |
|
Text |
Text to display as the field label. |
Instructions |
|
Text |
Supplemental text about this field. |
Required |
|
Boolean |
Determines if a value is required to submit the form. Default: false. |
Read-only |
|
Boolean |
Determines if the field should display as not editable. Default: false. |
Disabled |
|
Boolean |
Determines if the field should display as potentially editable but grayed out. Default: false. |
Display Value |
|
Date and Time |
Date and time to display in the field. |
Validations |
|
List of Text String |
Validation errors to display below the field when the value is not null. |
Save Input To |
|
List of Save |
One or more variables that are updated with the date and time when the user changes it. Use a!save() to save a modified or alternative value to a variable. |
Validation Group |
|
Text |
When present, this field is only validated when a button in the same validation group is pressed. See the documentation for more information about how to use validation groups. |
Required Message |
|
Text |
Custom message to display when the field's value is required and not provided. |
Label Position |
|
Text |
Determines where the label appears. Valid values:
|
Help Tooltip |
|
Text |
Displays a help icon with the specified text as a tooltip. The tooltip displays a maximum of 500 characters. The help icon does not show when the label position is |
Accessibility Text |
|
Text |
Additional text to be announced by screen readers. Used only for accessibility; produces no visible change. |
Visibility |
|
Boolean |
Determines whether the component is displayed on the interface. When set to false, the component is hidden and is not evaluated. Default: true. |
Notes
Copy and paste an example into the INTERFACE DEFINITION in EXPRESSION MODE to see it displayed.
Date and Time with Only a Label
1
2
3
4
5
=a!dateTimeField(
label: "Created On",
value: datetime(2013, 1, 12, 11, 20),
readOnly: true
)
Displays the following:
Date and Time with a Validation
1
2
3
4
5
6
7
8
9
10
11
12
13
=a!localVariables(
local!storedValue:now()-1,
a!dateTimeField(
label: "Meeting Date and Time",
value: local!storedValue,
saveInto: local!storedValue,
validations: if(
local!storedValue <= now(),
"Please schedule a meeting for a future date and time",
""
)
)
)
Displays the following: