Builds and returns a string containing six select form controls (three for date selection and the remaining three for time selection) based on the supplied objectName and property.
Name | Type | Required | Default | Description |
---|---|---|---|---|
objectName | any | No | The variable name of the object to build the form control for. | |
property | string | Yes | The name of the property to use in the form control. | |
association | string | No | The name of the association that the property is located on. Used for building nested forms that work with nested properties. If you are building a form with deep nesting, simply pass in a list to the nested object, and Wheels will figure it out. | |
position | string | No | The position used when referencing a hasMany relationship in the association argument. Used for building nested forms that work with nested properties. If you are building a form with deep nestings, simply pass in a list of positions, and Wheels will figure it out. | |
dateOrder | string | No | month,day,year | Use to change the order of or exclude date select tags. |
dateSeperator | string | No | Use to change the character that is displayed between the date select tags. | |
startYear | numeric | No | 2009 | First year in select list. |
startYear | numeric | No | 2019 | Last year in select list. |
monthDisplay | string | No | names | Pass in names, numbers, or abbreviations to control display. |
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 | false | 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. | |
errorElement | string | No | span | HTML tag to wrap the form control with when the object contains errors. |
errorClass | string | No | fieldWithErrors | The class name of the HTML tag that wraps the form control when there are errors. |
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 |
dateTimeSelect(objectName, property [, association, position, dateOrder, dateSeparator, startYear, endYear, monthDisplay, timeOrder, timeSeparator, minuteStep, secondStep, separator, includeBlank, label, labelPlacement, prepend, append, prependToLabel, appendToLabel, errorElement, errorClass, combine, twelveHour ]) <!--- View code ---> <cfoutput> #dateTimeSelect(objectName="article", property="publishedAt")# </cfoutput> <!--- Show fields for month, day, hour, and minute ---> <cfoutput> #dateTimeSelect(objectName="appointment", property="dateTimeStart", dateOrder="month,day", timeOrder="hour,minute")# </cfoutput>