method

time_select

time_select(object_name, method, options = {}, html_options = {})
public

Returns a set of select tags (one for hour, minute and optionally second) pre-selected for accessing a specified time-based attribute (identified by method) on an object assigned to the template (identified by object). You can include the seconds with :include_seconds.

This method will also generate 3 input hidden tags, for the actual year, month and day unless the option :ignore_date is set to true.

If anything is passed in the html_options hash it will be applied to every select tag in the set.

Examples

# Creates a time select tag that, when POSTed, will be stored in the post variable in the sunrise attribute
time_select("post", "sunrise")

# Creates a time select tag that, when POSTed, will be stored in the order variable in the submitted
# attribute
time_select("order", "submitted")

# Creates a time select tag that, when POSTed, will be stored in the mail variable in the sent_at attribute
time_select("mail", "sent_at")

# Creates a time select tag with a seconds field that, when POSTed, will be stored in the post variables in
# the sunrise attribute.
time_select("post", "start_time", :include_seconds => true)

# Creates a time select tag with a seconds field that, when POSTed, will be stored in the entry variables in
# the submission_time attribute.
time_select("entry", "submission_time", :include_seconds => true)

# You can set the :minute_step to 15 which will give you: 00, 15, 30 and 45.
time_select 'game', 'game_time', {:minute_step => 15}

# Creates a time select tag with a custom prompt. Use :prompt => true for generic prompts.
time_select("post", "written_on", :prompt => {:hour => 'Choose hour', :minute => 'Choose minute', :second => 'Choose seconds'})
time_select("post", "written_on", :prompt => {:hour => true}) # generic prompt for hours
time_select("post", "written_on", :prompt => true) # generic prompts for all

The selects are prepared for multi-parameter assignment to an Active Record object.

Note: If the day is not included as an option but the month is, the day will be set to the 1st to ensure that all month choices are valid.

3Notes

Styling question

hayafirst · Oct 24, 20081 thank

How do we style the select boxes and ":" somehow within this method?

Follwup: it seems in Rails 2.1, FormBuilder#time_select didn't pass html_options to this method. and it's fixed i

Changing time/date separators

skalee · Jan 6, 20131 thank

@hayafirst — it is possible to remove that ":" or change it to something else. Just pass :time_separator option. Inspect ActionView::Helpers::DateTimeSelector#separator method for more.

Set time zone in before filter

autonomous · Jul 30, 2008

To set your time zone you could create a before_filter in your application.rb controller

class ApplicationController < ActionController::Base

before_filter :set_timezone

def set_timezone
Time.zone = 'GMT'
end

end