модуль DateAndTime::Calculations
Константы
- DAYS_INTO_WEEK
- ВЫХОДНЫЕ_ДНИ
Открытые методы экземпляров
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 308 def all_day beginning_of_day..end_of_day end
Возвращает диапазон, представляющий весь день текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 319 def all_month beginning_of_month..end_of_month end
Возвращает диапазон, представляющий весь месяц текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 324 def all_quarter beginning_of_quarter..end_of_quarter end
Возвращает диапазон, представляющий весь квартал текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 314 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 329 def all_year beginning_of_year..end_of_year end
Возвращает диапазон, представляющий весь год текущей даты/времени.
# 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 = [10, 7, 4, 1].detect { |m| m <= month }
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 265 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 255 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
Возвращает количество дней до начала недели в заданный день. Предполагается, что неделя начинается с start_day, по умолчанию это Date.beginning_of_week или config.beginning_of_week при установлении.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 294 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 = [3, 6, 9, 12].detect { |m| m >= month }
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 281 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 302 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 49 def future? self > self.class.current end
Возвращает true, если дата/время находится в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 232 def last_month months_ago(1) end
Сокращенная запись для #months_ago(1).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 248 def last_year years_ago(1) end
Сокращенная запись для #years_ago(1).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 273 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 34 def next_day(days = 1) advance(days: days) end
Возвращает новую дату/время на указанное количество дней в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 192 def next_month(months = 1) advance(months: months) end
Возвращает новую дату/время на указанное количество месяцев в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 338 def next_occurring(day_of_week) current_day_number = wday != 0 ? wday - 1 : 6 from_now = DAYS_INTO_WEEK.fetch(day_of_week) - current_day_number 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 197 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 202 def next_year(years = 1) advance(years: years) end
Возвращает новую дату/время на указанное количество лет в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 59 def on_weekday? !WEEKEND_DAYS.include?(wday) end
Возвращает true, если дата/время не приходится на субботу или воскресенье.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 54 def on_weekend? WEEKEND_DAYS.include?(wday) end
Возвращает true, если дата/время приходится на субботу или воскресенье.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 44 def past? self < self.class.current end
Возвращает true, если дата/время находится в прошлом.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 24 def prev_day(days = 1) advance(days: -days) end
Возвращает новую дату/время за указанное количество дней назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 227 def prev_month(months = 1) advance(months: -months) end
Возвращает новую дату/время за указанное количество месяцев назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 350 def prev_occurring(day_of_week) current_day_number = wday != 0 ? wday - 1 : 6 ago = current_day_number - 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 237 def prev_quarter months_ago(3) end
Сокращенная запись для #months_ago(3).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 210 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 217
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 243 def prev_year(years = 1) advance(years: -years) end
Возвращает новую дату/время, на указанное количество лет назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 288 def sunday end_of_week(:monday) end
Возвращает воскресенье текущей недели, предполагая, что неделя начинается с понедельника. DateTime объекты имеют время, установленное на 23:59:59.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 39 def today? to_date == ::Date.current end
Возвращает true, если дата/время является сегодняшней.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 29 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–2018 David Heinemeier Hansson
Licensed under the MIT License.