ricoli/nearest

Gives the nearest timestamp by X seconds

dev-master 2017-11-03 15:46 UTC

This package is not auto-updated.

Last update: 2024-05-05 06:05:53 UTC


README

#nearest

Build Status Total Downloads

Gives the nearest timestamp by X seconds. Inspired by the ruby project with the same name.

##Example

$nearest = new \Ricoli\Nearest\Nearest();
$nearestTimestamp = $nearest->getNearestTimestamp(300, time());

Will give you the closest 5 minutes from now, defaulting to the PHP_ROUND_HALF_UP rounding mode. So if the current time is 13:02:30, it would return 13:05:00 (in its timestamp form). Supports the following modes: PHP_ROUND_HALF_UP, PHP_ROUND_HALF_DOWN, Nearest::NEAREST_CEIL, Nearest::NEAREST_FLOOR. The mode can be provided as the third argument:

$nearest = new \Ricoli\Nearest\Nearest();
$nearestTimestamp = $nearest->getNearestTimestamp(300, time(), PHP_ROUND_HALF_DOWN);

##Add it your your application!

Add to your composer.json:

"require": {
    ...
    "ricoli/nearest": "dev-master"
}

https://packagist.org/packages/ricoli/nearest