instance method select_year

Ruby on Rails 2.3.18

Since v2.2.3

Available in: v2.2.3 v2.3.18 v3.0.20 v3.1.12 v3.2.22.5 v4.0.13 v4.1.16 v4.2.9 v5.2.8.1 v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Signature

select_year(date, options = {}, html_options = {})

Returns a select tag with options for each of the five years on each side of the current, which is selected. The five year radius can be changed using the :start_year and :end_year keys in the options. Both ascending and descending year lists are supported by making :start_year less than or greater than :end_year. The date can also be substituted for a year given as a number. Override the field name using the :field_name option, ‘year’ by default.

Examples

# Generates a select field for years that defaults to the current year that
# has ascending year values
select_year(Date.today, :start_year => 1992, :end_year => 2007)

# Generates a select field for years that defaults to the current year that
# is named 'birth' rather than 'year'
select_year(Date.today, :field_name => 'birth')

# Generates a select field for years that defaults to the current year that
# has descending year values
select_year(Date.today, :start_year => 2005, :end_year => 1900)

# Generates a select field for years that defaults to the year 2006 that
# has ascending year values
select_year(2006, :start_year => 2000, :end_year => 2010)

# Generates a select field for years with a custom prompt.  Use :prompt => true for a
# generic prompt.
select_year(14, :prompt => 'Choose year')

Parameters

date req
options opt = {}
html_options opt = {}
Source
# File actionpack/lib/action_view/helpers/date_helper.rb, line 574
      def select_year(date, options = {}, html_options = {})
        DateTimeSelector.new(date, options, html_options).select_year
      end

Defined in actionpack/lib/action_view/helpers/date_helper.rb line 574 · View on GitHub · Improve this page · Find usages on GitHub

Defined in ActionView::Helpers::DateHelper

Type at least 2 characters to search.

↑↓ navigate · open · esc close