класс Date

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 19
def beginning_of_week
  ::ActiveSupport::IsolatedExecutionState[:beginning_of_week] || beginning_of_week_default || :monday
end

Возвращает начало недели (например, :monday) для текущего запроса, если оно было задано (с помощью Date.beginning_of_week=). Если для текущего запроса не задано Date.beginning_of_week, возвращает начало недели, указанное в config.beginning_of_week. Если config.beginning_of_week не указано, возвращает :monday.

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 27
def beginning_of_week=(week_start)
  ::ActiveSupport::IsolatedExecutionState[:beginning_of_week] = find_beginning_of_week!(week_start)
end

Задаёт Date.beginning_of_week как начало недели (например, :monday) для текущего запроса/потока.

Этот метод принимает любой из следующих символов дня недели: :monday, :tuesday, :wednesday, :thursday, :friday, :saturday, :sunday

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 48
def current
  ::Time.zone ? ::Time.zone.today : ::Date.today
end

Возвращает Time.zone.today, если заданы Time.zone или config.time_zone, иначе просто возвращает Date.today.

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 32
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

Возвращает символ дня недели, с которого начинается неделя (например, :monday), или вызывает исключение ArgumentError, если указан недопустимый символ дня недели.

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 43
def tomorrow
  ::Date.current.tomorrow
end

Возвращает новый объект Date, представляющий дату через 1 день после сегодняшней (то есть завтрашнюю дату).

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 38
def yesterday
  ::Date.current.yesterday
end

Возвращает новый объект Date, представляющий дату 1 днём ранее (то есть вчерашнюю дату).

# File activesupport/lib/active_support/core_ext/date/acts_like.rb, line 7
def acts_like_date?
  true
end

Поддерживает duck typing как класс, подобный Date. См. Object#acts_like?.

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 127
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

Выполняет точные вычисления с Date для лет, месяцев и дней. Параметр options принимает хеш с любыми из следующих ключей: :years, :months, :weeks, :days.

Приращения применяются в порядке убывания единиц времени. Иными словами, сначала к дате прибавляется :years, затем :months, потом :weeks и, наконец, :days. Этот порядок может повлиять на результат в конце месяца. Например, если сначала прибавить месяцы, а затем дни:

Date.new(2004, 9, 30).advance(months: 1, days: 1)
# => Sun, 31 Oct 2004

Если же сначала прибавить дни, а затем месяцы, результат будет другим:

Date.new(2004, 9, 30).advance(days: 1).advance(months: 1)
# => Mon, 01 Nov 2004

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 55
def ago(seconds)
  in_time_zone.since(-seconds)
end

Преобразует Date в Time (или при необходимости в DateTime), устанавливая время на начало дня (0:00), а затем вычитает указанное количество секунд.

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 67
def beginning_of_day
  in_time_zone
end

Преобразует Date в Time (или при необходимости в DateTime), устанавливая время на начало дня (0:00)

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 143
def change(options)
  ::Date.new(
    options.fetch(:year, year),
    options.fetch(:month, month),
    options.fetch(:day, day)
  )
end

Возвращает новый объект Date, в котором один или несколько элементов изменены в соответствии с параметром options. Параметр options — это хеш, содержащий сочетание следующих ключей: :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)

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 152
def compare_with_coercion(other)
  if other.is_a?(Time)
    to_datetime <=> other
  else
    compare_without_coercion(other)
  end
end

Позволяет сравнивать Date с Time, преобразуя их в DateTime и используя оператор <=> этого класса.

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 85
def end_of_day
  in_time_zone.end_of_day
end

Преобразует Date в Time (или при необходимости в DateTime), устанавливая время на конец дня (23:59:59)

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 75
def middle_of_day
  in_time_zone.middle_of_day
end

Преобразует Date в Time (или при необходимости в DateTime), устанавливая время на середину дня (12:00)

# File activesupport/lib/active_support/core_ext/date/conversions.rb, line 63
def readable_inspect
  strftime("%a, %d %b %Y")
end

Переопределяет метод inspect по умолчанию, заменяя его на удобный для чтения человеком вариант, например «Mon, 21 Feb 2005»

# File activesupport/lib/active_support/core_ext/date/calculations.rb, line 61
def since(seconds)
  in_time_zone.since(seconds)
end

Преобразует Date в Time (или при необходимости в DateTime), устанавливая время на начало дня (0:00), а затем прибавляет указанное количество секунд

# File activesupport/lib/active_support/core_ext/date/conversions.rb, line 49
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_s
  end
end

Преобразует значение в строку с заданным форматом. Предопределённые форматы см. в DATE_FORMATS.

Этот метод является псевдонимом to_formatted_s.

date = Date.new(2007, 11, 10)       # => Sat, 10 Nov 2007

date.to_fs(:db)                     # => "2007-11-10"
date.to_formatted_s(:db)            # => "2007-11-10"

date.to_fs(:short)         # => "10 Nov"
date.to_fs(:number)        # => "20071110"
date.to_fs(:long)          # => "November 10, 2007"
date.to_fs(:long_ordinal)  # => "November 10th, 2007"
date.to_fs(:rfc822)        # => "10 Nov 2007"
date.to_fs(:rfc2822)       # => "10 Nov 2007"
date.to_fs(:iso8601)       # => "2007-11-10"

Добавление собственных форматов даты в to_fs

Вы можете добавить собственные форматы в хеш Date::DATE_FORMATS. Используйте название формата в качестве ключа хеша, а в качестве значения — строку strftime или экземпляр Proc, принимающий аргумент date.

# 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}") }

# File activesupport/lib/active_support/core_ext/date/conversions.rb, line 83
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

Преобразует экземпляр Date в Time, устанавливая время на начало дня. Часовой пояс может быть :local или :utc (по умолчанию :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

ПРИМЕЧАНИЕ: Часовой пояс :local — это часовой пояс Ruby для процесса, то есть ENV['TZ']. Если нужен часовой пояс приложения, используйте вместо этого in_time_zone.

# File activesupport/lib/active_support/core_ext/date/conversions.rb, line 95
def xmlschema
  in_time_zone.xmlschema
end

Возвращает строку, представляющую время в используемом часовом поясе в формате DateTime, определённом XML Schema:

date = Date.new(2015, 05, 23)  # => Sat, 23 May 2015
date.xmlschema                 # => "2015-05-23T00:00:00+04:00"