diff options
author | Tom Lea <commit@tomlea.co.uk> | 2008-09-11 16:41:19 +0100 |
---|---|---|
committer | gbuesing <gbuesing@gmail.com> | 2008-10-13 20:00:09 -0500 |
commit | d599b8000968047b4095dd8ff6c8ef10bb4ed462 (patch) | |
tree | 97ff0ef8ef8aa110748ec24da71d3c56568b6b53 /activesupport/lib/active_support/core_ext/integer/time.rb | |
parent | 27c70ff386e76ed0af41b53f2ba8cdb09bc94ace (diff) | |
download | rails-d599b8000968047b4095dd8ff6c8ef10bb4ed462.tar.gz rails-d599b8000968047b4095dd8ff6c8ef10bb4ed462.tar.bz2 rails-d599b8000968047b4095dd8ff6c8ef10bb4ed462.zip |
Deprecated Float#years and Float#months, moved Numeric#years and Numeric#months into Integer.
Diffstat (limited to 'activesupport/lib/active_support/core_ext/integer/time.rb')
-rw-r--r-- | activesupport/lib/active_support/core_ext/integer/time.rb | 45 |
1 files changed, 45 insertions, 0 deletions
diff --git a/activesupport/lib/active_support/core_ext/integer/time.rb b/activesupport/lib/active_support/core_ext/integer/time.rb new file mode 100644 index 0000000000..356e145b90 --- /dev/null +++ b/activesupport/lib/active_support/core_ext/integer/time.rb @@ -0,0 +1,45 @@ +module ActiveSupport #:nodoc: + module CoreExtensions #:nodoc: + module Integer #:nodoc: + # Enables the use of time calculations and declarations, like 45.minutes + 2.hours + 4.years. + # + # These methods use Time#advance for precise date calculations when using from_now, ago, etc. + # as well as adding or subtracting their results from a Time object. For example: + # + # # equivalent to Time.now.advance(:months => 1) + # 1.month.from_now + # + # # equivalent to Time.now.advance(:years => 2) + # 2.years.from_now + # + # # equivalent to Time.now.advance(:months => 4, :years => 5) + # (4.months + 5.years).from_now + # + # While these methods provide precise calculation when used as in the examples above, care + # should be taken to note that this is not true if the result of `months', `years', etc is + # converted before use: + # + # # equivalent to 30.days.to_i.from_now + # 1.month.to_i.from_now + # + # # equivalent to 365.25.days.to_f.from_now + # 1.year.to_f.from_now + # + # In such cases, Ruby's core + # Date[http://stdlib.rubyonrails.org/libdoc/date/rdoc/index.html] and + # Time[http://stdlib.rubyonrails.org/libdoc/time/rdoc/index.html] should be used for precision + # date and time arithmetic + module Time + def months + ActiveSupport::Duration.new(self * 30.days, [[:months, self]]) + end + alias :month :months + + def years + ActiveSupport::Duration.new(self * 365.25.days, [[:years, self]]) + end + alias :year :years + end + end + end +end |