umt 2.16.0 → 2.17.0

package/module/es5/Date/addDuration.d.ts

@@ -0,0 +1,15 @@
+import type { DurationUnit } from "./durationUnit";
+/**
+ * Adds a duration to a date and returns a new Date.
+ * Calendar-aware for "M" (months) and "y" (years), so end-of-month
+ * is preserved (e.g. Jan 31 + 1 month = Feb 28/29).
+ *
+ * @param {Date} date - Base date
+ * @param {number} amount - Amount to add (can be negative)
+ * @param {DurationUnit} unit - Unit of the amount
+ * @returns {Date} A new Date with the duration added
+ * @example
+ * addDuration(new Date("2025-01-31"), 1, "M"); // 2025-02-28
+ * addDuration(new Date("2025-01-01"), 7, "d"); // 2025-01-08
+ */
+export declare const addDuration: (date: Date, amount: number, unit: DurationUnit) => Date;

package/module/es5/Date/addDuration.js

@@ -0,0 +1,45 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.addDuration = void 0;
+var _msByUnit = require("./msByUnit");
+/**
+ * Adds a duration to a date and returns a new Date.
+ * Calendar-aware for "M" (months) and "y" (years), so end-of-month
+ * is preserved (e.g. Jan 31 + 1 month = Feb 28/29).
+ *
+ * @param {Date} date - Base date
+ * @param {number} amount - Amount to add (can be negative)
+ * @param {DurationUnit} unit - Unit of the amount
+ * @returns {Date} A new Date with the duration added
+ * @example
+ * addDuration(new Date("2025-01-31"), 1, "M"); // 2025-02-28
+ * addDuration(new Date("2025-01-01"), 7, "d"); // 2025-01-08
+ */
+var addDuration = exports.addDuration = function addDuration(date, amount, unit) {
+  var ms = _msByUnit.msByUnit[unit];
+  if (ms !== undefined) {
+    return new Date(date.getTime() + amount * ms);
+  }
+  var result = new Date(date);
+  if (unit === "M") {
+    var targetMonth = result.getMonth() + amount;
+    var _day = result.getDate();
+    result.setDate(1);
+    result.setMonth(targetMonth);
+    var _lastDayOfTargetMonth = new Date(result.getFullYear(), result.getMonth() + 1, 0).getDate();
+    result.setDate(Math.min(_day, _lastDayOfTargetMonth));
+    return result;
+  }
+  var targetYear = result.getFullYear() + amount;
+  var month = result.getMonth();
+  var day = result.getDate();
+  result.setDate(1);
+  result.setFullYear(targetYear);
+  result.setMonth(month);
+  var lastDayOfTargetMonth = new Date(targetYear, month + 1, 0).getDate();
+  result.setDate(Math.min(day, lastDayOfTargetMonth));
+  return result;
+};

package/module/es5/Date/diff.d.ts

@@ -0,0 +1,14 @@
+import type { DurationUnit } from "./durationUnit";
+/**
+ * Returns the difference between two dates in the given unit, truncated toward zero.
+ * Calendar-aware for "M" (months) and "y" (years).
+ *
+ * @param {Date} left - End date
+ * @param {Date} right - Start date
+ * @param {DurationUnit} unit - Unit of the result
+ * @returns {number} The difference, truncated toward zero
+ * @example
+ * diff(new Date("2025-12-31"), new Date("2025-01-01"), "d"); // 364
+ * diff(new Date("2026-01-01"), new Date("2025-01-01"), "y"); // 1
+ */
+export declare const diff: (left: Date, right: Date, unit: DurationUnit) => number;

package/module/es5/Date/diff.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.diff = void 0;
+var _clock = require("../Consts/clock");
+var _msByUnit = require("./msByUnit");
+/**
+ * Returns the difference between two dates in the given unit, truncated toward zero.
+ * Calendar-aware for "M" (months) and "y" (years).
+ *
+ * @param {Date} left - End date
+ * @param {Date} right - Start date
+ * @param {DurationUnit} unit - Unit of the result
+ * @returns {number} The difference, truncated toward zero
+ * @example
+ * diff(new Date("2025-12-31"), new Date("2025-01-01"), "d"); // 364
+ * diff(new Date("2026-01-01"), new Date("2025-01-01"), "y"); // 1
+ */
+var diff = exports.diff = function diff(left, right, unit) {
+  var ms = _msByUnit.msByUnit[unit];
+  if (ms !== undefined) {
+    return Math.trunc((left.getTime() - right.getTime()) / ms);
+  }
+  var yearsDelta = left.getFullYear() - right.getFullYear();
+  var monthsDelta = left.getMonth() - right.getMonth();
+  var dayDelta = left.getDate() - right.getDate();
+  var subDayDelta = left.getHours() * _clock.OneHourMs + left.getMinutes() * _clock.OneMinuteMs + left.getSeconds() * _clock.OneSecondMs + left.getMilliseconds() - (right.getHours() * _clock.OneHourMs + right.getMinutes() * _clock.OneMinuteMs + right.getSeconds() * _clock.OneSecondMs + right.getMilliseconds());
+  var calendarMonths = yearsDelta * 12 + monthsDelta;
+  if (calendarMonths > 0 && (dayDelta < 0 || dayDelta === 0 && subDayDelta < 0)) {
+    calendarMonths -= 1;
+  } else if (calendarMonths < 0 && (dayDelta > 0 || dayDelta === 0 && subDayDelta > 0)) {
+    calendarMonths += 1;
+  }
+  if (unit === "M") {
+    return calendarMonths;
+  }
+  return Math.trunc(calendarMonths / 12);
+};

package/module/es5/Date/durationUnit.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Supported duration units for date arithmetic.
+ * - ms: milliseconds
+ * - s: seconds
+ * - m: minutes
+ * - h: hours
+ * - d: days
+ * - w: weeks
+ * - M: months (calendar-aware)
+ * - y: years (calendar-aware)
+ */
+export type DurationUnit = "ms" | "s" | "m" | "h" | "d" | "w" | "M" | "y";

package/module/es5/Date/durationUnit.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/module/es5/Date/endOf.d.ts

@@ -0,0 +1,13 @@
+import type { DateBoundaryUnit } from "./startOf";
+/**
+ * Returns a new Date set to the end of the given unit.
+ * Week ends on Saturday at 23:59:59.999.
+ *
+ * @param {Date} date - Base date
+ * @param {DateBoundaryUnit} unit - Boundary unit
+ * @returns {Date} A new Date at the end of the specified unit
+ * @example
+ * endOf(new Date("2025-04-15T10:30:00"), "day"); // 2025-04-15T23:59:59.999
+ * endOf(new Date("2025-04-15"), "month"); // 2025-04-30T23:59:59.999
+ */
+export declare const endOf: (date: Date, unit: DateBoundaryUnit) => Date;

package/module/es5/Date/endOf.js

@@ -0,0 +1,72 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.endOf = void 0;
+/**
+ * Returns a new Date set to the end of the given unit.
+ * Week ends on Saturday at 23:59:59.999.
+ *
+ * @param {Date} date - Base date
+ * @param {DateBoundaryUnit} unit - Boundary unit
+ * @returns {Date} A new Date at the end of the specified unit
+ * @example
+ * endOf(new Date("2025-04-15T10:30:00"), "day"); // 2025-04-15T23:59:59.999
+ * endOf(new Date("2025-04-15"), "month"); // 2025-04-30T23:59:59.999
+ */
+var endOf = exports.endOf = function endOf(date, unit) {
+  var result = new Date(date);
+  switch (unit) {
+    case "second":
+      {
+        result.setMilliseconds(999);
+        return result;
+      }
+    case "minute":
+      {
+        result.setSeconds(59, 999);
+        return result;
+      }
+    case "hour":
+      {
+        result.setMinutes(59, 59, 999);
+        return result;
+      }
+    case "day":
+      {
+        result.setHours(23, 59, 59, 999);
+        return result;
+      }
+    case "week":
+      {
+        var dayOfWeek = result.getDay();
+        result.setDate(result.getDate() + (6 - dayOfWeek));
+        result.setHours(23, 59, 59, 999);
+        return result;
+      }
+    case "month":
+      {
+        result.setMonth(result.getMonth() + 1, 0);
+        result.setHours(23, 59, 59, 999);
+        return result;
+      }
+    case "quarter":
+      {
+        var quarterEndMonth = Math.floor(result.getMonth() / 3) * 3 + 2;
+        result.setMonth(quarterEndMonth + 1, 0);
+        result.setHours(23, 59, 59, 999);
+        return result;
+      }
+    case "year":
+      {
+        result.setMonth(11, 31);
+        result.setHours(23, 59, 59, 999);
+        return result;
+      }
+    default:
+      {
+        return result;
+      }
+  }
+};

package/module/es5/Date/formatRelative.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Formats a date relative to a base date using Intl.RelativeTimeFormat.
+ * Picks the largest unit that fits the absolute delta.
+ *
+ * @param {Date} date - The target date
+ * @param {Date} [baseDate=new Date()] - Reference date (defaults to now)
+ * @param {string} [locale] - BCP 47 locale tag; uses system locale if omitted
+ * @returns {string} Localized relative-time string
+ * @example
+ * formatRelative(new Date(Date.now() - 3600_000), new Date(), "en"); // "1 hour ago"
+ * formatRelative(new Date(Date.now() + 86_400_000), new Date(), "ja"); // "1 日後"
+ */
+export declare const formatRelative: (date: Date, baseDate?: Date, locale?: string) => string;

package/module/es5/Date/formatRelative.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.formatRelative = void 0;
+var _clock = require("../Consts/clock");
+var THRESHOLDS = [{
+  unit: "year",
+  ms: _clock.OneYearMs
+}, {
+  unit: "month",
+  ms: _clock.OneMonthMs
+}, {
+  unit: "week",
+  ms: _clock.OneWeekMs
+}, {
+  unit: "day",
+  ms: _clock.OneDayMs
+}, {
+  unit: "hour",
+  ms: _clock.OneHourMs
+}, {
+  unit: "minute",
+  ms: _clock.OneMinuteMs
+}, {
+  unit: "second",
+  ms: _clock.OneSecondMs
+}];
+
+/**
+ * Formats a date relative to a base date using Intl.RelativeTimeFormat.
+ * Picks the largest unit that fits the absolute delta.
+ *
+ * @param {Date} date - The target date
+ * @param {Date} [baseDate=new Date()] - Reference date (defaults to now)
+ * @param {string} [locale] - BCP 47 locale tag; uses system locale if omitted
+ * @returns {string} Localized relative-time string
+ * @example
+ * formatRelative(new Date(Date.now() - 3600_000), new Date(), "en"); // "1 hour ago"
+ * formatRelative(new Date(Date.now() + 86_400_000), new Date(), "ja"); // "1 日後"
+ */
+var formatRelative = exports.formatRelative = function formatRelative(date) {
+  var baseDate = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : new Date();
+  var locale = arguments.length > 2 ? arguments[2] : undefined;
+  var deltaMs = date.getTime() - baseDate.getTime();
+  var absDelta = Math.abs(deltaMs);
+  var formatter = new Intl.RelativeTimeFormat(locale, {
+    numeric: "auto"
+  });
+  for (var _i = 0, _THRESHOLDS = THRESHOLDS; _i < _THRESHOLDS.length; _i++) {
+    var _THRESHOLDS$_i = _THRESHOLDS[_i],
+      unit = _THRESHOLDS$_i.unit,
+      ms = _THRESHOLDS$_i.ms;
+    if (absDelta >= ms) {
+      var value = Math.round(deltaMs / ms);
+      return formatter.format(value, unit);
+    }
+  }
+  return formatter.format(0, "second");
+};

package/module/es5/Date/index.d.ts

@@ -1,9 +1,19 @@
+export * from "./addDuration";
 export * from "./birthday";
 export * from "./dateRange";
 export * from "./dayOfWeek";
+export * from "./diff";
+export * from "./durationUnit";
+export * from "./endOf";
 export * from "./format";
+export * from "./formatRelative";
 export * from "./getDay";
 export * from "./getTimezoneOffsetString";
+export * from "./isBusinessDay";
 export * from "./isLeapYear";
+export * from "./isSameDay";
+export * from "./isWeekend";
 export * from "./new";
 export * from "./now";
+export * from "./startOf";
+export * from "./subDuration";

package/module/es5/Date/index.js

@@ -3,6 +3,17 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+var _addDuration = require("./addDuration");
+Object.keys(_addDuration).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _addDuration[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _addDuration[key];
+    }
+  });
+});
 var _birthday = require("./birthday");
 Object.keys(_birthday).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -36,6 +47,39 @@ Object.keys(_dayOfWeek).forEach(function (key) {
     }
   });
 });
+var _diff = require("./diff");
+Object.keys(_diff).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _diff[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _diff[key];
+    }
+  });
+});
+var _durationUnit = require("./durationUnit");
+Object.keys(_durationUnit).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _durationUnit[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _durationUnit[key];
+    }
+  });
+});
+var _endOf = require("./endOf");
+Object.keys(_endOf).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _endOf[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _endOf[key];
+    }
+  });
+});
 var _format = require("./format");
 Object.keys(_format).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -47,6 +91,17 @@ Object.keys(_format).forEach(function (key) {
     }
   });
 });
+var _formatRelative = require("./formatRelative");
+Object.keys(_formatRelative).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatRelative[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _formatRelative[key];
+    }
+  });
+});
 var _getDay = require("./getDay");
 Object.keys(_getDay).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -69,6 +124,17 @@ Object.keys(_getTimezoneOffsetString).forEach(function (key) {
     }
   });
 });
+var _isBusinessDay = require("./isBusinessDay");
+Object.keys(_isBusinessDay).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _isBusinessDay[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _isBusinessDay[key];
+    }
+  });
+});
 var _isLeapYear = require("./isLeapYear");
 Object.keys(_isLeapYear).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -80,6 +146,28 @@ Object.keys(_isLeapYear).forEach(function (key) {
     }
   });
 });
+var _isSameDay = require("./isSameDay");
+Object.keys(_isSameDay).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _isSameDay[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _isSameDay[key];
+    }
+  });
+});
+var _isWeekend = require("./isWeekend");
+Object.keys(_isWeekend).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _isWeekend[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _isWeekend[key];
+    }
+  });
+});
 var _new = require("./new");
 Object.keys(_new).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -101,4 +189,26 @@ Object.keys(_now).forEach(function (key) {
       return _now[key];
     }
   });
+});
+var _startOf = require("./startOf");
+Object.keys(_startOf).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _startOf[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _startOf[key];
+    }
+  });
+});
+var _subDuration = require("./subDuration");
+Object.keys(_subDuration).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _subDuration[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _subDuration[key];
+    }
+  });
 });

package/module/es5/Date/isBusinessDay.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns true when the given date is a weekday and not in the holidays list.
+ * @param {Date} date - The date to check
+ * @param {Date[]} [holidays=[]] - Optional list of holiday dates
+ * @returns {boolean} True when weekday and not a listed holiday
+ * @example
+ * isBusinessDay(new Date("2025-04-21")); // true (Monday)
+ * isBusinessDay(new Date("2025-04-21"), [new Date("2025-04-21")]); // false
+ */
+export declare const isBusinessDay: (date: Date, holidays?: Date[]) => boolean;

package/module/es5/Date/isBusinessDay.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isBusinessDay = void 0;
+var _isSameDay = require("./isSameDay");
+var _isWeekend = require("./isWeekend");
+/**
+ * Returns true when the given date is a weekday and not in the holidays list.
+ * @param {Date} date - The date to check
+ * @param {Date[]} [holidays=[]] - Optional list of holiday dates
+ * @returns {boolean} True when weekday and not a listed holiday
+ * @example
+ * isBusinessDay(new Date("2025-04-21")); // true (Monday)
+ * isBusinessDay(new Date("2025-04-21"), [new Date("2025-04-21")]); // false
+ */
+var isBusinessDay = exports.isBusinessDay = function isBusinessDay(date) {
+  var holidays = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
+  if ((0, _isWeekend.isWeekend)(date)) {
+    return false;
+  }
+  return !holidays.some(function (holiday) {
+    return (0, _isSameDay.isSameDay)(holiday, date);
+  });
+};

package/module/es5/Date/isSameDay.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns true when two dates represent the same calendar day in local time.
+ * @param {Date} left - First date
+ * @param {Date} right - Second date
+ * @returns {boolean} True if same year/month/day in local time
+ * @example
+ * isSameDay(new Date("2025-04-15T01:00"), new Date("2025-04-15T23:00")); // true
+ * isSameDay(new Date("2025-04-15"), new Date("2025-04-16")); // false
+ */
+export declare const isSameDay: (left: Date, right: Date) => boolean;

package/module/es5/Date/isSameDay.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isSameDay = void 0;
+/**
+ * Returns true when two dates represent the same calendar day in local time.
+ * @param {Date} left - First date
+ * @param {Date} right - Second date
+ * @returns {boolean} True if same year/month/day in local time
+ * @example
+ * isSameDay(new Date("2025-04-15T01:00"), new Date("2025-04-15T23:00")); // true
+ * isSameDay(new Date("2025-04-15"), new Date("2025-04-16")); // false
+ */
+var isSameDay = exports.isSameDay = function isSameDay(left, right) {
+  return left.getFullYear() === right.getFullYear() && left.getMonth() === right.getMonth() && left.getDate() === right.getDate();
+};

package/module/es5/Date/isWeekend.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns true when the given date is Saturday or Sunday.
+ * @param {Date} date - The date to check
+ * @returns {boolean} True if Saturday or Sunday, false otherwise
+ * @example
+ * isWeekend(new Date("2025-04-19")); // true (Saturday)
+ * isWeekend(new Date("2025-04-21")); // false (Monday)
+ */
+export declare const isWeekend: (date: Date) => boolean;

package/module/es5/Date/isWeekend.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isWeekend = void 0;
+/**
+ * Returns true when the given date is Saturday or Sunday.
+ * @param {Date} date - The date to check
+ * @returns {boolean} True if Saturday or Sunday, false otherwise
+ * @example
+ * isWeekend(new Date("2025-04-19")); // true (Saturday)
+ * isWeekend(new Date("2025-04-21")); // false (Monday)
+ */
+var isWeekend = exports.isWeekend = function isWeekend(date) {
+  var dayOfWeek = date.getDay();
+  return dayOfWeek === 0 || dayOfWeek === 6;
+};

package/module/es5/Date/msByUnit.d.ts

@@ -0,0 +1,2 @@
+import type { DurationUnit } from "./durationUnit";
+export declare const msByUnit: Partial<Record<DurationUnit, number>>;

package/module/es5/Date/msByUnit.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.msByUnit = void 0;
+var _clock = require("../Consts/clock");
+var msByUnit = exports.msByUnit = {
+  ms: 1,
+  s: _clock.OneSecondMs,
+  m: _clock.OneMinuteMs,
+  h: _clock.OneHourMs,
+  d: _clock.OneDayMs,
+  w: _clock.OneWeekMs
+};

package/module/es5/Date/startOf.d.ts

@@ -0,0 +1,13 @@
+export type DateBoundaryUnit = "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+/**
+ * Returns a new Date set to the start of the given unit.
+ * Week start is Sunday (day 0).
+ *
+ * @param {Date} date - Base date
+ * @param {DateBoundaryUnit} unit - Boundary unit
+ * @returns {Date} A new Date at the start of the specified unit
+ * @example
+ * startOf(new Date("2025-04-15T10:30:00"), "day"); // 2025-04-15T00:00:00
+ * startOf(new Date("2025-04-15"), "month"); // 2025-04-01T00:00:00
+ */
+export declare const startOf: (date: Date, unit: DateBoundaryUnit) => Date;

package/module/es5/Date/startOf.js

@@ -0,0 +1,72 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.startOf = void 0;
+/**
+ * Returns a new Date set to the start of the given unit.
+ * Week start is Sunday (day 0).
+ *
+ * @param {Date} date - Base date
+ * @param {DateBoundaryUnit} unit - Boundary unit
+ * @returns {Date} A new Date at the start of the specified unit
+ * @example
+ * startOf(new Date("2025-04-15T10:30:00"), "day"); // 2025-04-15T00:00:00
+ * startOf(new Date("2025-04-15"), "month"); // 2025-04-01T00:00:00
+ */
+var startOf = exports.startOf = function startOf(date, unit) {
+  var result = new Date(date);
+  switch (unit) {
+    case "second":
+      {
+        result.setMilliseconds(0);
+        return result;
+      }
+    case "minute":
+      {
+        result.setSeconds(0, 0);
+        return result;
+      }
+    case "hour":
+      {
+        result.setMinutes(0, 0, 0);
+        return result;
+      }
+    case "day":
+      {
+        result.setHours(0, 0, 0, 0);
+        return result;
+      }
+    case "week":
+      {
+        var dayOfWeek = result.getDay();
+        result.setDate(result.getDate() - dayOfWeek);
+        result.setHours(0, 0, 0, 0);
+        return result;
+      }
+    case "month":
+      {
+        result.setDate(1);
+        result.setHours(0, 0, 0, 0);
+        return result;
+      }
+    case "quarter":
+      {
+        var quarterStartMonth = Math.floor(result.getMonth() / 3) * 3;
+        result.setMonth(quarterStartMonth, 1);
+        result.setHours(0, 0, 0, 0);
+        return result;
+      }
+    case "year":
+      {
+        result.setMonth(0, 1);
+        result.setHours(0, 0, 0, 0);
+        return result;
+      }
+    default:
+      {
+        return result;
+      }
+  }
+};