distance_of_time_in_words(from_time, to_time = 0, options = {})
Instance Public methods
Reports the approximate distance in time between two Time, Date or DateTime objects or integers as seconds.
Pass include_seconds: true if you want more detailed
approximations when distance < 1 min, 29 secs. Distances are reported
based on the following table:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | 0 <-> 29 secs # => less than a minute30 secs <-> 1 min, 29 secs # => 1 minute1 min, 30 secs <-> 44 mins, 29 secs # => [2..44] minutes44 mins, 30 secs <-> 89 mins, 29 secs # => about 1 hour89 mins, 30 secs <-> 23 hrs, 59 mins, 29 secs # => about [2..24] hours23 hrs, 59 mins, 30 secs <-> 41 hrs, 59 mins, 29 secs # => 1 day41 hrs, 59 mins, 30 secs <-> 29 days, 23 hrs, 59 mins, 29 secs # => [2..29] days29 days, 23 hrs, 59 mins, 30 secs <-> 44 days, 23 hrs, 59 mins, 29 secs # => about 1 month44 days, 23 hrs, 59 mins, 30 secs <-> 59 days, 23 hrs, 59 mins, 29 secs # => about 2 months59 days, 23 hrs, 59 mins, 30 secs <-> 1 yr minus 1 sec # => [2..12] months1 yr <-> 1 yr, 3 months # => about 1 year1 yr, 3 months <-> 1 yr, 9 months # => over 1 year1 yr, 9 months <-> 2 yr minus 1 sec # => almost 2 years2 yrs <-> max time or date # => (same rules as 1 yr) |
With include_seconds: true and the difference < 1 minute 29
seconds:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | 0-4 secs # => less than 5 seconds5-9 secs # => less than 10 seconds10-19 secs # => less than 20 seconds20-39 secs # => half a minute40-59 secs # => less than a minute60-89 secs # => 1 minutefrom_time = Time.nowdistance_of_time_in_words(from_time, from_time + 50.minutes) # => about 1 hourdistance_of_time_in_words(from_time, 50.minutes.from_now) # => about 1 hourdistance_of_time_in_words(from_time, from_time + 15.seconds) # => less than a minutedistance_of_time_in_words(from_time, from_time + 15.seconds, include_seconds: true) # => less than 20 secondsdistance_of_time_in_words(from_time, 3.years.from_now) # => about 3 yearsdistance_of_time_in_words(from_time, from_time + 60.hours) # => 3 daysdistance_of_time_in_words(from_time, from_time + 45.seconds, include_seconds: true) # => less than a minutedistance_of_time_in_words(from_time, from_time - 45.seconds, include_seconds: true) # => less than a minutedistance_of_time_in_words(from_time, 76.seconds.from_now) # => 1 minutedistance_of_time_in_words(from_time, from_time + 1.year + 3.days) # => about 1 yeardistance_of_time_in_words(from_time, from_time + 3.years + 6.months) # => over 3 yearsdistance_of_time_in_words(from_time, from_time + 4.years + 9.days + 30.minutes + 5.seconds) # => about 4 yearsto_time = Time.now + 6.years + 19.daysdistance_of_time_in_words(from_time, to_time, include_seconds: true) # => about 6 yearsdistance_of_time_in_words(to_time, from_time, include_seconds: true) # => about 6 yearsdistance_of_time_in_words(Time.now, Time.now) # => less than a minute |
Please login to continue.