Date Data
Description
Allows editing of dates with a date picker pop-up menu, or via keying in directly into the fixed format field.
See the Collecting and Displaying Data in a Structured Way guide as an example of how to use this macro.
Parameters
Name | Required | Available In | Migratable to Cloud? | Default Value | Description |
---|---|---|---|---|---|
[default] / name (Field Name) | Yes | Server, Data Center | No | The name of the date data field. Must be unique. | |
required | Yes | Server, Data Center | No | false/unchecked | If checked, this field cannot be empty. |
minDate (Minimum Date) | Optional | Server, Data Center | No | The minimum date that is allowed, format of date entered here must follow the format parameter. Default format is 'yyyy-MM-dd'. | |
maxDate (Maximum Date) | Optional | Server, Data Center | No | The maximum date that is allowed, format of date entered here must follow the format parameter. Default format is 'yyyy-MM-dd'. | |
format (Display Format) | Optional | Server, Data Center | No | yyyy-MM-dd | The format to display the date in. May contain any of the following special characters:
|
Notes
- Version 8.21.9 and below, the date and time is saved and viewed as server time.
- For version 8.22.0 and above, Date data macro will always save and display the date and time according to the user's timezone. When users from different timezone view the saved date and time, it will be displayed as per the viewers' timezone.
The default view for Date data macro will include the time zone. - Scaffolding Date Data macro body can accept keywords to pre-populate the datetime during input. Supported Keywords are:
Keyword
Description
Today / Now
The datetime when the Scaffolding editor is opened.
Yesterday
The datetime when the Scaffolding editor is opened -24 hours.
Tomorrow
The datetime when the Scaffolding editor is opened +24 hours.
- The keywords don’t save/set default values for the date data macro.
- They only work as suggested/default input when the editor is opened.
- The keyword datetime will only display during input for new/empty macros. Once a value has been saved/set for a date data macro, the keyword in the body of that same macro is ignored when the editor is opened the next time.
- Pre-populated date inputs use server time.
Tutorial Examples