модуль DateAndTime::Calculations

Константы

DAYS_INTO_WEEK

Публичные методы экземпляров

Возвращает диапазон представляющий весь месяц текущей даты/времени.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 223
def all_month
  beginning_of_month..end_of_month
end

all_quarter() Показать исходный код

Возвращает диапазон представляющий весь квартал текущей даты/времени.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 228
def all_quarter
  beginning_of_quarter..end_of_quarter
end

all_week(start_day = Date.beginning_of_week) Показать исходный код

Возвращает диапазон представляющий всю неделю текущей даты/времени. Неделя начинается со start_day, по умолчанию это Date.week_start или config.week_start при установке.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 218
def all_week(start_day = Date.beginning_of_week)
  beginning_of_week(start_day)..end_of_week(start_day)
end

all_year() Показать исходный код

Возвращает диапазон представляющий весь год текущей даты/времени.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 233
def all_year
  beginning_of_year..end_of_year
end

at_beginning_of_month()

Псевдоним для: beginning_of_month

at_beginning_of_quarter()

Псевдоним для: beginning_of_quarter

at_beginning_of_week(start_day = Date.beginning_of_week)

Псевдоним для: beginning_of_week

at_beginning_of_year()

Псевдоним для: beginning_of_year

at_end_of_month()

Псевдоним для: end_of_month

at_end_of_quarter()

Псевдоним для: end_of_quarter

at_end_of_week(start_day = Date.beginning_of_week)

Псевдоним для: end_of_week

at_end_of_year()

Псевдоним для: end_of_year

beginning_of_month() Показать исходный код

Возвращает новую дату/время в начале месяца. Объекты DateTime будут иметь время, установленное в 0:00.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 80
def beginning_of_month
  first_hour(change(:day => 1))
end

Также псевдоним для: at_beginning_of_month

beginning_of_quarter() Показать исходный код

Возвращает новую дату/время в начале квартала. Пример: 1 января, 1 июля, 1 октября. Объекты DateTime будут иметь время, установленное в 0:00.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 88
def beginning_of_quarter
  first_quarter_month = [10, 7, 4, 1].detect { |m| m <= month }
  beginning_of_month.change(:month => first_quarter_month)
end

Также псевдоним для: at_beginning_of_quarter

beginning_of_week(start_day = Date.beginning_of_week) Показать исходный код

Возвращает новую дату/время, представляющую начало этой недели в заданный день. Неделя предполагается начинаться в start_day, по умолчанию это Date.beginning_of_week или config.beginning_of_week при установке. Объекты DateTime имеют время, установленное в 0:00.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 174
def beginning_of_week(start_day = Date.beginning_of_week)
  result = days_ago(days_to_week_start(start_day))
  acts_like?(:time) ? result.midnight : result
end

Также псевдоним для: at_beginning_of_week

beginning_of_year() Показать исходный код

Возвращает новую дату/время в начале года. Пример: 1 января. Объекты DateTime будут иметь время, установленное в 0:00.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 106
def beginning_of_year
  change(:month => 1).beginning_of_month
end

Также псевдоним для: at_beginning_of_year

days_ago(days) Показать исходный код

Возвращает новую дату/время, указанное количество дней назад.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 39
def days_ago(days)
  advance(:days => -days)
end

days_since(days) Показать исходный код

Возвращает новую дату/время, указанное количество дней в будущем.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 44
def days_since(days)
  advance(:days => days)
end

days_to_week_start(start_day = Date.beginning_of_week) Показать исходный код

Возвращает количество дней до начала недели в заданный день. Неделя предполагается начинаться в start_day, по умолчанию это Date.beginning_of_week или config.beginning_of_week при установке.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 164
def days_to_week_start(start_day = Date.beginning_of_week)
  start_day_number = DAYS_INTO_WEEK[start_day]
  current_day_number = wday != 0 ? wday - 1 : 6
  (current_day_number - start_day_number) % 7
end

end_of_month() Показать исходный код

Возвращает новую дату/время, представляющую конец месяца. Объекты DateTime будут иметь время, установленное в 23:59:59.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 203
def end_of_month
  last_day = ::Time.days_in_month(month, year)
  last_hour(days_since(last_day - day))
end

Также псевдоним для: at_end_of_month

end_of_quarter() Показать исходный код

Возвращает новую дату/время в конце квартала. Пример: 31 марта, 30 июня, 30 сентября. Объекты DateTime будут иметь время, установленное в 23:59:59.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 97
def end_of_quarter
  last_quarter_month = [3, 6, 9, 12].detect { |m| m >= month }
  beginning_of_month.change(:month => last_quarter_month).end_of_month
end

Также псевдоним для: at_end_of_quarter

end_of_week(start_day = Date.beginning_of_week) Показать исходный код

Возвращает новую дату/время, представляющую конец этой недели в заданный день. Неделя предполагается начинаться в start_day, по умолчанию это Date.beginning_of_week или config.beginning_of_week при установке. Объекты DateTime имеют время, установленное в 23:59:59.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 190
def end_of_week(start_day = Date.beginning_of_week)
  last_hour(days_since(6 - days_to_week_start(start_day)))
end

Также псевдоним для: at_end_of_week

end_of_year() Показать исходный код

Возвращает новую дату/время, представляющую конец года. Объекты DateTime будут иметь время, установленное в 23:59:59.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 211
def end_of_year
  change(:month => 12).end_of_month
end

Также псевдоним для: at_end_of_year

END_OF_DOCUMENT_MARKER

future?() Show source

Возвращает true, если дата/время находятся в будущем.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 34
def future?
  self > self.class.current
end

last_month()

Alias for: prev_month

last_quarter()

Alias for: prev_quarter

last_week(start_day = Date.beginning_of_week)

Alias for: prev_week

last_year()

Alias for: prev_year

monday() Show source

Возвращает понедельник этой недели, предполагая, что неделя начинается с понедельника. DateTime объекты имеют время, установленное на 0:00.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 182
def monday
  beginning_of_week(:monday)
end

months_ago(months) Show source

Возвращает новую дату/время за указанное количество месяцев назад.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 59
def months_ago(months)
  advance(:months => -months)
end

months_since(months) Show source

Возвращает новую дату/время через указанное количество месяцев в будущем.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 64
def months_since(months)
  advance(:months => months)
end

next_month() Show source

Сокращенная запись для #months_since(1).

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 120
def next_month
  months_since(1)
end

next_quarter() Show source

Сокращенная запись для #months_since(3)

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 125
def next_quarter
  months_since(3)
end

next_week(given_day_in_next_week = Date.beginning_of_week) Show source

Возвращает новую дату/время, представляющую указанный день на следующей неделе. given_day_in_next_week по умолчанию используется начало недели, которое определяется Date.beginning_of_week или config.beginning_of_week, когда установлено. DateTime объекты имеют время, установленное на 0:00.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 115
def next_week(given_day_in_next_week = Date.beginning_of_week)
  first_hour(weeks_since(1).beginning_of_week.days_since(days_span(given_day_in_next_week)))
end

next_year() Show source

Сокращенная запись для #years_since(1).

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 130
def next_year
  years_since(1)
end

past?() Show source

Возвращает true, если дата/время находятся в прошлом.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 29
def past?
  self < self.class.current
end

prev_month() Show source

Сокращенная запись для #months_ago(1).

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 144
def prev_month
  months_ago(1)
end

Также является псевдонимом для: last_month

prev_quarter() Show source

Сокращенная запись для #months_ago(3).

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 150
def prev_quarter
  months_ago(3)
end

Также является псевдонимом для: last_quarter

prev_week(start_day = Date.beginning_of_week) Show source

Возвращает новую дату/время, представляющую указанный день на предыдущей неделе. Предполагается, что неделя начинается с start_day, по умолчанию используется Date.beginning_of_week или config.beginning_of_week, когда установлено. DateTime объекты имеют время, установленное на 0:00.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 138
def prev_week(start_day = Date.beginning_of_week)
  first_hour(weeks_ago(1).beginning_of_week.days_since(days_span(start_day)))
end

Также является псевдонимом для: last_week

prev_year() Show source

Сокращенная запись для #years_ago(1).

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 156
def prev_year
  years_ago(1)
end

Также является псевдонимом для: last_year

sunday() Show source

Возвращает воскресенье этой недели, предполагая, что неделя начинается с понедельника. DateTime объекты имеют время, установленное на 23:59:59.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 197
def sunday
  end_of_week(:monday)
end

today?() Show source

Возвращает true, если дата/время являются сегодняшними.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 24
def today?
  to_date == ::Date.current
end

tomorrow() Show source

Возвращает новую дату/время, представляющую завтрашний день.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 19
def tomorrow
  advance(:days => 1)
end

weeks_ago(weeks) Show source

Возвращает новую дату/время за указанное количество недель назад.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 49
def weeks_ago(weeks)
  advance(:weeks => -weeks)
end

weeks_since(weeks) Show source

Возвращает новую дату/время через указанное количество недель в будущем.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 54
def weeks_since(weeks)
  advance(:weeks => weeks)
end

years_ago(years) Show source

Возвращает новую дату/время за указанное количество лет назад.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 69
def years_ago(years)
  advance(:years => -years)
end

years_since(years) Show source

Возвращает новую дату/время через указанное количество лет в будущем.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 74
def years_since(years)
  advance(:years => years)
end

yesterday() Show source

Возвращает новую дату/время, представляющую вчерашний день.

# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 14
def yesterday
  advance(:days => -1)
end