Back
dateTimeSelectTags()
Name | Type | Required | Default | Description |
---|---|---|---|---|
name | string | Yes | Name to populate in tag's name attribute. | |
selected | string | No | Value of option that should be selected by default. | |
dateOrder | string | No | month, day, year | Use to change the order of or exclude date select tags. |
dateSeparator | string | No | [see:dateTimeSelect]. | |
startYear | numeric | No | 2012 |
First year in select list.
|
endYear | numeric | No | 2022 |
Last year in select list.
|
monthDisplay | string | No | names | Pass in names, numbers, or abbreviations to control display. |
monthNames | string | No | January, February, March, April, May, June, July, August, September, October, November, December | [see:dateSelect]. |
monthAbbreviations | string | No | Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec | [see:dateSelect]. |
timeOrder | string | No | hour, minute, second | Use to change the order of or exclude time select tags. |
timeSeparator | string | No | : | Use to change the character that is displayed between the time select tags. |
minuteStep | numeric | No | 1 | Pass in 10 to only show minute 10, 20, 30, etc. |
secondStep | numeric | No | 1 | Pass in 10 to only show seconds 10, 20, 30, etc. |
separator | string | No | - | Use to change the character that is displayed between the first and second set of select tags. |
includeBlank | any | No | false | Whether to include a blank option in the select form control. Pass true to include a blank line or a string that should represent what display text should appear for the empty value (for example, "- Select One -"). |
label | string | No | The label text to use in the form control. | |
labelPlacement | string | No | around | Whether to place the label before, after, or wrapped around the form control. Label text placement can be controlled using aroundLeft or aroundRight. |
prepend | string | No | String to prepend to the form control. Useful to wrap the form control with HTML tags. | |
append | string | No | String to append to the form control. Useful to wrap the form control with HTML tags. | |
prependToLabel | string | No | String to prepend to the form control's label. Useful to wrap the form control with HTML tags. | |
appendToLabel | string | No | String to append to the form control's label. Useful to wrap the form control with HTML tags. | |
combine | boolean | No | Set to false to not combine the select parts into a single DateTime object. | |
twelveHour | boolean | No | false | whether to display the hours in 24 or 12 hour format. 12 hour format has AM/PM drop downs |
encode | any | No | true |
When set to true , encodes tag content, attribute values, and URLs so that Cross Site Scripting (XSS) attacks can be prevented. Set to attributes to only encode attribute values and not tag content.
|
<!--- This "Tag" version of the function accepts a `name` and `selected` instead of binding to a model object---> #dateTimeSelectTags(name="dateTimeStart", selected=params.dateTimeStart)# <!--- Show fields for month, day, hour, and minute---> #dateTimeSelectTags(name="dateTimeStart", selected=params.dateTimeStart, dateOrder="month,day", timeOrder="hour,minute")#
Copied!