модуль DateAndTime::Calculations
Константы
- DAYS_INTO_WEEK
- WEEKEND_DAYS
Открытые методы экземпляров
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 304 def all_month beginning_of_month..end_of_month end
Возвращает диапазон, представляющий весь месяц текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 309 def all_quarter beginning_of_quarter..end_of_quarter end
Возвращает диапазон, представляющий весь квартал текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 299 def all_week(start_day = Date.beginning_of_week) beginning_of_week(start_day)..end_of_week(start_day) end
Возвращает диапазон, представляющий всю неделю текущей даты/времени. Неделя начинается со start_day, по умолчанию это Date.week_start или config.week_start при установке.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 314 def all_year beginning_of_year..end_of_year end
Возвращает диапазон, представляющий весь год текущей даты/времени.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 110 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 124
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 255 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 154 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 62 def days_ago(days) advance(:days => -days) end
Возвращает новую дату/время, указанное количество дней назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 67 def days_since(days) advance(:days => days) end
Возвращает новую дату/время, указанное количество дней в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 245 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 284 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 139
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 271 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 292 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 47 def future? self > self.class.current end
Возвращает true, если дата/время находится в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 263 def monday beginning_of_week(:monday) end
Возвращает понедельник этой недели, предполагая, что неделя начинается с понедельника. DateTime объекты имеют время, установленное на 0:00.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 82 def months_ago(months) advance(:months => -months) end
Возвращает новую дату/время, указанное количество месяцев назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 87 def months_since(months) advance(:months => months) end
Возвращает новую дату/время, указанное количество месяцев в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 32 def next_day advance(days: 1) end
Возвращает новую дату/время, представляющую следующий день.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 190 def next_month months_since(1) end
Сокращенная запись для #months_since(1).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 195 def next_quarter months_since(3) end
Сокращенная запись для #months_since(3)
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 175 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 181
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 200 def next_year years_since(1) end
Сокращенная запись для #years_since(1).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 57 def on_weekday? !WEEKEND_DAYS.include?(wday) end
Возвращает true, если дата/время не приходится на субботу или воскресенье.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 52 def on_weekend? WEEKEND_DAYS.include?(wday) end
Возвращает true, если дата/время приходится на субботу или воскресенье.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 42 def past? self < self.class.current end
Возвращает true, если дата/время находится в прошлом.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 22 def prev_day advance(days: -1) end
Возвращает новую дату/время, представляющую предыдущий день.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 225 def prev_month months_ago(1) end
Сокращенная запись для #months_ago(1).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 231 def prev_quarter months_ago(3) end
Сокращенная запись для #months_ago(3).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 208 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 215
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 237 def prev_year years_ago(1) end
Сокращенная запись для #years_ago(1).
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 278 def sunday end_of_week(:monday) end
Возвращает воскресенье этой недели, предполагая, что неделя начинается с понедельника. DateTime объекты имеют время, установленное на 23:59:59.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 37 def today? to_date == ::Date.current end
Возвращает true, если дата/время — сегодня.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 27 def tomorrow advance(days: 1) end
Возвращает новую дату/время, представляющую завтрашний день.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 72 def weeks_ago(weeks) advance(:weeks => -weeks) end
Возвращает новую дату/время, представляющую указанное количество недель назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 77 def weeks_since(weeks) advance(:weeks => weeks) end
Возвращает новую дату/время, представляющую указанное количество недель в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 92 def years_ago(years) advance(:years => -years) end
Возвращает новую дату/время, представляющую указанное количество лет назад.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 97 def years_since(years) advance(:years => years) end
Возвращает новую дату/время, представляющую указанное количество лет в будущем.
# File activesupport/lib/active_support/core_ext/date_and_time/calculations.rb, line 17 def yesterday advance(days: -1) end
Возвращает новую дату/время, представляющую вчерашний день.
© 2004–2018 David Heinemeier Hansson
Licensed under the MIT License.