Date & Time Field
The Date & Time special field is a combination field which prompts the user to enter both a date and a time. It's useful, for example, if you are designing a form for events that have a occur at a particular date and time.
In this topic, we cover the general properties for this element. Learn about other properties in the Introduction to Validation and Layout Basics.
Property | Description |
---|---|
Field Name | This is the name used to reference the field and is also the name of the column heading in the submission bin. |
Hour Text | Enter the text to display after the hour picker. |
Min Text | Enter the text to display after the minute picker. |
Minute Increment | Specify the increment for the minutes. |
ChangeYear | By default, the calendar restricts movement sequentially-month by month. Set this value to true to allow the user to jump to a specific year. |
ChangeMonth | By default, the calendar restricts movement sequentially-month by month. Set this value to true to allow the user to jump to a specific month. |
Min Date | Set the earliest date that the user may choose. Use this property together with the Max Dateproperty to set the range of dates available.
Note: You can specify the minimum date as a date string (e.g mm/dd/yyyy) or as a numeric offset from today (-20), or as a string of periods and units ('+1M +10D'). For the last, use 'D' for days, " + 'W' for weeks, 'M' for months, or 'Y' for years. If you have changed the forms locale setting, and are using a date string literal, you need to use the same date format as dictated by the locale settings. |
Max Date | Set the latest/maximum date that the user may choose. Use this property together with the Min Date property to set the range of dates available. Note: You can specify the max date as a date string (e.g mm/dd/yyyy) or as
a numeric offset from today (-20), or as a string of periods and units ('+1M +10D'). For the last, use 'D' for days, " + 'W' for weeks, 'M' for months, or 'Y' for years. If you have changed the forms locale setting, and are using a date string literal, you need to use the same date format as dictated by the locale settings. |
Months To Show | Specify the number of months to display (side-by-side) in the pop-up. |
Tooltip | Enter a short help comment to display nearby when the user hovers over the element. |
Caption | Enter the caption text, which appears either beside or above the element. |
Multi-line Caption | When the caption wraps, you may notice the line height is wrong. This is when you need to enable the multi-line feature by setting this property to true. Note: Keep in mind that you can increase the caption width so that the caption text does not wrap. |
Admin Caption | This is the caption to use when viewing data via the submission bin record detail window. When left blank, the original caption is used instead. |
Defaultvalue | Default Date values must be entered in this format "mm/dd/yyyy" unless you have changed the default locale setting in which case the format should be specific to the selected locale (for example, if "English (UK)" is selected for the locale, the the date format would be 'dd/mm/yyyy'). The time value should follow the date in 12 hour clock format (e.g "12:00 PM"). For example to format a date/time value using the default locale settings you would enter "05/30/2012". |
Theme | Set this property to Inherit to use the Field SubTheme defined by the master theme for this form. Or, select a subTheme which will apply directly to this element. Once a subTheme is applied, you can edit it within the ThemeEditor. Learn more in Themes & Styles. |
Dependency | Create a dependency to hide or show this element based on a rule. The field becomes "dependent" on other values entered on the form. Learn more in Dependencies. |
Hidden | Set this property to true if you want this element to be hidden. |
Hide Mode | This property determines how the element is hidden and if it will collapse within the space it would otherwise occupy. |
0 Comments