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
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!
# File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 29 29: def ago(seconds) 30: seconds.until(self) 31: end
Returns a new Time representing the start of the day (0:00)
# 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)
# 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)
# 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)
# 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.
# 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
Short-hand for months_ago(1)
# File vendor/rails/activesupport/lib/active_support/core_ext/time/calculations.rb, line 79 79: def last_month 80: months_ago(1) 81: end
Returns a new Time representing the time a number of specified months ago
# 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
# 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)
# 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).
# 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)
# 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
# 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!
# 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
# 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
# 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
# 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