- #
- A
- B
- C
- D
- E
- F
- I
- M
- N
- R
- S
- T
- X
- Y
DATE_FORMATS | = | { short: "%d %b", long: "%B %d, %Y", db: "%Y-%m-%d", number: "%Y%m%d", long_ordinal: lambda { |date| day_format = ActiveSupport::Inflector.ordinalize(date.day) date.strftime("%B #{day_format}, %Y") # => "April 25th, 2007" }, rfc822: "%d %b %Y", iso8601: lambda { |date| date.iso8601 } } |
[RW] | beginning_of_week_default |
Returns the week start (e.g. :monday) for the current request, if this has
been set (via ::beginning_of_week=).
If Date.beginning_of_week
has not been set for the current
request, returns the week start specified in
config.beginning_of_week
. If no config.beginning_of_week was
specified, returns :monday.
Sets Date.beginning_of_week
to a week start (e.g. :monday) for
current request/thread.
This method accepts any of the following day symbols: :monday, :tuesday, :wednesday, :thursday, :friday, :saturday, :sunday
Returns Time.zone.today when
Time.zone
or config.time_zone
are set, otherwise
just returns Date.today.
Returns week start day symbol (e.g. :monday), or raises an
ArgumentError
for invalid day symbol.
Duck-types as a Date-like class. See Object#acts_like?.
Provides precise Date calculations for years,
months, and days. The options
parameter takes a hash with any
of these keys: :years
, :months
,
:weeks
, :days
.
# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 111 def advance(options) options = options.dup d = self d = d >> options.delete(:years) * 12 if options[:years] d = d >> options.delete(:months) if options[:months] d = d + options.delete(:weeks) * 7 if options[:weeks] d = d + options.delete(:days) if options[:days] d end
Returns a new Date where one or more of the
elements have been changed according to the options
parameter.
The options
parameter is a hash with a combination of these
keys: :year
, :month
, :day
.
Date.new(2007, 5, 12).change(day: 1) # => Date.new(2007, 5, 1)
Date.new(2007, 5, 12).change(year: 2005, month: 1) # => Date.new(2005, 1, 12)
Converts Date to a Time (or DateTime if necessary) with the time portion set to the end of the day (23:59:59)
Overrides the default inspect method with a human readable one, e.g., “Mon, 21 Feb 2005”
Converts Date to a Time (or DateTime if necessary) with the time portion set to the beginning of the day (0:00) and then adds the specified number of seconds
Convert to a formatted string. See DATE_FORMATS for predefined formats.
This method is aliased to to_s
.
date = Date.new(2007, 11, 10) # => Sat, 10 Nov 2007
date.to_formatted_s(:db) # => "2007-11-10"
date.to_s(:db) # => "2007-11-10"
date.to_formatted_s(:short) # => "10 Nov"
date.to_formatted_s(:number) # => "20071110"
date.to_formatted_s(:long) # => "November 10, 2007"
date.to_formatted_s(:long_ordinal) # => "November 10th, 2007"
date.to_formatted_s(:rfc822) # => "10 Nov 2007"
date.to_formatted_s(:iso8601) # => "2007-11-10"
Adding your own date formats to #to_formatted_s
You can add your own formats to the Date::DATE_FORMATS hash. Use the format name as the hash key and either a strftime string or Proc instance that takes a date argument as the value.
# config/initializers/date_formats.rb
Date::DATE_FORMATS[:month_and_year] = '%B %Y'
Date::DATE_FORMATS[:short_ordinal] = ->(date) { date.strftime("%B #{date.day.ordinalize}") }
Converts a Date instance to a Time, where the time is set to the beginning of the day. The timezone can be either :local or :utc (default :local).
date = Date.new(2007, 11, 10) # => Sat, 10 Nov 2007
date.to_time # => 2007-11-10 00:00:00 0800
date.to_time(:local) # => 2007-11-10 00:00:00 0800
date.to_time(:utc) # => 2007-11-10 00:00:00 UTC
NOTE: The :local timezone is Ruby's process timezone, i.e. ENV.
If the *application's* timezone is needed, then use +in_time_zone+ instead.