class Date
def acts_like_date?
def acts_like_date? true end
def advance(options)
# => Mon, 01 Nov 2004
Date.new(2004, 9, 30).advance(days: 1).advance(months: 1)
Whereas incrementing first by days then by months yields a different result:
# => Sun, 31 Oct 2004
Date.new(2004, 9, 30).advance(months: 1, days: 1)
then by days:
result around the end of a month. For example, incrementing first by months
+:months+, then by +:weeks+, then by +:days+. This order can affect the
In other words, the date is incremented first by +:years+, then by
The increments are applied in order of time units from largest to smallest.
any of these keys: :years, :months, :weeks, :days.
Provides precise Date calculations for years, months, and days. The +options+ parameter takes a hash with
def advance(options) d = self d = d >> options[:years] * 12 if options[:years] d = d >> options[:months] if options[:months] d = d + options[:weeks] * 7 if options[:weeks] d = d + options[:days] if options[:days] d end
def ago(seconds)
Converts Date to a Time (or DateTime if necessary) with the time portion set to the beginning of the day (0:00)
def ago(seconds) in_time_zone.since(-seconds) end
def as_json(options = nil) # :nodoc:
def as_json(options = nil) # :nodoc: if ActiveSupport::JSON::Encoding.use_standard_json_time_format strftime("%Y-%m-%d") else strftime("%Y/%m/%d") end end
def beginning_of_day
def beginning_of_day in_time_zone end
def 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.
Returns the week start (e.g. +:monday+) for the current request, if this has been set (via Date.beginning_of_week=).
def beginning_of_week ::ActiveSupport::IsolatedExecutionState[:beginning_of_week] || beginning_of_week_default || :monday end
def beginning_of_week=(week_start)
This method accepts any of the following day symbols:
Sets Date.beginning_of_week to a week start (e.g. +:monday+) for current request/thread.
def beginning_of_week=(week_start) ::ActiveSupport::IsolatedExecutionState[:beginning_of_week] = find_beginning_of_week!(week_start) end
def blank?
-
(false)
-
def blank? false end
def change(options)
Date.new(2007, 5, 12).change(day: 1) # => Date.new(2007, 5, 1)
The +options+ parameter is a hash with a combination of these keys: :year, :month, :day.
Returns a new Date where one or more of the elements have been changed according to the +options+ parameter.
def change(options) ::Date.new( options.fetch(:year, year), options.fetch(:month, month), options.fetch(:day, day) ) end
def compare_with_coercion(other)
def compare_with_coercion(other) if other.is_a?(Time) to_datetime <=> other else compare_without_coercion(other) end end
def current
def current ::Time.zone ? ::Time.zone.today : ::Date.today end
def end_of_day
def end_of_day in_time_zone.end_of_day end
def find_beginning_of_week!(week_start)
def find_beginning_of_week!(week_start) raise ArgumentError, "Invalid beginning of week: #{week_start}" unless ::Date::DAYS_INTO_WEEK.key?(week_start) week_start end
def middle_of_day
def middle_of_day in_time_zone.middle_of_day end
def minus_with_duration(other) # :nodoc:
def minus_with_duration(other) # :nodoc: if ActiveSupport::Duration === other plus_with_duration(-other) else minus_without_duration(other) end end
def plus_with_duration(other) # :nodoc:
def plus_with_duration(other) # :nodoc: if ActiveSupport::Duration === other other.since(self) else plus_without_duration(other) end end
def readable_inspect
def readable_inspect strftime("%a, %d %b %Y") end
def since(seconds)
Converts Date to a Time (or DateTime if necessary) with the time portion set to the beginning of the day (0:00)
def since(seconds) in_time_zone.since(seconds) end
def to_fs(format = :default)
Date::DATE_FORMATS[:month_and_year] = '%B %Y'
# config/initializers/date_formats.rb
or Proc instance that takes a date argument as the value.
Use the format name as the hash key and either a strftime string
You can add your own formats to the Date::DATE_FORMATS hash.
== Adding your own date formats to to_fs
date.to_fs(:iso8601) # => "2007-11-10"
date.to_fs(:rfc822) # => "10 Nov 2007"
date.to_fs(:long_ordinal) # => "November 10th, 2007"
date.to_fs(:long) # => "November 10, 2007"
date.to_fs(:number) # => "20071110"
date.to_fs(:short) # => "10 Nov"
date.to_formatted_s(:db) # => "2007-11-10"
date.to_fs(:db) # => "2007-11-10"
date = Date.new(2007, 11, 10) # => Sat, 10 Nov 2007
This method is aliased to to_formatted_s.
Convert to a formatted string. See DATE_FORMATS for predefined formats.
def to_fs(format = :default) if formatter = DATE_FORMATS[format] if formatter.respond_to?(:call) formatter.call(self).to_s else strftime(formatter) end else to_default_s end end
def to_s(format = NOT_SET) # :nodoc:
:nodoc:
def to_s(format = NOT_SET) # :nodoc: if formatter = DATE_FORMATS[format] ActiveSupport::Deprecation.warn( "Date#to_s(#{format.inspect}) is deprecated. Please use Date#to_fs(#{format.inspect}) instead." ) if formatter.respond_to?(:call) formatter.call(self).to_s else strftime(formatter) end elsif format == NOT_SET to_default_s else ActiveSupport::Deprecation.warn( "Date#to_s(#{format.inspect}) is deprecated. Please use Date#to_fs(#{format.inspect}) instead." ) to_default_s end end
def to_time(form = :local)
NOTE: The +:local+ timezone is Ruby's *process* timezone, i.e. ENV['TZ'].
date.to_time(:utc) # => 2007-11-10 00:00:00 UTC
date.to_time(:local) # => 2007-11-10 00:00:00 0800
date.to_time # => 2007-11-10 00:00:00 0800
date = Date.new(2007, 11, 10) # => Sat, 10 Nov 2007
The timezone can be either +:local+ or +:utc+ (default +:local+).
Converts a Date instance to a Time, where the time is set to the beginning of the day.
def to_time(form = :local) raise ArgumentError, "Expected :local or :utc, got #{form.inspect}." unless [:local, :utc].include?(form) ::Time.public_send(form, year, month, day) end
def tomorrow
def tomorrow ::Date.current.tomorrow end
def xmlschema
date = Date.new(2015, 05, 23) # => Sat, 23 May 2015
defined by XML Schema:
Returns a string which represents the time in used time zone as DateTime
def xmlschema in_time_zone.xmlschema end
def yesterday
def yesterday ::Date.current.yesterday end