Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Collects
The Date and DateTime steps are used for collecting dates, e.g. expiration or delivery dates - as well as a time for the DateTime step.
The user can change the value by selecting the date via a date-picker control.
Date versus DateTime
The Date and DateTime steps are very similar and differ only in the data format they expect for input and return the collected value in.
Those formats are as follows:
- Date: "dd-MM-yyyy"
- DateTime: "dd-MM-yyyy HH:mm:ss"
Mobile Configuration
The behaviour of the Date and DateTime steps can be controlled through these configuration parameters.
- inputType: Date
- defaultValue: By supplying this value the pre-filled date can be controlled. If omitted the step will display the current date. It must be in a valid date format, i.e. match the expected format for the Date and DateTime steps respectively.
From version 1.5.10 is is possible to leave the date field empty, forcing the user to select a date/datetime. This is done by blanking the default value as follows, defaultValue="". - format: N/A Legacy for Windows Mobile Embedded.
- minDate: The Registration Collector will only accept values on or after this date. By omitting this attribute the value will default to the minimum date defined by the operating system on the mobile device. Note, that this should also be Date-formatted on dateTime steps.
- maxDate: The Registration Collector will only accept values on or prior to this date. By omitting this attribute the value will default to the maximum date defined by the operating system on the mobile device. Note, that this should also be Date-formatted on dateTime steps.
- optional: From version 1.5.10 it is possible to set the Date and DateTime steps as optional, making the steps accept an empty value.
The configuration used to generate the above example is shown below. It does not make use of any restrictions.
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<add id="30" name="registrationDateTime" header="Registration Collector - DateTime" label="Registration time:" minDate="01-01-2021" maxDate="31-12-2154" helpLabel="Select the registration date and time." inputType="dateTime" defaultValue="09-02-2021 10:00:00"/> |
Example of DateTime Step with dummy values
Image Added
Example of the date picker