yearSelectTag()

Signature

yearSelectTag() — returns any

Description

Builds and returns a string containing a select form control for a range of years based on the supplied name.

Parameters

Name	Type	Required	Default	Description
name	string	yes	—	See documentation for textFieldTag.
selected	string	yes	—	The year that should be selected initially.
startYear	numeric	yes	2010	See documentation for dateSelect.
endYear	numeric	yes	2020	See documentation for dateSelect.
includeBlank	any	yes	false	See documentation for select.
label	string	yes	—	See documentation for textField.
labelPlacement	string	yes	around	See documentation for textField.
prepend	string	yes	—	See documentation for textField.
append	string	yes	—	See documentation for textField.
prependToLabel	string	yes	—	See documentation for textField.
appendToLabel	string	yes	—	See documentation for textField.

Examples

<!--- View code --->
<cfoutput>
    #yearSelectTag(name="yearOfBirthday", selected=params.yearOfBirthday)#
</cfoutput>

<!--- Only allow selection of year to be for the past 50 years, minimum being 18 years ago --->
<cfset fiftyYearsAgo = Now() - 50>
<cfset eighteenYearsAgo = Now() - 18>
<cfoutput>
	#yearSelectTag(name="yearOfBirthday", selected=params.yearOfBirthday, startYear=fiftyYearsAgo, endYear=eighteenYearsAgo)#
</cfoutput>