TimeSlice is a Ruby gem that provides functionality for creating, manipulating, and querying time ranges with specified durations. It's particularly useful for working with time-based data in applications that require precise time interval handling.

Add this line to your application's Gemfile:

gem 'time_slice'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install time_slice

The TimeSlice class represents a range of time divided into equal intervals.

TimeSlice.new(period, options = {})

• period: A string representing the duration of each interval (e.g., "1h" for 1 hour, "30m" for 30 minutes)
• options: A hash that can include :from (start time), :to (end time), and/or :length (number of intervals)

# Create a range from 12:00 to 15:00 with 1-hour intervals
range = TimeSlice.new("1h", from: "2019-01-06 12:00", to: "2019-01-06 15:00")

range.length  # => 4 (12-13, 13-14, 14-15, 15-16)
range.index("2019-01-06 14:30:00")  # => 2
range.to_a.last  # => [2019-01-06 15:00:00, 2019-01-06 16:00:00]

# Iterate over the intervals
range.each do |start_time, end_time|
  puts "#{start_time} - #{end_time}"
end

# Get previous intervals
prev_range = range.previous("2019-01-06 13:00", 2)

The TimeSlice::Duration class extends ActiveSupport::Duration to provide a more flexible way of specifying and working with time durations.

• s: seconds
• m: minutes
• h: hours
• d: days
• w: weeks
• mo: months
• y: years

TimeSlice::Duration.new("5m")  # => 5 minutes
TimeSlice::Duration.new("2h")  # => 2 hours
TimeSlice::Duration.new("1d")  # => 1 day

duration = TimeSlice::Duration.new("3h")
duration.unit  # => :hours
duration.period  # => "3h"
duration * 2  # => 21600 (number of seconds in 6 hours)

• activesupport
• rounding

The gem is available as open source under the terms of the MIT License.