Return to v1.4.5 docs

dateTimeSelectTags()

Builds and returns a string containing six select form controls (three for date selection and the remaining three for time selection) based on a name.

Name Type Required Default Description
name string Yes See documentation for textFieldTag.
selected string No See documentation for selectTag.
dateOrder string No month,day,year See documentation for dateTimeSelect.
dateSeparator string No See documentation for dateTimeSelect.
startYear numeric No 2010 See documentation for dateSelect.
endYear numeric No 2020 See documentation for dateSelect.
monthDisplay string No names See documentation for dateSelect.
monthNames string No January,February,March,April,May,June,July,August,September,October,November,December See documentation for dateSelect.
monthAbbreviations string No Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec See documentation for dateSelect.
timeOrder string No hour,minute,second See documentation for dateTimeSelect.
timeSeparator string No : See documentation for dateTimeSelect.
minuteStep numeric No 1 See documentation for timeSelect.
secondStep numeric No 1 See documentation for timeSelect.
separator string No - See documentation for dateTimeSelect.
includeBlank any No false See documentation for select.
label string No See documentation for dateSelect.
labelPlacement string No around See documentation for textField.
prepend string No See documentation for textField.
append string No See documentation for textField.
prependToLabel string No See documentation for textField.
appendToLabel string No See documentation for textField.
combine boolean No See documentation for dateSelect.
twelveHour boolean No false See documentation for timeSelect. 
<!--- This "Tag&qquot; version of the function accepts a `name` and `selected` instead of binding to a model object --->
<cfoutput>
    #dateTimeSelectTags(name="dateTimeStart", selected=params.dateTimeStart)#
</cfoutput>

<!--- Show fields for month, day, hour, and minute --->
<cfoutput>
	#dateTimeSelectTags(name="dateTimeStart", selected=params.dateTimeStart, dateOrder="month,day", timeOrder="hour,minute")#
</cfoutput>