1 module ActiveSupport
#:nodoc:
2 module CoreExtensions
#:nodoc:
4 # Enables the use of time calculations within Time itself
6 def self.included(base
) #:nodoc:
7 base
.extend ClassMethods
10 alias_method
:plus_without_duration, :+
11 alias_method
:+, :plus_with_duration
13 alias_method
:minus_without_duration, :-
14 alias_method
:-, :minus_with_duration
19 # Returns a new Date representing the date 1 day ago (i.e. yesterday's date).
21 ::Date.today
.yesterday
24 # Returns a new Date representing the date 1 day after today (i.e. tomorrow's date).
29 # Returns Time.zone.today when config.time_zone is set, otherwise just returns Date.today.
31 ::Time.zone_default
? ::Time.zone
.today
: ::Date.today
35 # Tells whether the Date object's date lies in the past
40 # Tells whether the Date object's date is today
42 self.to_date
== ::Date.current
# we need the to_date because of DateTime
45 # Tells whether the Date object's date lies in the future
50 # Converts Date to a Time (or DateTime if necessary) with the time portion set to the beginning of the day (0:00)
51 # and then subtracts the specified number of seconds
53 to_time
.since(-seconds
)
56 # Converts Date to a Time (or DateTime if necessary) with the time portion set to the beginning of the day (0:00)
57 # and then adds the specified number of seconds
59 to_time
.since(seconds
)
63 # Converts Date to a Time (or DateTime if necessary) with the time portion set to the beginning of the day (0:00)
67 alias :midnight :beginning_of_day
68 alias :at_midnight :beginning_of_day
69 alias :at_beginning_of_day :beginning_of_day
71 # Converts Date to a Time (or DateTime if necessary) with the time portion set to the end of the day (23:59:59)
76 def plus_with_duration(other
) #:nodoc:
77 if ActiveSupport
::Duration === other
80 plus_without_duration(other
)
84 def minus_with_duration(other
) #:nodoc:
85 if ActiveSupport
::Duration === other
86 plus_with_duration(-other
)
88 minus_without_duration(other
)
92 # Provides precise Date calculations for years, months, and days. The +options+ parameter takes a hash with
93 # any of these keys: <tt>:years</tt>, <tt>:months</tt>, <tt>:weeks</tt>, <tt>:days</tt>.
96 d
= d
>> options
.delete(:years) * 12 if options
[:years]
97 d
= d
>> options
.delete(:months) if options
[:months]
98 d
= d
+ options
.delete(:weeks) * 7 if options
[:weeks]
99 d
= d
+ options
.delete(:days) if options
[:days]
103 # Returns a new Date where one or more of the elements have been changed according to the +options+ parameter.
107 # Date.new(2007, 5, 12).change(:day => 1) # => Date.new(2007, 5, 1)
108 # Date.new(2007, 5, 12).change(:year => 2005, :month => 1) # => Date.new(2005, 1, 12)
111 options
[:year] || self.year
,
112 options
[:month] || self.month
,
113 options
[:day] || self.day
117 # Returns a new Date/DateTime representing the time a number of specified months ago
118 def months_ago(months
)
119 advance(:months => -months
)
122 # Returns a new Date/DateTime representing the time a number of specified months in the future
123 def months_since(months
)
124 advance(:months => months
)
127 # Returns a new Date/DateTime representing the time a number of specified years ago
129 advance(:years => -years
)
132 # Returns a new Date/DateTime representing the time a number of specified years in the future
133 def years_since(years
)
134 advance(:years => years
)
137 # Short-hand for years_ago(1)
142 # Short-hand for years_since(1)
147 # Short-hand for months_ago(1)
152 # Short-hand for months_since(1)
157 # Returns a new Date/DateTime representing the "start" of this week (i.e, Monday; DateTime objects will have time set to 0:00)
158 def beginning_of_week
159 days_to_monday
= self.wday
!=0 ? self.wday-1
: 6
160 result
= self - days_to_monday
161 self.acts_like
?(:time) ? result
.midnight
: result
163 alias :monday :beginning_of_week
164 alias :at_beginning_of_week :beginning_of_week
166 # Returns a new Date/DateTime representing the end of this week (Sunday, DateTime objects will have time set to 23:59:59)
168 days_to_sunday
= self.wday
!=0 ? 7-self.wday
: 0
169 result
= self + days_to_sunday
.days
170 self.acts_like
?(:time) ? result
.end_of_day
: result
172 alias :at_end_of_week :end_of_week
174 # Returns a new Date/DateTime representing the start of the given day in next week (default is Monday).
175 def next_week(day
= :monday)
176 days_into_week
= { :monday => 0, :tuesday => 1, :wednesday => 2, :thursday => 3, :friday => 4, :saturday => 5, :sunday => 6}
177 result
= (self + 7).beginning_of_week
+ days_into_week
[day
]
178 self.acts_like
?(:time) ? result
.change(:hour => 0) : result
181 # Returns a new ; DateTime objects will have time set to 0:00DateTime representing the start of the month (1st of the month; DateTime objects will have time set to 0:00)
182 def beginning_of_month
183 self.acts_like
?(:time) ? change(:day => 1,:hour => 0, :min => 0, :sec => 0) : change(:day => 1)
185 alias :at_beginning_of_month :beginning_of_month
187 # Returns a new Date/DateTime representing the end of the month (last day of the month; DateTime objects will have time set to 0:00)
189 last_day
= ::Time.days_in_month( self.month
, self.year
)
190 self.acts_like
?(:time) ? change(:day => last_day
, :hour => 23, :min => 59, :sec => 59) : change(:day => last_day
)
192 alias :at_end_of_month :end_of_month
194 # Returns a new Date/DateTime representing the start of the quarter (1st of january, april, july, october; DateTime objects will have time set to 0:00)
195 def beginning_of_quarter
196 beginning_of_month
.change(:month => [10, 7, 4, 1].detect
{ |m
| m
<= self.month
})
198 alias :at_beginning_of_quarter :beginning_of_quarter
200 # Returns a new Date/DateTime representing the end of the quarter (last day of march, june, september, december; DateTime objects will have time set to 23:59:59)
202 beginning_of_month
.change(:month => [3, 6, 9, 12].detect
{ |m
| m
>= self.month
}).end_of_month
204 alias :at_end_of_quarter :end_of_quarter
206 # Returns a new Date/DateTime representing the start of the year (1st of january; DateTime objects will have time set to 0:00)
207 def beginning_of_year
208 self.acts_like
?(:time) ? change(:month => 1, :day => 1, :hour => 0, :min => 0, :sec => 0) : change(:month => 1, :day => 1)
210 alias :at_beginning_of_year :beginning_of_year
212 # Returns a new Time representing the end of the year (31st of december; DateTime objects will have time set to 23:59:59)
214 self.acts_like
?(:time) ? change(:month => 12,:day => 31,:hour => 23, :min => 59, :sec => 59) : change(:month => 12, :day => 31)
216 alias :at_end_of_year :end_of_year
218 # Convenience method which returns a new Date/DateTime representing the time 1 day ago
223 # Convenience method which returns a new Date/DateTime representing the time 1 day since the instance time