method

select_month

v1.1.6 - Show latest stable - 1 note - Class: ActionView::Helpers::DateHelper

select_month(date, options = {}) public

Returns a select tag with options for each of the months January through December with the current month selected. The month names are presented as keys (what’s shown to the user) and the month numbers (1-12) are used as values (what’s submitted to the server). It’s also possible to use month numbers for the presentation instead of names — set the :use_month_numbers key in options to true for this to happen. If you want both numbers and names, set the :add_month_numbers key in options to true. Examples:

  select_month(Date.today)                             # Will use keys like "January", "March"
  select_month(Date.today, :use_month_numbers => true) # Will use keys like "1", "3"
  select_month(Date.today, :add_month_numbers => true) # Will use keys like "1 - January", "3 - March"

Override the field name using the :field_name option, ‘month’ by default.

If you would prefer to show month names as abbreviations, set the :use_short_month key in options to true.

Show source

# File actionpack/lib/action_view/helpers/date_helper.rb, line 189
      def select_month(date, options = {})
        month_options = []
        month_names = options[:use_short_month] ? Date::ABBR_MONTHNAMES : Date::MONTHNAMES

        1.upto(12) do |month_number|
          month_name = if options[:use_month_numbers]
            month_number
          elsif options[:add_month_numbers]
            month_number.to_s + ' - ' + month_names[month_number]
          else
            month_names[month_number]
          end

          month_options << ((date && (date.kind_of?(Fixnum) ? date : date.month) == month_number) ?
            %(<option value="#{month_number}" selected="selected">#{month_name}</option>\n) :
            %(<option value="#{month_number}">#{month_name}</option>\n)
          )
        end

        select_html(options[:field_name] || 'month', month_options, options[:prefix], options[:include_blank], options[:discard_type], options[:disabled])
      end

October 2, 2008

10 thanks

:prefix option

Be aware!

By default, if you do select_month(Date.today, :field_name => ‘start’) it will generate select tag with name “date[start]”. If you want it to be something other than date[], add :prefix option, like this:

select_month(Date.today, :field_name => 'start', :prefix => 'timer')

This will render select tag with name “timer[start]”.

Taken from sources of name_and_id_from_options method.

select_month

Related methods

:prefix option