модуль DateAndTime::Calculations
Константы
- DAYS_INTO_WEEK
- ВЫХОДНЫЕ_ДНИ
Публичные методы экземпляров
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 59 def after?(date_or_time) self > date_or_time end
Возвращает true, если дата/время находится после date_or_time.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 287 def all_day beginning_of_day..end_of_day end
Возвращает диапазон, представляющий весь день текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 298 def all_month beginning_of_month..end_of_month end
Возвращает диапазон, представляющий весь месяц текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 303 def all_quarter beginning_of_quarter..end_of_quarter end
Возвращает диапазон, представляющий весь квартал текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 293 def all_week(start_day = Date.beginning_of_week) beginning_of_week(start_day)..end_of_week(start_day) end
Возвращает диапазон, представляющий всю неделю текущей даты/времени. Неделя начинается с start_day, по умолчанию Date.beginning_of_week или config.beginning_of_week, если задано.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 308 def all_year beginning_of_year..end_of_year end
Возвращает диапазон, представляющий весь год текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 54 def before?(date_or_time) self < date_or_time end
Возвращает true, если дата/время находится до date_or_time.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 112 def beginning_of_month first_hour(change(day: 1)) end
Возвращает новую дату/время в начале месяца.
today = Date.today # => Thu, 18 Jun 2015 today.beginning_of_month # => Mon, 01 Jun 2015
Объекты DateTime будут иметь время, установленное в 0:00.
now = DateTime.current # => Thu, 18 Jun 2015 15:23:13 +0000 now.beginning_of_month # => Mon, 01 Jun 2015 00:00:00 +0000
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 126 def beginning_of_quarter first_quarter_month = month - (2 + month) % 3 beginning_of_month.change(month: first_quarter_month) end
Возвращает новую дату/время в начале квартала.
today = Date.today # => Fri, 10 Jul 2015 today.beginning_of_quarter # => Wed, 01 Jul 2015
Объекты DateTime будут иметь время, установленное в 0:00.
now = DateTime.current # => Fri, 10 Jul 2015 18:41:29 +0000 now.beginning_of_quarter # => Wed, 01 Jul 2015 00:00:00 +0000
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 244 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
Возвращает новую дату/время, представляющую начало этой недели в указанный день. Неделя считается начинающейся в 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 156 def beginning_of_year change(month: 1).beginning_of_month end
Возвращает новую дату/время в начале года.
today = Date.today # => Fri, 10 Jul 2015 today.beginning_of_year # => Thu, 01 Jan 2015
Объекты DateTime будут иметь время, установленное в 0:00.
now = DateTime.current # => Fri, 10 Jul 2015 18:41:29 +0000 now.beginning_of_year # => Thu, 01 Jan 2015 00:00:00 +0000
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 64 def days_ago(days) advance(days: -days) end
Возвращает новую дату/время, заданное количество дней назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 69 def days_since(days) advance(days: days) end
Возвращает новую дату/время, заданное количество дней в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 235 def days_to_week_start(start_day = Date.beginning_of_week) start_day_number = DAYS_INTO_WEEK.fetch(start_day) (wday - start_day_number) % 7 end
Возвращает количество дней до начала недели в заданный день. Неделя считается начинающейся в start_day, по умолчанию Date.beginning_of_week или config.beginning_of_week при установлении.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 273 def end_of_month last_day = ::Time.days_in_month(month, year) last_hour(days_since(last_day - day)) end
Возвращает новую дату/время, представляющую конец месяца. Объекты DateTime будут иметь время, установленное в 23:59:59.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 141 def end_of_quarter last_quarter_month = month + (12 - month) % 3 beginning_of_month.change(month: last_quarter_month).end_of_month end
Возвращает новую дату/время в конце квартала.
today = Date.today # => Fri, 10 Jul 2015 today.end_of_quarter # => Wed, 30 Sep 2015
Объекты DateTime будут иметь время, установленное в 23:59:59.
now = DateTime.current # => Fri, 10 Jul 2015 18:41:29 +0000 now.end_of_quarter # => Wed, 30 Sep 2015 23:59:59 +0000
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 260 def end_of_week(start_day = Date.beginning_of_week) last_hour(days_since(6 - days_to_week_start(start_day))) end
Возвращает новую дату/время, представляющую конец этой недели в указанный день. Предполагается, что неделя начинается с 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 281 def end_of_year change(month: 12).end_of_month end
Возвращает новую дату/время, представляющую конец года. У объектов DateTime время будет установлено в 23:59:59.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 39 def future? self > self.class.current end
Возвращает true, если дата/время находится в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 217 def last_month months_ago(1) end
Сокращение для #months_ago(1).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 228 def last_year years_ago(1) end
Сокращение для #years_ago(1).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 252 def monday beginning_of_week(:monday) end
Возвращает понедельник этой недели, предполагая, что неделя начинается с понедельника. У объектов DateTime время устанавливается в 0:00.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 84 def months_ago(months) advance(months: -months) end
Возвращает новую дату/время за указанное количество месяцев назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 89 def months_since(months) advance(months: months) end
Возвращает новую дату/время на указанное количество месяцев вперед.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 317 def next_occurring(day_of_week) from_now = DAYS_INTO_WEEK.fetch(day_of_week) - wday from_now += 7 unless from_now > 0 advance(days: from_now) end
Возвращает новую дату/время, представляющую следующее вхождение указанного дня недели.
today = Date.today # => Thu, 14 Dec 2017 today.next_occurring(:monday) # => Mon, 18 Dec 2017 today.next_occurring(:thursday) # => Thu, 21 Dec 2017
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 192 def next_quarter months_since(3) end
Сокращение для #months_since(3)
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 177 def next_week(given_day_in_next_week = Date.beginning_of_week, same_time: false) result = first_hour(weeks_since(1).beginning_of_week.days_since(days_span(given_day_in_next_week))) same_time ? copy_time_to(result) : result end
Возвращает новую дату/время, представляющую указанный день на следующей неделе.
today = Date.today # => Thu, 07 May 2015 today.next_week # => Mon, 11 May 2015
Значение given_day_in_next_week по умолчанию — начало недели, которое определяется Date.beginning_of_week или config.beginning_of_week при установке.
today = Date.today # => Thu, 07 May 2015 today.next_week(:friday) # => Fri, 15 May 2015
У объектов DateTime время устанавливается в 0:00, если только same_time не равно true.
now = DateTime.current # => Thu, 07 May 2015 13:31:16 +0000 now.next_week # => Mon, 11 May 2015 00:00:00 +0000
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 183
def next_weekday
if next_day.on_weekend?
next_week(:monday, same_time: true)
else
next_day
end
end Возвращает новую дату/время, представляющую следующий будний день.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 49 def on_weekday? !WEEKEND_DAYS.include?(wday) end
Возвращает true, если дата/время не приходится на субботу или воскресенье.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 44 def on_weekend? WEEKEND_DAYS.include?(wday) end
Возвращает true, если дата/время приходится на субботу или воскресенье.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 34 def past? self < self.class.current end
Возвращает true, если дата/время находится в прошлом.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 328 def prev_occurring(day_of_week) ago = wday - DAYS_INTO_WEEK.fetch(day_of_week) ago += 7 unless ago > 0 advance(days: -ago) end
Возвращает новую дату/время, представляющую предыдущее вхождение указанного дня недели.
today = Date.today # => Thu, 14 Dec 2017 today.prev_occurring(:monday) # => Mon, 11 Dec 2017 today.prev_occurring(:thursday) # => Thu, 07 Dec 2017
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 222 def prev_quarter months_ago(3) end
Сокращение для #months_ago(3).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 200 def prev_week(start_day = Date.beginning_of_week, same_time: false) result = first_hour(weeks_ago(1).beginning_of_week.days_since(days_span(start_day))) same_time ? copy_time_to(result) : result end
Возвращает новую дату/время, представляющую указанный день на предыдущей неделе. Предполагается, что неделя начинается с start_day, по умолчанию — Date.beginning_of_week или config.beginning_of_week при установке. У объектов DateTime время устанавливается в 0:00, если только same_time не равно true.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 207
def prev_weekday
if prev_day.on_weekend?
copy_time_to(beginning_of_week(:friday))
else
prev_day
end
end Возвращает новую дату/время, представляющую предыдущий будний день.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 267 def sunday end_of_week(:monday) end
Возвращает воскресенье этой недели, предполагая, что неделя начинается с понедельника. У объектов DateTime время устанавливается в 23:59:59.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 29 def today? to_date == ::Date.current end
Возвращает true, если дата/время — сегодня.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 24 def tomorrow advance(days: 1) end
Возвращает новую дату/время, представляющую завтрашний день.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 74 def weeks_ago(weeks) advance(weeks: -weeks) end
Возвращает новую дату/время, соответствующую указанному количеству недель назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 79 def weeks_since(weeks) advance(weeks: weeks) end
Возвращает новую дату/время, соответствующую указанному количеству недель в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 94 def years_ago(years) advance(years: -years) end
Возвращает новую дату/время, соответствующую указанному количеству лет назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 99 def years_since(years) advance(years: years) end
Возвращает новую дату/время, соответствующую указанному количеству лет в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 19 def yesterday advance(days: -1) end
Возвращает новую дату/время, представляющую вчерашний день.
© 2004–2019 David Heinemeier Hansson
Licensed under the MIT License.