@alexstukovnikov/oz-time 1.0.0 → 1.0.2

package/src/utils/calendar.js

@@ -0,0 +1,277 @@
+import { normalizeUnit, isFixedUnit, unitToMilliseconds } from './units.js';
+import { OzTime } from '../core/core.js';
+
+/**
+ * Календарные утилиты для работы с датами, високосными годами
+ * и разницей между значениями времени.
+ *
+ * @module utils/calendar
+ */
+
+/**
+ * Проверяет корректность timestamp.
+ *
+ * @private
+ * @param {number} timestamp - Unix timestamp в миллисекундах.
+ * @param {string} name - Имя вызывающей функции.
+ * @throws {TypeError} Выбрасывается, если timestamp некорректен.
+ * @returns {void}
+ */
+function assertValidTimestamp(timestamp, name) {
+    if (typeof timestamp !== 'number' || Number.isNaN(timestamp)) {
+        throw new TypeError(`${name}: timestamp must be a valid number`);
+    }
+}
+
+/**
+ * Проверяет корректность количества единиц времени.
+ *
+ * @private
+ * @param {number} amount - Количество единиц времени.
+ * @param {string} name - Имя вызывающей функции.
+ * @throws {TypeError} Выбрасывается, если amount некорректен.
+ * @returns {void}
+ */
+function assertValidAmount(amount, name) {
+    if (typeof amount !== 'number' || Number.isNaN(amount)) {
+        throw new TypeError(`${name}: amount must be a valid number`);
+    }
+}
+
+/**
+ * Проверяет, является ли значение экземпляром OzTime.
+ *
+ * @private
+ * @param {*} value - Проверяемое значение.
+ * @param {string} name - Имя параметра.
+ * @throws {TypeError} Выбрасывается, если значение не является экземпляром OzTime.
+ * @returns {void}
+ */
+function assertOzTime(value, name) {
+    if (!(value instanceof OzTime)) {
+        throw new TypeError(`${name} must be OzTime`);
+    }
+}
+
+/**
+ * Вычисляет календарную разницу в месяцах между двумя timestamp.
+ *
+ * @private
+ * @param {number} leftTimestamp - Левый timestamp.
+ * @param {number} rightTimestamp - Правый timestamp.
+ * @returns {number} Разница в месяцах.
+ */
+function diffInMonths(leftTimestamp, rightTimestamp) {
+    const left = new Date(leftTimestamp);
+    const right = new Date(rightTimestamp);
+
+    let months = (left.getUTCFullYear() - right.getUTCFullYear()) * 12 + (left.getUTCMonth() - right.getUTCMonth());
+
+    const leftDay = left.getUTCDate();
+    const rightDay = right.getUTCDate();
+
+    if (months > 0 && leftDay < rightDay) {
+        months -= 1;
+    } else if (months < 0 && leftDay > rightDay) {
+        months += 1;
+    }
+
+    return months;
+}
+
+/**
+ * Вычисляет календарную разницу в годах между двумя timestamp.
+ *
+ * @private
+ * @param {number} leftTimestamp - Левый timestamp.
+ * @param {number} rightTimestamp - Правый timestamp.
+ * @returns {number} Разница в годах.
+ */
+function diffInYears(leftTimestamp, rightTimestamp) {
+    const left = new Date(leftTimestamp);
+    const right = new Date(rightTimestamp);
+
+    let years = left.getUTCFullYear() - right.getUTCFullYear();
+
+    const leftMonth = left.getUTCMonth();
+    const rightMonth = right.getUTCMonth();
+    const leftDay = left.getUTCDate();
+    const rightDay = right.getUTCDate();
+
+    if (years > 0 && (leftMonth < rightMonth || (leftMonth === rightMonth && leftDay < rightDay))) {
+        years -= 1;
+    } else if (years < 0 && (leftMonth > rightMonth || (leftMonth === rightMonth && leftDay > rightDay))) {
+        years += 1;
+    }
+
+    return years;
+}
+
+/**
+ * Проверяет, является ли год високосным по григорианскому календарю.
+ *
+ * @param {number} year - Год.
+ * @throws {TypeError} Выбрасывается, если year не является целым числом.
+ * @returns {boolean} `true`, если год високосный.
+ * @example
+ * import { isLeapYear } from '@alexstukovnikov/oz-time';
+ *
+ * console.log(isLeapYear(2024)); // ожидаемый результат: true
+ */
+export function isLeapYear(year) {
+    if (!Number.isInteger(year)) {
+        throw new TypeError('isLeapYear: year must be an integer');
+    }
+
+    return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+}
+
+/**
+ * Возвращает количество дней в указанном месяце указанного года.
+ *
+ * @param {number} year - Год.
+ * @param {number} month - Месяц от 1 до 12.
+ * @throws {TypeError} Выбрасывается, если year или month не являются целыми числами.
+ * @throws {RangeError} Выбрасывается, если month вне диапазона от 1 до 12.
+ * @returns {number} Количество дней в месяце.
+ * @example
+ * import { daysInMonth } from '@alexstukovnikov/oz-time';
+ *
+ * console.log(daysInMonth(2024, 2)); // ожидаемый результат: 29
+ */
+export function daysInMonth(year, month) {
+    if (!Number.isInteger(year) || !Number.isInteger(month)) {
+        throw new TypeError('daysInMonth: year and month must be integers');
+    }
+
+    if (month < 1 || month > 12) {
+        throw new RangeError('daysInMonth: month must be between 1 and 12');
+    }
+
+    return new Date(Date.UTC(year, month, 0)).getUTCDate();
+}
+
+/**
+ * Возвращает новый timestamp, увеличенный на указанное количество
+ * фиксированных единиц времени.
+ *
+ * @param {number} timestamp - Unix timestamp в миллисекундах.
+ * @param {number} amount - Количество единиц времени.
+ * @param {string} unit - Фиксированная единица времени.
+ * @throws {TypeError} Выбрасывается, если timestamp или amount некорректны.
+ * @throws {Error} Выбрасывается, если unit не является фиксированной единицей.
+ * @returns {number} Новый Unix timestamp в миллисекундах.
+ * @example
+ * import { addByFixedUnit } from './utils/calendar.js';
+ *
+ * console.log(addByFixedUnit(1716638400000, 1, 'day')); // ожидаемый результат: 1716724800000
+ */
+export function addByFixedUnit(timestamp, amount, unit) {
+    assertValidTimestamp(timestamp, 'addByFixedUnit');
+    assertValidAmount(amount, 'addByFixedUnit');
+
+    const normalizedUnit = normalizeUnit(unit);
+
+    if (!isFixedUnit(normalizedUnit)) {
+        throw new Error(`addByFixedUnit does not support calendar unit: ${unit}`);
+    }
+
+    return timestamp + amount * unitToMilliseconds(normalizedUnit);
+}
+
+/**
+ * Возвращает новый timestamp, увеличенный на указанное количество
+ * календарных единиц времени.
+ *
+ * Поддерживаются только `month` и `year`.
+ *
+ * @param {number} timestamp - Unix timestamp в миллисекундах.
+ * @param {number} amount - Количество единиц времени.
+ * @param {string} unit - Календарная единица времени.
+ * @throws {TypeError} Выбрасывается, если timestamp или amount некорректны.
+ * @throws {Error} Выбрасывается, если unit не поддерживается.
+ * @returns {number} Новый Unix timestamp в миллисекундах.
+ * @example
+ * import { addByCalendarUnit } from './utils/calendar.js';
+ *
+ * console.log(addByCalendarUnit(Date.UTC(2024, 0, 31, 0, 0, 0, 0), 1, 'month')); // ожидаемый результат: 1709164800000
+ */
+export function addByCalendarUnit(timestamp, amount, unit) {
+    assertValidTimestamp(timestamp, 'addByCalendarUnit');
+    assertValidAmount(amount, 'addByCalendarUnit');
+
+    const normalizedUnit = normalizeUnit(unit);
+    const date = new Date(timestamp);
+
+    if (normalizedUnit === 'month') {
+        const originalDay = date.getUTCDate();
+
+        date.setUTCDate(1);
+        date.setUTCMonth(date.getUTCMonth() + amount);
+
+        const maxDay = daysInMonth(date.getUTCFullYear(), date.getUTCMonth() + 1);
+        date.setUTCDate(Math.min(originalDay, maxDay));
+
+        return date.getTime();
+    }
+
+    if (normalizedUnit === 'year') {
+        const originalMonth = date.getUTCMonth();
+        const originalDay = date.getUTCDate();
+
+        date.setUTCDate(1);
+        date.setUTCFullYear(date.getUTCFullYear() + amount);
+        date.setUTCMonth(originalMonth);
+
+        const maxDay = daysInMonth(date.getUTCFullYear(), originalMonth + 1);
+        date.setUTCDate(Math.min(originalDay, maxDay));
+
+        return date.getTime();
+    }
+
+    throw new Error(`addByCalendarUnit supports only month and year: ${unit}`);
+}
+
+/**
+ * Возвращает числовую разницу между двумя экземплярами {@link OzTime}
+ * в указанной единице времени.
+ *
+ * Для фиксированных единиц может возвращать дробное число,
+ * для месяцев и лет возвращает целочисленную календарную разницу.
+ *
+ * @param {OzTime} left - Левое значение.
+ * @param {OzTime} right - Правое значение.
+ * @param {string} [unit='millisecond'] - Единица времени.
+ * @throws {TypeError} Выбрасывается, если хотя бы один аргумент не является экземпляром OzTime.
+ * @throws {Error} Выбрасывается, если unit не поддерживается.
+ * @returns {number} Разница между двумя значениями времени.
+ * @example
+ * import { diff } from './utils/calendar.js';
+ * import { fromISO } from '@alexstukovnikov/oz-time';
+ *
+ * const a = fromISO('2024-05-25T14:00:00Z');
+ * const b = fromISO('2024-05-25T12:00:00Z');
+ * console.log(diff(a, b, 'hour')); // ожидаемый результат: 2
+ */
+export function diff(left, right, unit = 'millisecond') {
+    assertOzTime(left, 'left');
+    assertOzTime(right, 'right');
+
+    const normalizedUnit = normalizeUnit(unit);
+    const leftTimestamp = left.getTimestamp();
+    const rightTimestamp = right.getTimestamp();
+
+    if (isFixedUnit(normalizedUnit)) {
+        return (leftTimestamp - rightTimestamp) / unitToMilliseconds(normalizedUnit);
+    }
+
+    if (normalizedUnit === 'month') {
+        return diffInMonths(leftTimestamp, rightTimestamp);
+    }
+
+    if (normalizedUnit === 'year') {
+        return diffInYears(leftTimestamp, rightTimestamp);
+    }
+
+    throw new Error(`Unsupported unit: ${unit}`);
+}

package/src/utils/units.js

@@ -0,0 +1,135 @@
+/**
+ * Утилиты для нормализации и проверки единиц времени.
+ *
+ * @module utils/units
+ */
+
+/**
+ * Объект соотношений разных названий единиц времени к каноническим названиям.
+ *
+ * @type {Object.<string, string>}
+ */
+const UNIT_ALIASES = {
+    millisecond: 'millisecond',
+    milliseconds: 'millisecond',
+    ms: 'millisecond',
+
+    second: 'second',
+    seconds: 'second',
+    s: 'second',
+
+    minute: 'minute',
+    minutes: 'minute',
+    m: 'minute',
+
+    hour: 'hour',
+    hours: 'hour',
+    h: 'hour',
+
+    day: 'day',
+    days: 'day',
+    d: 'day',
+
+    month: 'month',
+    months: 'month',
+
+    year: 'year',
+    years: 'year',
+    y: 'year',
+};
+
+/**
+ * Точное количество миллисекунд для фиксированных единиц времени.
+ *
+ * @type {Object.<string, number>}
+ */
+export const FIXED_UNIT_TO_MS = {
+    millisecond: 1,
+    second: 1000,
+    minute: 60 * 1000,
+    hour: 60 * 60 * 1000,
+    day: 24 * 60 * 60 * 1000,
+};
+
+/**
+ * Массив поддерживаемых календарных единиц времени.
+ *
+ * @type {string[]}
+ */
+export const CALENDAR_UNITS = ['month', 'year'];
+
+/**
+ * Нормализует единицу времени к каноническому виду.
+ *
+ * @param {string} unit - Единица времени.
+ * @throws {TypeError} Выбрасывается, если unit пустой или не является строкой.
+ * @throws {Error} Выбрасывается, если unit не поддерживается.
+ * @returns {string} Каноническое название единицы времени.
+ * @example
+ * import { normalizeUnit } from './utils/units.js';
+ *
+ * console.log(normalizeUnit('hours')); // ожидаемый результат: hour
+ */
+export function normalizeUnit(unit) {
+    if (typeof unit !== 'string' || unit.trim() === '') {
+        throw new TypeError('normalizeUnit: unit must be a non-empty string');
+    }
+
+    const normalized = unit.toLowerCase().trim();
+    const canonical = UNIT_ALIASES[normalized];
+
+    if (!canonical) {
+        throw new Error(`Unsupported unit: ${unit}`);
+    }
+
+    return canonical;
+}
+
+/**
+ * Проверяет, является ли единица фиксированной.
+ *
+ * @param {string} unit - Единица времени.
+ * @returns {boolean} `true`, если единица является фиксированной.
+ * @example
+ * import { isFixedUnit } from './utils/units.js';
+ *
+ * console.log(isFixedUnit('minute')); // ожидаемый результат: true
+ */
+export function isFixedUnit(unit) {
+    return normalizeUnit(unit) in FIXED_UNIT_TO_MS;
+}
+
+/**
+ * Проверяет, является ли единица календарной.
+ *
+ * @param {string} unit - Единица времени.
+ * @returns {boolean} `true`, если единица является календарной.
+ * @example
+ * import { isCalendarUnit } from './utils/units.js';
+ *
+ * console.log(isCalendarUnit('month')); // ожидаемый результат: true
+ */
+export function isCalendarUnit(unit) {
+    return CALENDAR_UNITS.includes(normalizeUnit(unit));
+}
+
+/**
+ * Возвращает точное количество миллисекунд в одной фиксированной единице времени.
+ *
+ * @param {string} unit - Фиксированная единица времени.
+ * @throws {Error} Выбрасывается, если unit нельзя точно перевести в миллисекунды.
+ * @returns {number} Количество миллисекунд в одной единице времени.
+ * @example
+ * import { unitToMilliseconds } from './utils/units.js';
+ *
+ * console.log(unitToMilliseconds('hour')); // ожидаемый результат: 3600000
+ */
+export function unitToMilliseconds(unit) {
+    const normalizedUnit = normalizeUnit(unit);
+
+    if (!(normalizedUnit in FIXED_UNIT_TO_MS)) {
+        throw new Error(`Unit cannot be converted to milliseconds exactly: ${unit}`);
+    }
+
+    return FIXED_UNIT_TO_MS[normalizedUnit];
+}

package/dist/oz-time.cjs

@@ -1 +0,0 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e={millisecond:`millisecond`,milliseconds:`millisecond`,ms:`millisecond`,second:`second`,seconds:`second`,s:`second`,minute:`minute`,minutes:`minute`,m:`minute`,hour:`hour`,hours:`hour`,h:`hour`,day:`day`,days:`day`,d:`day`,month:`month`,months:`month`,year:`year`,years:`year`,y:`year`},t={millisecond:1,second:1e3,minute:60*1e3,hour:3600*1e3,day:1440*60*1e3},n=[`month`,`year`];function r(t){if(typeof t!=`string`||t.trim()===``)throw TypeError(`normalizeUnit: unit must be a non-empty string`);let n=e[t.toLowerCase().trim()];if(!n)throw Error(`Unsupported unit: ${t}`);return n}function i(e){return r(e)in t}function a(e){return n.includes(r(e))}function o(e){let n=r(e);if(!(n in t))throw Error(`Unit cannot be converted to milliseconds exactly: ${e}`);return t[n]}function s(e,t){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`${t}: timestamp must be a valid number`)}function c(e,t){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`${t}: amount must be a valid number`)}function l(e,t){if(!(e instanceof B))throw TypeError(`${t} must be OzTime`)}function u(e,t){let n=new Date(e),r=new Date(t),i=(n.getUTCFullYear()-r.getUTCFullYear())*12+(n.getUTCMonth()-r.getUTCMonth()),a=n.getUTCDate(),o=r.getUTCDate();return i>0&&a<o?--i:i<0&&a>o&&(i+=1),i}function d(e,t){let n=new Date(e),r=new Date(t),i=n.getUTCFullYear()-r.getUTCFullYear(),a=n.getUTCMonth(),o=r.getUTCMonth(),s=n.getUTCDate(),c=r.getUTCDate();return i>0&&(a<o||a===o&&s<c)?--i:i<0&&(a>o||a===o&&s>c)&&(i+=1),i}function f(e){if(!Number.isInteger(e))throw TypeError(`isLeapYear: year must be an integer`);return e%4==0&&(e%100!=0||e%400==0)}function p(e,t){if(!Number.isInteger(e)||!Number.isInteger(t))throw TypeError(`daysInMonth: year and month must be integers`);if(t<1||t>12)throw RangeError(`daysInMonth: month must be between 1 and 12`);return new Date(Date.UTC(e,t,0)).getUTCDate()}function m(e,t,n){s(e,`addByFixedUnit`),c(t,`addByFixedUnit`);let a=r(n);if(!i(a))throw Error(`addByFixedUnit does not support calendar unit: ${n}`);return e+t*o(a)}function h(e,t,n){s(e,`addByCalendarUnit`),c(t,`addByCalendarUnit`);let i=r(n),a=new Date(e);if(i===`month`){let e=a.getUTCDate();a.setUTCDate(1),a.setUTCMonth(a.getUTCMonth()+t);let n=p(a.getUTCFullYear(),a.getUTCMonth()+1);return a.setUTCDate(Math.min(e,n)),a.getTime()}if(i===`year`){let e=a.getUTCMonth(),n=a.getUTCDate();a.setUTCDate(1),a.setUTCFullYear(a.getUTCFullYear()+t),a.setUTCMonth(e);let r=p(a.getUTCFullYear(),e+1);return a.setUTCDate(Math.min(n,r)),a.getTime()}throw Error(`addByCalendarUnit supports only month and year: ${n}`)}function g(e,t,n=`millisecond`){l(e,`left`),l(t,`right`);let a=r(n),s=e.getTimestamp(),c=t.getTimestamp();if(i(a))return(s-c)/o(a);if(a===`month`)return u(s,c);if(a===`year`)return d(s,c);throw Error(`Unsupported unit: ${n}`)}function _(e,t){if(!(e instanceof B))throw TypeError(`${t} must be OzTime`)}function v(e){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`amount must be a valid number`)}function y(e,t,n){_(e,`time`),v(t);let o=r(n),s=e.getTimestamp(),c;return i(o)?c=m(s,t,o):a(o)&&(c=h(s,t,o)),new B(c,e.getTimezone(),e.getLocale())}function b(e,t,n){return _(e,`time`),v(t),y(e,-t,n)}function x(e){if(!(e instanceof B))throw TypeError(`format: first argument must be OzTime`)}function S(e,t=2){return String(e).padStart(t,`0`)}function C(e,t){let n=new Intl.DateTimeFormat(t,{timeZone:e.getTimezone(),year:`numeric`,month:`numeric`,day:`numeric`,hour:`numeric`,minute:`2-digit`,second:`2-digit`,hour12:!1}).formatToParts(new Date(e.getTimestamp()));return Object.fromEntries(n.map(e=>[e.type,e.value]))}function w(e,t,n){return new Intl.DateTimeFormat(t,{timeZone:e.getTimezone(),month:n}).format(new Date(e.getTimestamp()))}function T(e,t,n){return new Intl.DateTimeFormat(t,{timeZone:e.getTimezone(),weekday:n}).format(new Date(e.getTimestamp()))}function E(e,t,n){if(x(e),typeof t!=`string`||t.trim()===``)throw TypeError(`format: template must be a non-empty string`);let r=n??e.getLocale(),i=C(e,r),a=Number(i.year),o=Number(i.month),s=Number(i.day),c=Number(i.hour),l=Number(i.minute),u=Number(i.second),d=new Date(e.getTimestamp()).getUTCMilliseconds(),f=c%12,p=f===0?12:f,m=c>=12?`PM`:`AM`,h={YYYY:String(a),YY:String(a).slice(-2),MMMM:w(e,r,`long`),MMM:w(e,r,`short`),MM:S(o),M:String(o),dddd:T(e,r,`long`),ddd:T(e,r,`short`),DD:S(s),D:String(s),HH:S(c),H:String(c),hh:S(p),h:String(p),mm:S(l),ss:S(u),SSS:S(d,3),A:m};return t.replace(/YYYY|MMMM|MMM|MM|M|dddd|ddd|DD|D|HH|H|hh|h|mm|ss|SSS|YY|A/g,e=>h[e]??e)}function D(e,t){if(!(e instanceof B))throw TypeError(`${t} must be OzTime`)}function O(e,t){let n=r(t),i=new Date(e);switch(n){case`millisecond`:return i.getTime();case`second`:i.setUTCMilliseconds(0);break;case`minute`:i.setUTCSeconds(0,0);break;case`hour`:i.setUTCMinutes(0,0,0);break;case`day`:i.setUTCHours(0,0,0,0);break;case`month`:i.setUTCHours(0,0,0,0),i.setUTCDate(1);break;case`year`:i.setUTCHours(0,0,0,0),i.setUTCDate(1),i.setUTCMonth(0);break;default:throw Error(`Unsupported unit for truncateToUnit: ${t}`)}return i.getTime()}function k(e,t,n=`millisecond`){return D(e,`a`),D(t,`b`),O(e.getTimestamp(),n)===O(t.getTimestamp(),n)}function A(e,t,n=`millisecond`){return D(e,`a`),D(t,`b`),O(e.getTimestamp(),n)<O(t.getTimestamp(),n)}function j(e,t,n=`millisecond`){return D(e,`a`),D(t,`b`),O(e.getTimestamp(),n)>O(t.getTimestamp(),n)}function M(e,t,n,r=`millisecond`,i=`[]`){D(e,`target`),D(t,`left`),D(n,`right`);let a=O(e.getTimestamp(),r),o=O(t.getTimestamp(),r),s=O(n.getTimestamp(),r),c=Math.min(o,s),l=Math.max(o,s);switch(i){case`[]`:return a>=c&&a<=l;case`[)`:return a>=c&&a<l;case`(]`:return a>c&&a<=l;case`()`:return a>c&&a<l;default:throw Error(`Invalid inclusivity value: ${i}`)}}function N(e){if(typeof e!=`string`||e.trim()===``)throw TypeError(`setTimezone: timezone must be a non-empty string`);if(!Intl.supportedValuesOf(`timeZone`).includes(e))throw Error(`Unsupported timezone: ${e}`)}function P(e,t){let n=new Date(e),r=new Intl.DateTimeFormat(`en-US`,{timeZone:t,year:`numeric`,month:`2-digit`,day:`2-digit`,hour:`2-digit`,minute:`2-digit`,second:`2-digit`,hour12:!1}).formatToParts(n),i=Object.fromEntries(r.map(e=>[e.type,e.value])),a=Number(i.year),o=Number(i.month),s=Number(i.day),c=Number(i.hour),l=Number(i.minute),u=Number(i.second);return(Date.UTC(a,o-1,s,c,l,u)-e)/6e4}function F(e,t){if(!(e instanceof B))throw TypeError(`tz: first argument must be OzTime`);return N(t),new B(e.getTimestamp(),t,e.getLocale())}function I(e){if(!(e instanceof B))throw TypeError(`getTimezoneOffset: argument must be OzTime`);return P(e.getTimestamp(),e.getTimezone())}function L(e){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`OzTime: timestamp must be a valid number`)}function R(e){if(typeof e!=`string`||e.trim()===``)throw TypeError(`OzTime: timezone must be a non-empty string`)}function z(e){if(typeof e!=`string`||e.trim()===``)throw TypeError(`OzTime: locale must be a non-empty string`)}var B=class{constructor(e,t=`UTC`,n=`en-US`){L(e),R(t),z(n),this._timestamp=e,this._timezone=t,this._locale=n}getTimestamp(){return this._timestamp}getTimezone(){return this._timezone}getLocale(){return this._locale}toTimestamp(){return this._timestamp}toISOString(){return new Date(this._timestamp).toISOString()}add(e,t){return y(this,e,t)}subtract(e,t){return b(this,e,t)}format(e,t){return E(this,e,t)}isSame(e,t=`millisecond`){return k(this,e,t)}isBefore(e,t=`millisecond`){return A(this,e,t)}isAfter(e,t=`millisecond`){return j(this,e,t)}isBetween(e,t,n=`millisecond`,r=`[]`){return M(this,e,t,n,r)}setTimezone(e){return F(this,e)}getTimezoneOffset(){return I(this)}diff(e,t=`millisecond`){return g(this,e,t)}};function V(e){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`fromTimestamp: timestamp must be a valid number`)}function H(e){if(!(e instanceof Date)||Number.isNaN(e.getTime()))throw TypeError(`fromDate: date must be a valid Date`)}function U(e,t){if(!Number.isInteger(e))throw TypeError(`${t} must be an integer`)}function W(e=`UTC`,t=`en-US`){return new B(Date.now(),e,t)}function G(e,t=`UTC`,n=`en-US`){return V(e),new B(e,t,n)}function K(e,t=`UTC`,n=`en-US`){return H(e),new B(e.getTime(),t,n)}function q(e,t=`UTC`,n=`en-US`){if(typeof e!=`string`||e.trim()===``)throw TypeError(`fromISO: isoString must be a non-empty string`);let r=Date.parse(e);if(Number.isNaN(r))throw Error(`Invalid ISO date string: ${e}`);return new B(r,t,n)}function J(e,t,n,r=0,i=0,a=0,o=0,s=`UTC`,c=`en-US`){if(U(e,`year`),U(t,`month`),U(n,`day`),U(r,`hour`),U(i,`minute`),U(a,`second`),U(o,`millisecond`),t<1||t>12)throw RangeError(`month must be between 1 and 12`);if(r<0||r>23)throw RangeError(`hour must be between 0 and 23`);if(i<0||i>59)throw RangeError(`minute must be between 0 and 59`);if(a<0||a>59)throw RangeError(`second must be between 0 and 59`);if(o<0||o>999)throw RangeError(`millisecond must be between 0 and 999`);let l=p(e,t);if(n<1||n>l)throw RangeError(`day must be between 1 and ${l} for ${e}-${t}`);return new B(Date.UTC(e,t-1,n,r,i,a,o),s,c)}function Y(e,t){if(!(e instanceof B))throw TypeError(`${t} must be OzTime`)}var X=class e{constructor(e,t){if(Y(e,`start`),Y(t,`end`),e.getTimestamp()>t.getTimestamp())throw RangeError(`Interval: start must be before or equal to end`);this._start=e,this._end=t}getStart(){return this._start}getEnd(){return this._end}contains(e){Y(e,`moment`);let t=e.getTimestamp();return t>=this._start.getTimestamp()&&t<=this._end.getTimestamp()}overlaps(t){if(!(t instanceof e))throw TypeError(`other must be Interval`);let n=this._start.getTimestamp(),r=this._end.getTimestamp(),i=t.getStart().getTimestamp();return n<=t.getEnd().getTimestamp()&&i<=r}duration(e=`millisecond`){let t=r(e);if(!i(t))throw Error(`Interval.duration supports only fixed units: ${e}`);return(this._end.getTimestamp()-this._start.getTimestamp())/o(t)}};function Z(e,t){return new X(e,t)}function Q(e){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`amount must be a valid number`)}var $=class e{constructor(e){if(typeof e!=`number`||Number.isNaN(e))throw TypeError(`Duration: milliseconds must be a valid number`);this._milliseconds=e}asMilliseconds(){return this._milliseconds}asSeconds(){return this._milliseconds/o(`second`)}asMinutes(){return this._milliseconds/o(`minute`)}asHours(){return this._milliseconds/o(`hour`)}asDays(){return this._milliseconds/o(`day`)}add(t){if(!(t instanceof e))throw TypeError(`Duration.add: other must be Duration`);return new e(this._milliseconds+t._milliseconds)}};function ee(e,t){Q(e);let n=r(t);if(!i(n))throw Error(`duration supports only fixed units: ${t}`);return new $(e*o(n))}exports.Duration=$,exports.Interval=X,exports.OzTime=B,exports.add=y,exports.daysInMonth=p,exports.duration=ee,exports.format=E,exports.fromComponents=J,exports.fromDate=K,exports.fromISO=q,exports.fromTimestamp=G,exports.getTimezoneOffset=I,exports.interval=Z,exports.isAfter=j,exports.isBefore=A,exports.isBetween=M,exports.isLeapYear=f,exports.isSame=k,exports.now=W,exports.setTimezone=F,exports.subtract=b;