модуль DateAndTime::Calculations
Константы
- DAYS_INTO_WEEK
- WEEKEND_DAYS
Общедоступные методы экземпляров
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 72 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 300 def all_day beginning_of_day..end_of_day end
Возвращает Range, представляющий весь день текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 311 def all_month beginning_of_month..end_of_month end
Возвращает Range, представляющий весь месяц текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 316 def all_quarter beginning_of_quarter..end_of_quarter end
Возвращает Range, представляющий весь квартал текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 306 def all_week(start_day = Date.beginning_of_week) beginning_of_week(start_day)..end_of_week(start_day) end
Возвращает Range, представляющий всю неделю текущей даты/времени. Неделя начинается с start_day, по умолчанию — Date.beginning_of_week или config.beginning_of_week, если задано.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 321 def all_year beginning_of_year..end_of_year end
Возвращает Range, представляющий весь год текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 67 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 125 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 139 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 257 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 169 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 77 def days_ago(days) advance(days: -days) end
Возвращает новую дату/время, на указанное количество дней назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 82 def days_since(days) advance(days: days) end
Возвращает новую дату/время, на указанное количество дней в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 248 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 286 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 154 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 273 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 294 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 52 def future? self > self.class.current end
Возвращает true, если дата/время находится в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 230 def last_month months_ago(1) end
Краткая запись для months_ago(1).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 241 def last_year years_ago(1) end
Краткая запись для years_ago(1).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 265 def monday beginning_of_week(:monday) end
Возвращает понедельник текущей недели, предполагая, что неделя начинается с понедельника. Объекты DateTime имеют время, установленное на 0:00.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 97 def months_ago(months) advance(months: -months) end
Возвращает новую дату/время, на указанное количество месяцев назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 102 def months_since(months) advance(months: months) end
Возвращает новую дату/время, на указанное количество месяцев в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 330 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 205 def next_quarter months_since(3) end
Краткая запись для months_since(3)
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 190 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 196
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 62 def on_weekday? !WEEKEND_DAYS.include?(wday) end
Возвращает true, если дата/время не приходится на субботу или воскресенье.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 57 def on_weekend? WEEKEND_DAYS.include?(wday) end
Возвращает true, если дата/время приходится на субботу или воскресенье.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 47 def past? self < self.class.current end
Возвращает true, если дата/время находится в прошлом.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 341 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 235 def prev_quarter months_ago(3) end
Краткая запись для months_ago(3).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 213 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 220
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 280 def sunday end_of_week(:monday) end
Возвращает воскресенье текущей недели, предполагая, что неделя начинается с понедельника. DateTime объекты имеют время, установленное на 23:59:59.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 30 def today? to_date == ::Date.current end
Возвращает true, если дата/время — сегодня.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 25 def tomorrow advance(days: 1) end
Возвращает новую дату/время, представляющую завтрашний день.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 35 def tomorrow? to_date == ::Date.current.tomorrow end
Возвращает true, если дата/время — завтра.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 87 def weeks_ago(weeks) advance(weeks: -weeks) end
Возвращает новую дату/время, соответствующую указанному количеству недель назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 92 def weeks_since(weeks) advance(weeks: weeks) end
Возвращает новую дату/время, соответствующую указанному количеству недель в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 107 def years_ago(years) advance(years: -years) end
Возвращает новую дату/время, соответствующую указанному количеству лет назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 112 def years_since(years) advance(years: years) end
Возвращает новую дату/время, соответствующую указанному количеству лет в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 20 def yesterday advance(days: -1) end
Возвращает новую дату/время, представляющую вчерашний день.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 41 def yesterday? to_date == ::Date.current.yesterday end
Возвращает true, если дата/время — вчера.
© 2004–2020 David Heinemeier Hansson
Licensed under the MIT License.