@formkit/tempo 1.0.0 → 1.1.0

package/dist/diff.d.ts

@@ -0,0 +1,38 @@
+import { Duration, DateInput, MaybeDateInput } from './types.js';
+
+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 DiffOptions, diff };

package/dist/diff.mjs

@@ -0,0 +1,86 @@
+// src/diff.ts
+import { addDay } from "./addDay.mjs";
+import { addHour } from "./addHour.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";
+import { diffDays } from "./diffDays.mjs";
+import { diffHours } from "./diffHours.mjs";
+import { diffMilliseconds } from "./diffMilliseconds.mjs";
+import { diffMinutes } from "./diffMinutes.mjs";
+import { diffMonths } from "./diffMonths.mjs";
+import { diffSeconds } from "./diffSeconds.mjs";
+import { diffWeeks } from "./diffWeeks.mjs";
+import { diffYears } from "./diffYears.mjs";
+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 {
+  diff
+};
+//# sourceMappingURL=diff.mjs.map

package/dist/diff.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/diff.ts"],"sourcesContent":["import { addDay } from \"./addDay\"\nimport { addHour } from \"./addHour\"\nimport { addMinute } from \"./addMinute\"\nimport { addMonth } from \"./addMonth\"\nimport { addSecond } from \"./addSecond\"\nimport { addYear } from \"./addYear\"\nimport { date } from \"./date\"\nimport { diffDays } from \"./diffDays\"\nimport { diffHours } from \"./diffHours\"\nimport { diffMilliseconds } from \"./diffMilliseconds\"\nimport { diffMinutes } from \"./diffMinutes\"\nimport { diffMonths } from \"./diffMonths\"\nimport { diffSeconds } from \"./diffSeconds\"\nimport { diffWeeks } from \"./diffWeeks\"\nimport { diffYears } from \"./diffYears\"\nimport type { DateInput, Duration, MaybeDateInput } from \"./types\"\n\ntype DurationKey = keyof Duration\n\nfunction negateDuration(duration: Duration): Duration {\n  const negated: Duration = {}\n  for (const unit of Object.keys(duration) as DurationKey[]) {\n    negated[unit] = -duration[unit]!\n  }\n  return negated\n}\n\nfunction calendarDiff(\n  current: Date,\n  target: Date,\n  diffUnit: (dateA: Date, dateB: Date) => number,\n  addUnit: (date: Date, count: number) => Date\n): [number, Date] {\n  let amount = diffUnit(current, target)\n  let next = addUnit(current, -amount)\n  while (amount > 0 && next < target) {\n    amount--\n    next = addUnit(current, -amount)\n  }\n  return [amount, next]\n}\n\n/**\n * Options for `diff` function\n */\nexport interface DiffOptions {\n  /**\n   * whether the difference should be absolute (not negative)\n   */\n  abs?: boolean\n  /**\n   * units you want to skip, for example weeks\n   */\n  skip?: DurationKey[] | Set<DurationKey>\n}\n\n/**\n * Returns the difference between 2 dates in an object\n * @param dateA - A date to compare with the right date\n * @param [dateB] - A date to compare with the left date or nothing to compare with the current time\n * @param [options] additional options\n * @param [options.skip] units you want skip\n * @param [options.abs] whether the difference should be absolute\n * @returns an object which could be used with `Intl.DurationFormat.format'`\n */\nexport function diff(\n  dateA: DateInput,\n  dateB?: MaybeDateInput,\n  options?: DiffOptions\n): Duration\n\n/**\n * Returns the difference between 2 dates in an object\n * @param [dateA] - A date to compare with the right date or null to compare with the current time\n * @param dateB - A date to compare with the left date\n * @param [options] additional options\n * @param [options.skip] units you want skip\n * @param [options.abs] whether the difference should be absolute\n * @returns an object which could be used with `Intl.DurationFormat.format'`\n */\nexport function diff(\n  dateA: MaybeDateInput,\n  dateB: DateInput,\n  options?: DiffOptions\n): Duration\n\nexport function diff(\n  dateA: MaybeDateInput,\n  dateB?: MaybeDateInput,\n  options?: DiffOptions\n): Duration {\n  let a = date(dateA)\n  let b = date(dateB)\n\n  if (a < b) {\n    const duration = diff(b, a, options)\n    return options?.abs ? duration : negateDuration(duration)\n  }\n\n  const skip = new Set(options?.skip)\n  const duration: Duration = {}\n\n  if (!skip.has(\"years\")) {\n    const [years, next] = calendarDiff(a, b, diffYears, addYear)\n    a = next\n    if (years) duration.years = years\n  }\n\n  if (!skip.has(\"months\")) {\n    const [months, next] = calendarDiff(a, b, diffMonths, addMonth)\n    a = next\n    if (months) duration.months = months\n  }\n\n  if (!skip.has(\"weeks\")) {\n    const weeks = diffWeeks(a, b)\n    a = addDay(a, -(weeks * 7))\n    if (weeks) duration.weeks = weeks\n  }\n\n  if (!skip.has(\"days\")) {\n    const days = diffDays(a, b)\n    a = addDay(a, -days)\n    if (days) duration.days = days\n  }\n\n  if (!skip.has(\"hours\")) {\n    const hours = diffHours(a, b)\n    a = addHour(a, -hours)\n    if (hours) duration.hours = hours\n  }\n\n  if (!skip.has(\"minutes\")) {\n    const minutes = diffMinutes(a, b)\n    a = addMinute(a, -minutes)\n    if (minutes) duration.minutes = minutes\n  }\n\n  if (!skip.has(\"seconds\")) {\n    const seconds = diffSeconds(a, b)\n    a = addSecond(a, -seconds)\n    if (seconds) duration.seconds = seconds\n  }\n\n  if (!skip.has(\"milliseconds\")) {\n    const ms = diffMilliseconds(a, b)\n    // removing ms isn't needed as it's the last\n    if (ms) duration.milliseconds = ms\n  }\n  return duration\n}\n"],"mappings":";AAAA,SAAS,cAAc;AACvB,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AACxB,SAAS,YAAY;AACrB,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAC1B,SAAS,wBAAwB;AACjC,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB;AAC1B,SAAS,iBAAiB;AAK1B,SAAS,eAAe,UAA8B;AACpD,QAAM,UAAoB,CAAC;AAC3B,aAAW,QAAQ,OAAO,KAAK,QAAQ,GAAoB;AACzD,YAAQ,IAAI,IAAI,CAAC,SAAS,IAAI;AAAA,EAChC;AACA,SAAO;AACT;AAEA,SAAS,aACP,SACA,QACA,UACA,SACgB;AAChB,MAAI,SAAS,SAAS,SAAS,MAAM;AACrC,MAAI,OAAO,QAAQ,SAAS,CAAC,MAAM;AACnC,SAAO,SAAS,KAAK,OAAO,QAAQ;AAClC;AACA,WAAO,QAAQ,SAAS,CAAC,MAAM;AAAA,EACjC;AACA,SAAO,CAAC,QAAQ,IAAI;AACtB;AA8CO,SAAS,KACd,OACA,OACA,SACU;AACV,MAAI,IAAI,KAAK,KAAK;AAClB,MAAI,IAAI,KAAK,KAAK;AAElB,MAAI,IAAI,GAAG;AACT,UAAMA,YAAW,KAAK,GAAG,GAAG,OAAO;AACnC,YAAO,mCAAS,OAAMA,YAAW,eAAeA,SAAQ;AAAA,EAC1D;AAEA,QAAM,OAAO,IAAI,IAAI,mCAAS,IAAI;AAClC,QAAM,WAAqB,CAAC;AAE5B,MAAI,CAAC,KAAK,IAAI,OAAO,GAAG;AACtB,UAAM,CAAC,OAAO,IAAI,IAAI,aAAa,GAAG,GAAG,WAAW,OAAO;AAC3D,QAAI;AACJ,QAAI,MAAO,UAAS,QAAQ;AAAA,EAC9B;AAEA,MAAI,CAAC,KAAK,IAAI,QAAQ,GAAG;AACvB,UAAM,CAAC,QAAQ,IAAI,IAAI,aAAa,GAAG,GAAG,YAAY,QAAQ;AAC9D,QAAI;AACJ,QAAI,OAAQ,UAAS,SAAS;AAAA,EAChC;AAEA,MAAI,CAAC,KAAK,IAAI,OAAO,GAAG;AACtB,UAAM,QAAQ,UAAU,GAAG,CAAC;AAC5B,QAAI,OAAO,GAAG,EAAE,QAAQ,EAAE;AAC1B,QAAI,MAAO,UAAS,QAAQ;AAAA,EAC9B;AAEA,MAAI,CAAC,KAAK,IAAI,MAAM,GAAG;AACrB,UAAM,OAAO,SAAS,GAAG,CAAC;AAC1B,QAAI,OAAO,GAAG,CAAC,IAAI;AACnB,QAAI,KAAM,UAAS,OAAO;AAAA,EAC5B;AAEA,MAAI,CAAC,KAAK,IAAI,OAAO,GAAG;AACtB,UAAM,QAAQ,UAAU,GAAG,CAAC;AAC5B,QAAI,QAAQ,GAAG,CAAC,KAAK;AACrB,QAAI,MAAO,UAAS,QAAQ;AAAA,EAC9B;AAEA,MAAI,CAAC,KAAK,IAAI,SAAS,GAAG;AACxB,UAAM,UAAU,YAAY,GAAG,CAAC;AAChC,QAAI,UAAU,GAAG,CAAC,OAAO;AACzB,QAAI,QAAS,UAAS,UAAU;AAAA,EAClC;AAEA,MAAI,CAAC,KAAK,IAAI,SAAS,GAAG;AACxB,UAAM,UAAU,YAAY,GAAG,CAAC;AAChC,QAAI,UAAU,GAAG,CAAC,OAAO;AACzB,QAAI,QAAS,UAAS,UAAU;AAAA,EAClC;AAEA,MAAI,CAAC,KAAK,IAAI,cAAc,GAAG;AAC7B,UAAM,KAAK,iBAAiB,GAAG,CAAC;AAEhC,QAAI,GAAI,UAAS,eAAe;AAAA,EAClC;AACA,SAAO;AACT;","names":["duration"]}

package/dist/handleDateOverflow.d.ts

@@ -0,0 +1,12 @@
+import { MaybeDateInput } from './types.js';
+
+/**
+ * Handles date overflow when changing month or year.
+ * @param [inputDate] - A string, Date object or null for the current time
+ * @param action - The action that changes the month/year
+ * @param [dateOverflow] - Whether to allow the date to overflow into another month.
+ * @returns A new Date object with the month/year change applied.
+ */
+declare function handleOverflow(inputDate: MaybeDateInput | undefined, action: (d: Date) => void, dateOverflow?: boolean): Date;
+
+export { handleOverflow };

package/dist/handleDateOverflow.mjs

@@ -0,0 +1,18 @@
+// src/handleDateOverflow.ts
+import { date } from "./date.mjs";
+import { monthDays } from "./monthDays.mjs";
+function handleOverflow(inputDate, action, dateOverflow = false) {
+  const d = date(inputDate);
+  const dayOfMonth = d.getDate();
+  if (!dateOverflow) d.setDate(1);
+  action(d);
+  if (!dateOverflow) {
+    const daysInMonth = monthDays(d);
+    d.setDate(daysInMonth < dayOfMonth ? daysInMonth : dayOfMonth);
+  }
+  return d;
+}
+export {
+  handleOverflow
+};
+//# sourceMappingURL=handleDateOverflow.mjs.map

package/dist/handleDateOverflow.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/handleDateOverflow.ts"],"sourcesContent":["import { date } from \"./date\"\nimport { monthDays } from \"./monthDays\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Handles date overflow when changing month or year.\n * @param [inputDate] - A string, Date object or null for the current time\n * @param action - The action that changes the month/year\n * @param [dateOverflow] - Whether to allow the date to overflow into another month.\n * @returns A new Date object with the month/year change applied.\n */\nexport function handleOverflow(\n  inputDate: MaybeDateInput | undefined,\n  action: (d: Date) => void,\n  dateOverflow = false\n): Date {\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  action(d)\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;AAUnB,SAAS,eACd,WACA,QACA,eAAe,OACT;AACN,QAAM,IAAI,KAAK,SAAS;AACxB,QAAM,aAAa,EAAE,QAAQ;AAE7B,MAAI,CAAC,aAAc,GAAE,QAAQ,CAAC;AAE9B,SAAO,CAAC;AAGR,MAAI,CAAC,cAAc;AACjB,UAAM,cAAc,UAAU,CAAC;AAC/B,MAAE,QAAQ,cAAc,aAAa,cAAc,UAAU;AAAA,EAC/D;AACA,SAAO;AACT;","names":[]}

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  add: () => add,
   addDay: () => addDay,
   addHour: () => addHour,
   addMillisecond: () => addMillisecond,
@@ -33,6 +34,7 @@ __export(index_exports, {
   dayEnd: () => dayEnd,
   dayOfYear: () => dayOfYear,
   dayStart: () => dayStart,
+  diff: () => diff,
   diffDays: () => diffDays,
   diffHours: () => diffHours,
   diffMilliseconds: () => diffMilliseconds,
@@ -70,6 +72,13 @@ __export(index_exports, {
   sameMinute: () => sameMinute,
   sameSecond: () => sameSecond,
   sameYear: () => sameYear,
+  setDayOfMonth: () => setDayOfMonth,
+  setHour: () => setHour,
+  setMilliseconds: () => setMilliseconds,
+  setMinutes: () => setMinutes,
+  setMonth: () => setMonth,
+  setSeconds: () => setSeconds,
+  setYear: () => setYear,
   tzDate: () => tzDate,
   weekEnd: () => weekEnd,
   weekStart: () => weekStart,
@@ -128,6 +137,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);
@@ -143,25 +173,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);
@@ -169,18 +186,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
@@ -190,10 +198,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;
 }
 
@@ -462,22 +511,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;
@@ -1100,12 +1151,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;
 }
@@ -1253,8 +1353,77 @@ 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;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  add,
   addDay,
   addHour,
   addMillisecond,
@@ -1268,6 +1437,7 @@ function diffYears(dateA, dateB) {
   dayEnd,
   dayOfYear,
   dayStart,
+  diff,
   diffDays,
   diffHours,
   diffMilliseconds,
@@ -1305,6 +1475,13 @@ function diffYears(dateA, dateB) {
   sameMinute,
   sameSecond,
   sameYear,
+  setDayOfMonth,
+  setHour,
+  setMilliseconds,
+  setMinutes,
+  setMonth,
+  setSeconds,
+  setYear,
   tzDate,
   weekEnd,
   weekStart,