@formkit/tempo 1.0.0 → 1.1.0

package/README.md

@@ -10,7 +10,28 @@ Tempo is a new library in a proud tradition of JavaScript date and time librarie
 
 Tempo is best thought of as a collection of utilities for working with `Date` objects — an important distinction from other libraries that provide custom date primitives. Under the hood, Tempo mines JavaScript's `Intl.DateTimeFormat` to extract complex data like timezones offsets and locale aware date formats giving you a simple API to format, parse, and manipulates dates.
 
-Tempo is tiny tree-shakable framework, you can only take what you need. All functionality is available in **5.2 kB for esm** and **5.5 kB for cjs** modules (minified and brotlied). [Size Limit](https://github.com/ai/size-limit) controls the size.
+Tempo is tiny tree-shakable framework, you can only take what you need. You can work with timezones with only a few bytes of library code, or perform full international date formatting for ~2Kb (minified and brotlied). [Size Limit](https://github.com/ai/size-limit) controls the size.
+
+## Development
+
+Install from the repository root with `pnpm`:
+
+```bash
+corepack enable
+pnpm install
+```
+
+Build the library:
+
+```bash
+pnpm build
+```
+
+Build the docs app:
+
+```bash
+pnpm docs-build
+```
 
 <a href="https://tempo.formkit.com">
 <img src="docs/public/read-the-docs.png" alt="Read the docs" width="200" height="43">

package/dist/add.d.ts

@@ -0,0 +1,11 @@
+import { MaybeDateInput, Duration } from './types.js';
+
+/**
+ * Returns a new Date object with the duration applied.
+ * @param [inputDate] - A date to increment or null to increment from the current time.
+ * @param duration - An object with values for the amount of time to add to the original date.
+ * @param [dateOverflow] - Whether to allow month/year changes to overflow into a later month.
+ */
+declare function add(inputDate: MaybeDateInput, duration: Duration, dateOverflow?: boolean): Date;
+
+export { add };

package/dist/add.mjs

@@ -0,0 +1,50 @@
+// src/add.ts
+import { addDay } from "./addDay.mjs";
+import { addHour } from "./addHour.mjs";
+import { addMillisecond } from "./addMillisecond.mjs";
+import { addMinute } from "./addMinute.mjs";
+import { addMonth } from "./addMonth.mjs";
+import { addSecond } from "./addSecond.mjs";
+import { addYear } from "./addYear.mjs";
+import { date } from "./date.mjs";
+function add(inputDate, duration, dateOverflow = false) {
+  var _a, _b;
+  let d = date(inputDate);
+  const applyFixedUnits = () => {
+    if (duration.weeks) {
+      d = addDay(d, duration.weeks * 7);
+    }
+    if (duration.days) {
+      d = addDay(d, duration.days);
+    }
+    if (duration.hours) {
+      d = addHour(d, duration.hours);
+    }
+    if (duration.minutes) {
+      d = addMinute(d, duration.minutes);
+    }
+    if (duration.seconds) {
+      d = addSecond(d, duration.seconds);
+    }
+    if (duration.milliseconds) {
+      d = addMillisecond(d, duration.milliseconds);
+    }
+  };
+  const applyCalendarUnits = () => {
+    if (duration.months) {
+      d = addMonth(d, duration.months, dateOverflow);
+    }
+    if (duration.years) {
+      d = addYear(d, duration.years, dateOverflow);
+    }
+  };
+  const calendarFirst = ((_a = duration.months) != null ? _a : 0) < 0 || ((_b = duration.years) != null ? _b : 0) < 0;
+  if (calendarFirst) applyCalendarUnits();
+  applyFixedUnits();
+  if (!calendarFirst) applyCalendarUnits();
+  return d;
+}
+export {
+  add
+};
+//# sourceMappingURL=add.mjs.map

package/dist/add.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/add.ts"],"sourcesContent":["import { addDay } from \"./addDay\"\nimport { addHour } from \"./addHour\"\nimport { addMillisecond } from \"./addMillisecond\"\nimport { addMinute } from \"./addMinute\"\nimport { addMonth } from \"./addMonth\"\nimport { addSecond } from \"./addSecond\"\nimport { addYear } from \"./addYear\"\nimport { date } from \"./date\"\nimport type { Duration, MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new Date object with the duration applied.\n * @param [inputDate] - A date to increment or null to increment from the current time.\n * @param duration - An object with values for the amount of time to add to the original date.\n * @param [dateOverflow] - Whether to allow month/year changes to overflow into a later month.\n */\nexport function add(\n  inputDate: MaybeDateInput,\n  duration: Duration,\n  dateOverflow = false\n) {\n  let d = date(inputDate)\n  const applyFixedUnits = () => {\n    if (duration.weeks) {\n      d = addDay(d, duration.weeks * 7)\n    }\n    if (duration.days) {\n      d = addDay(d, duration.days)\n    }\n    if (duration.hours) {\n      d = addHour(d, duration.hours)\n    }\n    if (duration.minutes) {\n      d = addMinute(d, duration.minutes)\n    }\n    if (duration.seconds) {\n      d = addSecond(d, duration.seconds)\n    }\n    if (duration.milliseconds) {\n      d = addMillisecond(d, duration.milliseconds)\n    }\n  }\n  const applyCalendarUnits = () => {\n    if (duration.months) {\n      d = addMonth(d, duration.months, dateOverflow)\n    }\n    if (duration.years) {\n      d = addYear(d, duration.years, dateOverflow)\n    }\n  }\n  const calendarFirst = (duration.months ?? 0) < 0 || (duration.years ?? 0) < 0\n\n  if (calendarFirst) applyCalendarUnits()\n  applyFixedUnits()\n  if (!calendarFirst) applyCalendarUnits()\n\n  return d\n}\n"],"mappings":";AAAA,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,sBAAsB;AAC/B,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AACxB,SAAS,YAAY;AASd,SAAS,IACd,WACA,UACA,eAAe,OACf;AApBF;AAqBE,MAAI,IAAI,KAAK,SAAS;AACtB,QAAM,kBAAkB,MAAM;AAC5B,QAAI,SAAS,OAAO;AAClB,UAAI,OAAO,GAAG,SAAS,QAAQ,CAAC;AAAA,IAClC;AACA,QAAI,SAAS,MAAM;AACjB,UAAI,OAAO,GAAG,SAAS,IAAI;AAAA,IAC7B;AACA,QAAI,SAAS,OAAO;AAClB,UAAI,QAAQ,GAAG,SAAS,KAAK;AAAA,IAC/B;AACA,QAAI,SAAS,SAAS;AACpB,UAAI,UAAU,GAAG,SAAS,OAAO;AAAA,IACnC;AACA,QAAI,SAAS,SAAS;AACpB,UAAI,UAAU,GAAG,SAAS,OAAO;AAAA,IACnC;AACA,QAAI,SAAS,cAAc;AACzB,UAAI,eAAe,GAAG,SAAS,YAAY;AAAA,IAC7C;AAAA,EACF;AACA,QAAM,qBAAqB,MAAM;AAC/B,QAAI,SAAS,QAAQ;AACnB,UAAI,SAAS,GAAG,SAAS,QAAQ,YAAY;AAAA,IAC/C;AACA,QAAI,SAAS,OAAO;AAClB,UAAI,QAAQ,GAAG,SAAS,OAAO,YAAY;AAAA,IAC7C;AAAA,EACF;AACA,QAAM,kBAAiB,cAAS,WAAT,YAAmB,KAAK,OAAM,cAAS,UAAT,YAAkB,KAAK;AAE5E,MAAI,cAAe,oBAAmB;AACtC,kBAAgB;AAChB,MAAI,CAAC,cAAe,oBAAmB;AAEvC,SAAO;AACT;","names":[]}

package/dist/addMonth.mjs

@@ -1,16 +1,7 @@
 // src/addMonth.ts
-import { date } from "./date.mjs";
-import { monthDays } from "./monthDays.mjs";
+import { handleOverflow } from "./handleDateOverflow.mjs";
 function addMonth(inputDate, count = 1, dateOverflow = false) {
-  const d = date(inputDate);
-  const dayOfMonth = d.getDate();
-  if (!dateOverflow) d.setDate(1);
-  d.setMonth(d.getMonth() + count);
-  if (!dateOverflow) {
-    const daysInMonth = monthDays(d);
-    d.setDate(daysInMonth < dayOfMonth ? daysInMonth : dayOfMonth);
-  }
-  return d;
+  return handleOverflow(inputDate, (d) => d.setMonth(d.getMonth() + count), dateOverflow);
 }
 export {
   addMonth

package/dist/addMonth.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/addMonth.ts"],"sourcesContent":["import { date } from \"./date\"\nimport { monthDays } from \"./monthDays\"\nimport type { DateInput, MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n months after the original one. Keep in mind if you\n * start with a date late in a given month you could get a date after the next\n * month.\n * @param [inputDate] - A date to increment or null to increment from the current time\n * @param [count] - The quantity to add.\n * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.\n */\nexport function addMonth(inputDate?: MaybeDateInput, count = 1, dateOverflow = false) {\n  const d = date(inputDate)\n  const dayOfMonth = d.getDate()\n  // If overflowing is disallowed, set the date back to the first of the month\n  if (!dateOverflow) d.setDate(1)\n  d.setMonth(d.getMonth() + count)\n\n  // If overflowing is disallowed, we need to set the date back to the proper\n  // day or the last day of the month.\n  if (!dateOverflow) {\n    const daysInMonth = monthDays(d)\n    d.setDate(daysInMonth < dayOfMonth ? daysInMonth : dayOfMonth)\n  }\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAWnB,SAAS,SAAS,WAA4B,QAAQ,GAAG,eAAe,OAAO;AACpF,QAAM,IAAI,KAAK,SAAS;AACxB,QAAM,aAAa,EAAE,QAAQ;AAE7B,MAAI,CAAC,aAAc,GAAE,QAAQ,CAAC;AAC9B,IAAE,SAAS,EAAE,SAAS,IAAI,KAAK;AAI/B,MAAI,CAAC,cAAc;AACjB,UAAM,cAAc,UAAU,CAAC;AAC/B,MAAE,QAAQ,cAAc,aAAa,cAAc,UAAU;AAAA,EAC/D;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/addMonth.ts"],"sourcesContent":["import { handleOverflow } from \"./handleDateOverflow\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n months after the original one. Keep in mind if you\n * start with a date late in a given month you could get a date after the next\n * month.\n * @param [inputDate] - A date to increment or null to increment from the current time\n * @param [count] - The quantity to add.\n * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.\n */\nexport function addMonth(inputDate?: MaybeDateInput, count = 1, dateOverflow = false) {\n  return handleOverflow(inputDate, (d) => d.setMonth(d.getMonth() + count), dateOverflow)\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AAWxB,SAAS,SAAS,WAA4B,QAAQ,GAAG,eAAe,OAAO;AACpF,SAAO,eAAe,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,IAAI,KAAK,GAAG,YAAY;AACxF;","names":[]}

package/dist/addYear.mjs

@@ -1,16 +1,11 @@
 // src/addYear.ts
-import { date } from "./date.mjs";
-import { monthDays } from "./monthDays.mjs";
+import { handleOverflow } from "./handleDateOverflow.mjs";
 function addYear(inputDate, count = 1, dateOverflow = false) {
-  const d = date(inputDate);
-  const dayOfMonth = d.getDate();
-  if (!dateOverflow) d.setDate(1);
-  d.setFullYear(d.getFullYear() + count);
-  if (!dateOverflow) {
-    const daysInMonth = monthDays(d);
-    d.setDate(daysInMonth < dayOfMonth ? daysInMonth : dayOfMonth);
-  }
-  return d;
+  return handleOverflow(
+    inputDate,
+    (d) => d.setFullYear(d.getFullYear() + count),
+    dateOverflow
+  );
 }
 export {
   addYear

package/dist/addYear.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/addYear.ts"],"sourcesContent":["import { date } from \"./date\"\nimport { monthDays } from \"./monthDays\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n years after the original one. Keep in mind if\n * you start with a date late in a given month you could get a date after the\n * next month.\n * @param [inputDate] - A date to increment or null to increment from the current time.\n * @param [count] - The quantity of years add.\n * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.\n */\nexport function addYear(inputDate?: MaybeDateInput, count = 1, dateOverflow = false) {\n  const d = date(inputDate)\n  const dayOfMonth = d.getDate()\n  // If overflowing is disallowed, set the date back to the first of the month\n  if (!dateOverflow) d.setDate(1)\n\n  d.setFullYear(d.getFullYear() + count)\n\n  // If overflowing is disallowed, we need to set the date back to the proper\n  // day or the last day of the month.\n  if (!dateOverflow) {\n    const daysInMonth = monthDays(d)\n    d.setDate(daysInMonth < dayOfMonth ? daysInMonth : dayOfMonth)\n  }\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAWnB,SAAS,QAAQ,WAA4B,QAAQ,GAAG,eAAe,OAAO;AACnF,QAAM,IAAI,KAAK,SAAS;AACxB,QAAM,aAAa,EAAE,QAAQ;AAE7B,MAAI,CAAC,aAAc,GAAE,QAAQ,CAAC;AAE9B,IAAE,YAAY,EAAE,YAAY,IAAI,KAAK;AAIrC,MAAI,CAAC,cAAc;AACjB,UAAM,cAAc,UAAU,CAAC;AAC/B,MAAE,QAAQ,cAAc,aAAa,cAAc,UAAU;AAAA,EAC/D;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/addYear.ts"],"sourcesContent":["import { handleOverflow } from \"./handleDateOverflow\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Returns a new date object 1/n years after the original one. Keep in mind if\n * you start with a date late in a given month you could get a date after the\n * next month.\n * @param [inputDate] - A date to increment or null to increment from the current time.\n * @param [count] - The quantity of years add.\n * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.\n */\nexport function addYear(inputDate?: MaybeDateInput, count = 1, dateOverflow = false) {\n  return handleOverflow(\n    inputDate,\n    (d) => d.setFullYear(d.getFullYear() + count),\n    dateOverflow\n  )\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AAWxB,SAAS,QAAQ,WAA4B,QAAQ,GAAG,eAAe,OAAO;AACnF,SAAO;AAAA,IACL;AAAA,IACA,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,IAAI,KAAK;AAAA,IAC5C;AAAA,EACF;AACF;","names":[]}

package/dist/bundle.d.ts

@@ -147,6 +147,28 @@ interface FormatOptions {
      */
     partFilter?: (part: Part) => boolean;
 }
+interface Duration {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+}
+interface DurationObj extends Duration {
+    microseconds?: number;
+    nanoseconds?: number;
+}
+
+/**
+ * Returns a new Date object with the duration applied.
+ * @param [inputDate] - A date to increment or null to increment from the current time.
+ * @param duration - An object with values for the amount of time to add to the original date.
+ * @param [dateOverflow] - Whether to allow month/year changes to overflow into a later month.
+ */
+declare function add(inputDate: MaybeDateInput, duration: Duration, dateOverflow?: boolean): Date;
 
 /**
  * Returns a new date object 1/n days after the original one.
@@ -497,6 +519,58 @@ declare function sameYear(inputDateA: DateInput, inputDateB?: MaybeDateInput): b
  */
 declare function sameYear(inputDateA: MaybeDateInput, inputDateB: DateInput): boolean;
 
+/**
+ * set the millisecond of a date object
+ * @param [inputDate] - a date or null for current time
+ * @param ms - the milliseconds you want the date set to (0 - 999) (can over/underflow)
+ */
+declare function setMilliseconds(inputDate: MaybeDateInput, ms: number): Date;
+
+/**
+ * set the second of a date object
+ * @param [inputDate] - a date or null for current time
+ * @param second - the second you want the date set to (0 - 59) (can over/underflow)
+ */
+declare function setSeconds(inputDate: MaybeDateInput, second: number): Date;
+
+/**
+ * set the minute of a date object
+ * @param [inputDate] - a date or null for current time
+ * @param minute - the minute you want the date set to (0 - 59) (can over/underflow)
+ */
+declare function setMinutes(inputDate: MaybeDateInput, minute: number): Date;
+
+/**
+ * set the hour of a date object
+ * @param [inputDate] - a date or null for current time
+ * @param hour - the hour you want the date set to (0 - 23) (can over/underflow)
+ */
+declare function setHour(inputDate: MaybeDateInput, hour: number): Date;
+
+/**
+ * set the day of the month in a date object
+ * @param [inputDate] - a date or null for current time
+ * @param day - the day of the month you want the date set to (1-28/29/30/31) (can over/underflow)
+ * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the given day isn't in the current month
+ */
+declare function setDayOfMonth(inputDate: MaybeDateInput, day: number, dateOverflow?: boolean): Date;
+
+/**
+ * set the month of a date
+ * @param [inputDate] - a date or null for current time
+ * @param month - the zero-based month to set (0-11, where 0 is January) (can over/underflow)
+ * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.
+ */
+declare function setMonth(inputDate: MaybeDateInput, month: number, dateOverflow?: boolean): Date;
+
+/**
+ * set the year of a date object
+ * @param inputDate - a date or null for current time
+ * @param year - the full year you want the date to be set to
+ * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the inputDate’s month is out of range of the new month.
+ */
+declare function setYear(inputDate: MaybeDateInput, year: number, dateOverflow?: boolean): Date;
+
 /**
  * Returns a Date object for the last day at the last second of the given week.
  * Defaults to Sunday as the first day of the week:
@@ -707,4 +781,39 @@ declare function diffYears(dateA: DateInput, dateB?: MaybeDateInput): number;
  */
 declare function diffYears(dateA: MaybeDateInput, dateB: DateInput): number;
 
-export { type DateInput, type ExtendedPartTypes, type FilledPart, type Format, type FormatOptions, type FormatPattern, type FormatStyle, type FormatStyleObj, type FormatToken, type MaybeDateInput, type NamedFormatOption, type NamedFormats, type ParseOptions, type Part, addDay, addHour, addMillisecond, addMinute, addMonth, addSecond, addYear, ap, applyOffset, date, dayEnd, dayOfYear, dayStart, diffDays, diffHours, diffMilliseconds, diffMinutes, diffMonths, diffSeconds, diffWeeks, diffYears, format, formatStr, fourDigitYear, hourEnd, hourStart, isAfter, isBefore, isEqual, isFuture, isPast, iso8601, minuteEnd, minuteStart, monthDays, monthEnd, monthStart, nearestDay, offset, parse, parseParts, parts, range, removeOffset, sameDay, sameHour, sameMillisecond, sameMinute, sameSecond, sameYear, tzDate, weekEnd, weekStart, yearDays, yearEnd, yearStart };
+type DurationKey = keyof Duration;
+/**
+ * Options for `diff` function
+ */
+interface DiffOptions {
+    /**
+     * whether the difference should be absolute (not negative)
+     */
+    abs?: boolean;
+    /**
+     * units you want to skip, for example weeks
+     */
+    skip?: DurationKey[] | Set<DurationKey>;
+}
+/**
+ * Returns the difference between 2 dates in an object
+ * @param dateA - A date to compare with the right date
+ * @param [dateB] - A date to compare with the left date or nothing to compare with the current time
+ * @param [options] additional options
+ * @param [options.skip] units you want skip
+ * @param [options.abs] whether the difference should be absolute
+ * @returns an object which could be used with `Intl.DurationFormat.format'`
+ */
+declare function diff(dateA: DateInput, dateB?: MaybeDateInput, options?: DiffOptions): Duration;
+/**
+ * Returns the difference between 2 dates in an object
+ * @param [dateA] - A date to compare with the right date or null to compare with the current time
+ * @param dateB - A date to compare with the left date
+ * @param [options] additional options
+ * @param [options.skip] units you want skip
+ * @param [options.abs] whether the difference should be absolute
+ * @returns an object which could be used with `Intl.DurationFormat.format'`
+ */
+declare function diff(dateA: MaybeDateInput, dateB: DateInput, options?: DiffOptions): Duration;
+
+export { type DateInput, type DiffOptions, type Duration, type DurationObj, type ExtendedPartTypes, type FilledPart, type Format, type FormatOptions, type FormatPattern, type FormatStyle, type FormatStyleObj, type FormatToken, type MaybeDateInput, type NamedFormatOption, type NamedFormats, type ParseOptions, type Part, add, addDay, addHour, addMillisecond, addMinute, addMonth, addSecond, addYear, ap, applyOffset, date, dayEnd, dayOfYear, dayStart, diff, diffDays, diffHours, diffMilliseconds, diffMinutes, diffMonths, diffSeconds, diffWeeks, diffYears, format, formatStr, fourDigitYear, hourEnd, hourStart, isAfter, isBefore, isEqual, isFuture, isPast, iso8601, minuteEnd, minuteStart, monthDays, monthEnd, monthStart, nearestDay, offset, parse, parseParts, parts, range, removeOffset, sameDay, sameHour, sameMillisecond, sameMinute, sameSecond, sameYear, setDayOfMonth, setHour, setMilliseconds, setMinutes, setMonth, setSeconds, setYear, tzDate, weekEnd, weekStart, yearDays, yearEnd, yearStart };

package/dist/bundle.mjs

@@ -47,6 +47,27 @@ function addDay(inputDate, count = 1) {
   return d;
 }
 
+// src/addHour.ts
+function addHour(inputDate, count = 1) {
+  const d = date(inputDate);
+  d.setHours(d.getHours() + count);
+  return d;
+}
+
+// src/addMillisecond.ts
+function addMillisecond(inputDate, count = 1) {
+  const d = date(inputDate);
+  d.setMilliseconds(d.getMilliseconds() + count);
+  return d;
+}
+
+// src/addMinute.ts
+function addMinute(inputDate, count = 1) {
+  const d = date(inputDate);
+  d.setMinutes(d.getMinutes() + count);
+  return d;
+}
+
 // src/monthEnd.ts
 function monthEnd(inputDate) {
   const d = date(inputDate);
@@ -62,25 +83,12 @@ function monthDays(inputDate) {
   return d.getDate();
 }
 
-// src/addMonth.ts
-function addMonth(inputDate, count = 1, dateOverflow = false) {
-  const d = date(inputDate);
-  const dayOfMonth = d.getDate();
-  if (!dateOverflow) d.setDate(1);
-  d.setMonth(d.getMonth() + count);
-  if (!dateOverflow) {
-    const daysInMonth = monthDays(d);
-    d.setDate(daysInMonth < dayOfMonth ? daysInMonth : dayOfMonth);
-  }
-  return d;
-}
-
-// src/addYear.ts
-function addYear(inputDate, count = 1, dateOverflow = false) {
+// src/handleDateOverflow.ts
+function handleOverflow(inputDate, action, dateOverflow = false) {
   const d = date(inputDate);
   const dayOfMonth = d.getDate();
   if (!dateOverflow) d.setDate(1);
-  d.setFullYear(d.getFullYear() + count);
+  action(d);
   if (!dateOverflow) {
     const daysInMonth = monthDays(d);
     d.setDate(daysInMonth < dayOfMonth ? daysInMonth : dayOfMonth);
@@ -88,18 +96,9 @@ function addYear(inputDate, count = 1, dateOverflow = false) {
   return d;
 }
 
-// src/addHour.ts
-function addHour(inputDate, count = 1) {
-  const d = date(inputDate);
-  d.setHours(d.getHours() + count);
-  return d;
-}
-
-// src/addMinute.ts
-function addMinute(inputDate, count = 1) {
-  const d = date(inputDate);
-  d.setMinutes(d.getMinutes() + count);
-  return d;
+// src/addMonth.ts
+function addMonth(inputDate, count = 1, dateOverflow = false) {
+  return handleOverflow(inputDate, (d) => d.setMonth(d.getMonth() + count), dateOverflow);
 }
 
 // src/addSecond.ts
@@ -109,10 +108,51 @@ function addSecond(inputDate, count = 1) {
   return d;
 }
 
-// src/addMillisecond.ts
-function addMillisecond(inputDate, count = 1) {
-  const d = date(inputDate);
-  d.setMilliseconds(d.getMilliseconds() + count);
+// src/addYear.ts
+function addYear(inputDate, count = 1, dateOverflow = false) {
+  return handleOverflow(
+    inputDate,
+    (d) => d.setFullYear(d.getFullYear() + count),
+    dateOverflow
+  );
+}
+
+// src/add.ts
+function add(inputDate, duration, dateOverflow = false) {
+  var _a, _b;
+  let d = date(inputDate);
+  const applyFixedUnits = () => {
+    if (duration.weeks) {
+      d = addDay(d, duration.weeks * 7);
+    }
+    if (duration.days) {
+      d = addDay(d, duration.days);
+    }
+    if (duration.hours) {
+      d = addHour(d, duration.hours);
+    }
+    if (duration.minutes) {
+      d = addMinute(d, duration.minutes);
+    }
+    if (duration.seconds) {
+      d = addSecond(d, duration.seconds);
+    }
+    if (duration.milliseconds) {
+      d = addMillisecond(d, duration.milliseconds);
+    }
+  };
+  const applyCalendarUnits = () => {
+    if (duration.months) {
+      d = addMonth(d, duration.months, dateOverflow);
+    }
+    if (duration.years) {
+      d = addYear(d, duration.years, dateOverflow);
+    }
+  };
+  const calendarFirst = ((_a = duration.months) != null ? _a : 0) < 0 || ((_b = duration.years) != null ? _b : 0) < 0;
+  if (calendarFirst) applyCalendarUnits();
+  applyFixedUnits();
+  if (!calendarFirst) applyCalendarUnits();
   return d;
 }
 
@@ -381,22 +421,24 @@ function deviceTZ() {
 // src/offset.ts
 function relativeTime(d, timeZone) {
   const utcParts = new Intl.DateTimeFormat("en-US", {
+    era: "short",
     year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    minute: "2-digit",
-    second: "2-digit",
+    month: "numeric",
+    day: "numeric",
+    hour: "numeric",
+    minute: "numeric",
+    second: "numeric",
     timeZone,
     hourCycle: "h23"
-  }).formatToParts(d).map(normStr);
-  const parts2 = {};
+  }).formatToParts(d);
+  const p = {};
   utcParts.forEach((part) => {
-    parts2[part.type] = part.value;
+    if (part.type !== "literal") p[part.type] = part.value;
   });
-  return /* @__PURE__ */ new Date(
-    `${parts2.year}-${parts2.month}-${parts2.day}T${parts2.hour}:${parts2.minute}:${parts2.second}Z`
-  );
+  const year = p.era === "BC" ? 1 - Number(p.year) : Number(p.year);
+  const result = new Date(Date.UTC(0, 0, 1, Number(p.hour), Number(p.minute), Number(p.second)));
+  result.setUTCFullYear(year, Number(p.month) - 1, Number(p.day));
+  return result;
 }
 function offset(utcTime, tzA = "UTC", tzB = "device", timeZoneToken = "Z") {
   var _a;
@@ -1019,12 +1061,61 @@ function sameYear(inputDateA, inputDateB) {
   return a.getFullYear() === b.getFullYear();
 }
 
+// src/setMilliseconds.ts
+function setMilliseconds(inputDate, ms) {
+  const d = date(inputDate);
+  d.setMilliseconds(ms);
+  return d;
+}
+
+// src/setSeconds.ts
+function setSeconds(inputDate, second) {
+  const d = date(inputDate);
+  d.setSeconds(second);
+  return d;
+}
+
+// src/setMinutes.ts
+function setMinutes(inputDate, minute) {
+  const d = date(inputDate);
+  d.setMinutes(minute);
+  return d;
+}
+
+// src/setHour.ts
+function setHour(inputDate, hour) {
+  const d = date(inputDate);
+  d.setHours(hour);
+  return d;
+}
+
+// src/setDayOfMonth.ts
+function setDayOfMonth(inputDate, day, dateOverflow = false) {
+  const d = date(inputDate);
+  const daysInMonth = monthDays(d);
+  if (!dateOverflow) {
+    day = day > daysInMonth ? daysInMonth : day;
+  }
+  d.setDate(day);
+  return d;
+}
+
+// src/setMonth.ts
+function setMonth(inputDate, month, dateOverflow = false) {
+  return handleOverflow(inputDate, (d) => d.setMonth(month), dateOverflow);
+}
+
+// src/setYear.ts
+function setYear(inputDate, year, dateOverflow = false) {
+  return handleOverflow(inputDate, (d) => d.setFullYear(year), dateOverflow);
+}
+
 // src/weekStart.ts
 function weekStart(inputDate, startOfWeekDay = 0) {
   const d = date(inputDate);
-  let diff = startOfWeekDay - d.getDay();
-  if (diff > 0) diff = diff - 7;
-  d.setDate(d.getDate() + diff);
+  let diff2 = startOfWeekDay - d.getDay();
+  if (diff2 > 0) diff2 = diff2 - 7;
+  d.setDate(d.getDate() + diff2);
   d.setHours(0, 0, 0, 0);
   return d;
 }
@@ -1172,7 +1263,76 @@ function diffYears(dateA, dateB) {
   );
   return r == 0 ? 0 : r;
 }
+
+// src/diff.ts
+function negateDuration(duration) {
+  const negated = {};
+  for (const unit of Object.keys(duration)) {
+    negated[unit] = -duration[unit];
+  }
+  return negated;
+}
+function calendarDiff(current, target, diffUnit, addUnit) {
+  let amount = diffUnit(current, target);
+  let next = addUnit(current, -amount);
+  while (amount > 0 && next < target) {
+    amount--;
+    next = addUnit(current, -amount);
+  }
+  return [amount, next];
+}
+function diff(dateA, dateB, options) {
+  let a = date(dateA);
+  let b = date(dateB);
+  if (a < b) {
+    const duration2 = diff(b, a, options);
+    return (options == null ? void 0 : options.abs) ? duration2 : negateDuration(duration2);
+  }
+  const skip = new Set(options == null ? void 0 : options.skip);
+  const duration = {};
+  if (!skip.has("years")) {
+    const [years, next] = calendarDiff(a, b, diffYears, addYear);
+    a = next;
+    if (years) duration.years = years;
+  }
+  if (!skip.has("months")) {
+    const [months, next] = calendarDiff(a, b, diffMonths, addMonth);
+    a = next;
+    if (months) duration.months = months;
+  }
+  if (!skip.has("weeks")) {
+    const weeks = diffWeeks(a, b);
+    a = addDay(a, -(weeks * 7));
+    if (weeks) duration.weeks = weeks;
+  }
+  if (!skip.has("days")) {
+    const days = diffDays(a, b);
+    a = addDay(a, -days);
+    if (days) duration.days = days;
+  }
+  if (!skip.has("hours")) {
+    const hours = diffHours(a, b);
+    a = addHour(a, -hours);
+    if (hours) duration.hours = hours;
+  }
+  if (!skip.has("minutes")) {
+    const minutes = diffMinutes(a, b);
+    a = addMinute(a, -minutes);
+    if (minutes) duration.minutes = minutes;
+  }
+  if (!skip.has("seconds")) {
+    const seconds = diffSeconds(a, b);
+    a = addSecond(a, -seconds);
+    if (seconds) duration.seconds = seconds;
+  }
+  if (!skip.has("milliseconds")) {
+    const ms = diffMilliseconds(a, b);
+    if (ms) duration.milliseconds = ms;
+  }
+  return duration;
+}
 export {
+  add,
   addDay,
   addHour,
   addMillisecond,
@@ -1186,6 +1346,7 @@ export {
   dayEnd,
   dayOfYear,
   dayStart,
+  diff,
   diffDays,
   diffHours,
   diffMilliseconds,
@@ -1223,6 +1384,13 @@ export {
   sameMinute,
   sameSecond,
   sameYear,
+  setDayOfMonth,
+  setHour,
+  setMilliseconds,
+  setMinutes,
+  setMonth,
+  setSeconds,
+  setYear,
   tzDate,
   weekEnd,
   weekStart,