Skip to main content
Very Popular
Latest
File
import toDate from '../toDate/index.ts'import toInteger from '../_lib/toInteger/index.ts'
/** * @name roundToNearestMinutes * @category Minute Helpers * @summary Rounds the given date to the nearest minute * * @description * Rounds the given date to the nearest minute (or number of minutes). * Rounds up when the given date is exactly between the nearest round minutes. * * ### v2.0.0 breaking changes: * * - [Changes that are common for the whole library](https://github.com/date-fns/date-fns/blob/master/docs/upgradeGuide.md#Common-Changes). * * @param {Date|Number} date - the date to round * @param {Object} [options] - an object with options. * @param {Number} [options.nearestTo=1] - nearest number of minutes to round to. E.g. `15` to round to quarter hours. * @returns {Date} the new date rounded to the closest minute * @throws {TypeError} 1 argument required * @throws {RangeError} `options.nearestTo` must be between 1 and 30 * * @example * // Round 10 July 2014 12:12:34 to nearest minute: * var result = roundToNearestMinutes(new Date(2014, 6, 10, 12, 12, 34)) * //=> Thu Jul 10 2014 12:13:00 * * @example * // Round 10 July 2014 12:07:30 to nearest quarter hour: * var result = roundToNearestMinutes(new Date(2014, 6, 10, 12, 12, 34), { nearestTo: 15 }) * // rounds up because given date is exactly between 12:00:00 and 12:15:00 * //=> Thu Jul 10 2014 12:15:00 */export default function roundToNearestMinutes(dirtyDate, options) { if (arguments.length < 1) { throw new TypeError('1 argument required, but only none provided present') }
var nearestTo = options && 'nearestTo' in options ? toInteger(options.nearestTo) : 1
if (nearestTo < 1 || nearestTo > 30) { throw new RangeError('`options.nearestTo` must be between 1 and 30') }
var date = toDate(dirtyDate) var seconds = date.getSeconds() // relevant if nearestTo is 1, which is the default case var minutes = date.getMinutes() + seconds / 60 var roundedMinutes = Math.floor(minutes / nearestTo) * nearestTo var remainderMinutes = minutes % nearestTo var addedMinutes = Math.round(remainderMinutes / nearestTo) * nearestTo
return new Date( date.getFullYear(), date.getMonth(), date.getDate(), date.getHours(), roundedMinutes + addedMinutes )}