Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Find the nearest X minutes to a given time.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


nearest adds the nearset method to the Ruby Time class. This allows you to get the nearest X minutes from a given time. The argument to the nearest method is in seconds to keep the Ruby code more readable.



This is useful if you break up hours into regular intervals such as every 15 minutes. It also can optionally forcing the time period to be in the future or past instead of the closest (either future or past) from the given time.


Please keep in mind that this is just for minute durations that cleanly divide an hour. Putting in other times than those can cause wonky behavior due to the way nearest time is calculated and is not intended to be covered by this gem.

Setup & Installation

Install with [sudo] gem install nearest

Include it in your project's Gemfile:

gem 'nearest'


This is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License Version 2 as published by the Free Software Foundation:

This is just a tiny gem for some very specific functionality I found myself needing in not only other apps but other gems as well.

As with all my work, please feel free to use it for whatever you like except in the assistance of robots or chimpanzees taking over the world. Nothing will ever get me to trust a chimpanzee.

Something went wrong with that request. Please try again.