Module ActiveSupport::CoreExtensions::Time::Calculations
In: vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb

Enables the use of time calculations within Time itself

Methods

Public Instance methods

Returns a new Time representing the time a number of seconds ago, this is basically a wrapper around the Numeric extension Do not use this method in combination with x.months, use months_ago instead!

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 29
29:         def ago(seconds)
30:           seconds.until(self)
31:         end
at_beginning_of_day()

Alias for beginning_of_day

at_beginning_of_month()

Alias for beginning_of_month

at_beginning_of_week()

Alias for beginning_of_week

at_beginning_of_year()

Alias for beginning_of_year

at_midnight()

Alias for beginning_of_day

Returns a new Time representing the start of the day (0:00)

[Source]

     # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 103
103:         def beginning_of_day
104:           self - self.seconds_since_midnight
105:         end

Returns a new Time representing the start of the month (1st of the month, 0:00)

[Source]

     # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 111
111:         def beginning_of_month
112:           #self - ((self.mday-1).days + self.seconds_since_midnight)
113:           change(:mday => 1,:hour => 0, :min => 0, :sec => 0, :usec => 0)
114:         end

Returns a new Time representing the "start" of this week (Monday, 0:00)

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 89
89:         def beginning_of_week
90:           days_to_monday = self.wday!=0 ? self.wday-1 : 6
91:           (self - days_to_monday.days).midnight
92:         end

Returns a new Time representing the start of the year (1st of january, 0:00)

[Source]

     # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 118
118:         def beginning_of_year
119:           change(:month => 1,:mday => 1,:hour => 0, :min => 0, :sec => 0, :usec => 0)
120:         end

Returns a new Time where one or more of the elements have been changed according to the options parameter. The time options (hour, minute, sec, usec) reset cascadingly, so if only the hour is passed, then minute, sec, and usec is set to 0. If the hour and minute is passed, then sec and usec is set to 0.

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 14
14:         def change(options)
15:           ::Time.send(
16:             self.utc? ? :utc : :local, 
17:             options[:year]  || self.year, 
18:             options[:month] || self.month, 
19:             options[:mday]  || self.mday, 
20:             options[:hour]  || self.hour, 
21:             options[:min]   || (options[:hour] ? 0 : self.min),
22:             options[:sec]   || ((options[:hour] || options[:min]) ? 0 : self.sec),
23:             options[:usec]  || ((options[:hour] || options[:min] || options[:usec]) ? 0 : self.usec)
24:           )
25:         end
in(seconds)

Alias for since

Short-hand for months_ago(1)

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 79
79:         def last_month
80:           months_ago(1)
81:         end

Short-hand for years_ago(1)

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 68
68:         def last_year
69:           years_ago(1)
70:         end
midnight()

Alias for beginning_of_day

monday()

Alias for beginning_of_week

Returns a new Time representing the time a number of specified months ago

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 41
41:         def months_ago(months)
42:           if months >= self.month 
43:             change(:year => self.year - 1, :month => 12).months_ago(months - self.month)
44:           else
45:             change(:year => self.year, :month => self.month - months)
46:           end
47:         end

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 49
49:         def months_since(months)
50:           if months + self.month > 12
51:             old_time = self
52:             change(:year => self.year + 1, :month => 1).months_since(months + old_time.month - 12 - 1)
53:           else
54:             change(:year => self.year, :month => self.month + months)
55:           end
56:         end

Short-hand for months_since(1)

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 84
84:         def next_month
85:           months_since(1)
86:         end

Returns a new Time representing the start of the given day in next week (default is Monday).

[Source]

     # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 97
 97:         def next_week(day = :monday)
 98:           days_into_week = { :monday => 0, :tuesday => 1, :wednesday => 2, :thursday => 3, :friday => 4, :saturday => 5, :sunday => 6}
 99:           since(1.week).beginning_of_week.since(days_into_week[day].day).change(:hour => 0)
100:         end

Short-hand for years_since(1)

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 73
73:         def next_year
74:           years_since(1)
75:         end

Seconds since midnight: Time.now.seconds_since_midnight

[Source]

   # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 7
7:         def seconds_since_midnight
8:           self.hour.hours + self.min.minutes + self.sec + (self.usec/1.0e+6)
9:         end
 Returns a new Time representing the time a number of seconds since the instance time, this is basically a wrapper around

the Numeric extension. Do not use this method in combination with x.months, use months_since instead!

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 35
35:         def since(seconds)
36:           seconds.since(self)
37:         end

Convenience method which returns a new Time representing the time 1 day since the instance time

[Source]

     # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 129
129:         def tomorrow
130:           self.since(1.day)
131:         end

Returns a new Time representing the time a number of specified years ago

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 59
59:         def years_ago(years)
60:           change(:year => self.year - years)
61:         end

[Source]

    # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 63
63:         def years_since(years)
64:           change(:year => self.year + years)
65:         end

Convenience method which returns a new Time representing the time 1 day ago

[Source]

     # File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 124
124:         def yesterday
125:           self.ago(1.day)
126:         end

[Validate]