@formkit/tempo 1.0.0 → 1.1.0

package/dist/index.d.cts

@@ -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/index.d.ts

@@ -1,3 +1,4 @@
+export { add } from './add.js';
 export { addDay } from './addDay.js';
 export { addMonth } from './addMonth.js';
 export { addYear } from './addYear.js';
@@ -35,6 +36,13 @@ export { sameMillisecond } from './sameMillisecond.js';
 export { sameMinute } from './sameMinute.js';
 export { sameHour } from './sameHour.js';
 export { sameYear } from './sameYear.js';
+export { setMilliseconds } from './setMilliseconds.js';
+export { setSeconds } from './setSeconds.js';
+export { setMinutes } from './setMinutes.js';
+export { setHour } from './setHour.js';
+export { setDayOfMonth } from './setDayOfMonth.js';
+export { setMonth } from './setMonth.js';
+export { setYear } from './setYear.js';
 export { weekEnd } from './weekEnd.js';
 export { weekStart } from './weekStart.js';
 export { yearDays } from './yearDays.js';
@@ -45,7 +53,7 @@ export { isAfter } from './isAfter.js';
 export { isEqual } from './isEqual.js';
 export { isPast } from './isPast.js';
 export { isFuture } from './isFuture.js';
-export { DateInput, ExtendedPartTypes, FilledPart, Format, FormatOptions, FormatPattern, FormatStyle, FormatStyleObj, FormatToken, MaybeDateInput, NamedFormatOption, NamedFormats, ParseOptions, Part } from './types.js';
+export { DateInput, Duration, DurationObj, ExtendedPartTypes, FilledPart, Format, FormatOptions, FormatPattern, FormatStyle, FormatStyleObj, FormatToken, MaybeDateInput, NamedFormatOption, NamedFormats, ParseOptions, Part } from './types.js';
 export { diffMilliseconds } from './diffMilliseconds.js';
 export { diffSeconds } from './diffSeconds.js';
 export { diffMinutes } from './diffMinutes.js';
@@ -54,5 +62,6 @@ export { diffDays } from './diffDays.js';
 export { diffWeeks } from './diffWeeks.js';
 export { diffMonths } from './diffMonths.js';
 export { diffYears } from './diffYears.js';
+export { DiffOptions, diff } from './diff.js';
 import './common.js';
 import './diffRound.js';

package/dist/index.mjs

@@ -1,4 +1,5 @@
 // src/index.ts
+import { add } from "./add.mjs";
 import { addDay } from "./addDay.mjs";
 import { addMonth } from "./addMonth.mjs";
 import { addYear } from "./addYear.mjs";
@@ -37,6 +38,13 @@ import { sameMillisecond } from "./sameMillisecond.mjs";
 import { sameMinute } from "./sameMinute.mjs";
 import { sameHour } from "./sameHour.mjs";
 import { sameYear } from "./sameYear.mjs";
+import { setMilliseconds } from "./setMilliseconds.mjs";
+import { setSeconds } from "./setSeconds.mjs";
+import { setMinutes } from "./setMinutes.mjs";
+import { setHour } from "./setHour.mjs";
+import { setDayOfMonth } from "./setDayOfMonth.mjs";
+import { setMonth } from "./setMonth.mjs";
+import { setYear } from "./setYear.mjs";
 import { weekEnd } from "./weekEnd.mjs";
 import { weekStart } from "./weekStart.mjs";
 import { yearDays } from "./yearDays.mjs";
@@ -56,7 +64,9 @@ import { diffDays } from "./diffDays.mjs";
 import { diffWeeks } from "./diffWeeks.mjs";
 import { diffMonths } from "./diffMonths.mjs";
 import { diffYears } from "./diffYears.mjs";
+import { diff } from "./diff.mjs";
 export {
+  add,
   addDay,
   addHour,
   addMillisecond,
@@ -70,6 +80,7 @@ export {
   dayEnd,
   dayOfYear,
   dayStart,
+  diff,
   diffDays,
   diffHours,
   diffMilliseconds,
@@ -107,6 +118,13 @@ export {
   sameMinute,
   sameSecond,
   sameYear,
+  setDayOfMonth,
+  setHour,
+  setMilliseconds,
+  setMinutes,
+  setMonth,
+  setSeconds,
+  setYear,
   tzDate,
   weekEnd,
   weekStart,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { addDay } from \"./addDay\"\nexport { addMonth } from \"./addMonth\"\nexport { addYear } from \"./addYear\"\nexport { addHour } from \"./addHour\"\nexport { addMinute } from \"./addMinute\"\nexport { addSecond } from \"./addSecond\"\nexport { addMillisecond } from \"./addMillisecond\"\nexport { ap } from \"./ap\"\nexport { applyOffset } from \"./applyOffset\"\nexport { date } from \"./date\"\nexport { tzDate } from \"./tzDate\"\nexport { dayOfYear } from \"./dayOfYear\"\nexport { dayEnd } from \"./dayEnd\"\nexport { dayStart } from \"./dayStart\"\nexport { format } from \"./format\"\nexport { formatStr } from \"./formatStr\"\nexport { fourDigitYear } from \"./fourDigitYear\"\nexport { hourEnd } from \"./hourEnd\"\nexport { hourStart } from \"./hourStart\"\nexport { iso8601 } from \"./iso8601\"\nexport { minuteEnd } from \"./minuteEnd\"\nexport { minuteStart } from \"./minuteStart\"\nexport { monthDays } from \"./monthDays\"\nexport { monthEnd } from \"./monthEnd\"\nexport { monthStart } from \"./monthStart\"\nexport { nearestDay } from \"./nearestDay\"\nexport { offset } from \"./offset\"\nexport { parse } from \"./parse\"\nexport { parseParts } from \"./parse\"\nexport { parts } from \"./parts\"\nexport { range } from \"./range\"\nexport { removeOffset } from \"./removeOffset\"\nexport { sameDay } from \"./sameDay\"\nexport { sameSecond } from \"./sameSecond\"\nexport { sameMillisecond } from \"./sameMillisecond\"\nexport { sameMinute } from \"./sameMinute\"\nexport { sameHour } from \"./sameHour\"\nexport { sameYear } from \"./sameYear\"\nexport { weekEnd } from \"./weekEnd\"\nexport { weekStart } from \"./weekStart\"\nexport { yearDays } from \"./yearDays\"\nexport { yearStart } from \"./yearStart\"\nexport { yearEnd } from \"./yearEnd\"\nexport { isBefore } from \"./isBefore\"\nexport { isAfter } from \"./isAfter\"\nexport { isEqual } from \"./isEqual\"\nexport { isPast } from \"./isPast\"\nexport { isFuture } from \"./isFuture\"\nexport * from \"./types\"\nexport { diffMilliseconds } from \"./diffMilliseconds\"\nexport { diffSeconds } from \"./diffSeconds\"\nexport { diffMinutes } from \"./diffMinutes\"\nexport { diffHours } from \"./diffHours\"\nexport { diffDays } from \"./diffDays\"\nexport { diffWeeks } from \"./diffWeeks\"\nexport { diffMonths } from \"./diffMonths\"\nexport { diffYears } from \"./diffYears\"\n"],"mappings":";AAAA,SAAS,cAAc;AACvB,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,iBAAiB;AAC1B,SAAS,sBAAsB;AAC/B,SAAS,UAAU;AACnB,SAAS,mBAAmB;AAC5B,SAAS,YAAY;AACrB,SAAS,cAAc;AACvB,SAAS,iBAAiB;AAC1B,SAAS,cAAc;AACvB,SAAS,gBAAgB;AACzB,SAAS,cAAc;AACvB,SAAS,iBAAiB;AAC1B,SAAS,qBAAqB;AAC9B,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB;AAC3B,SAAS,cAAc;AACvB,SAAS,aAAa;AACtB,SAAS,kBAAkB;AAC3B,SAAS,aAAa;AACtB,SAAS,aAAa;AACtB,SAAS,oBAAoB;AAC7B,SAAS,eAAe;AACxB,SAAS,kBAAkB;AAC3B,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AACxB,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,eAAe;AACxB,SAAS,cAAc;AACvB,SAAS,gBAAgB;AACzB,cAAc;AACd,SAAS,wBAAwB;AACjC,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAC3B,SAAS,iBAAiB;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { add } from \"./add\"\nexport { addDay } from \"./addDay\"\nexport { addMonth } from \"./addMonth\"\nexport { addYear } from \"./addYear\"\nexport { addHour } from \"./addHour\"\nexport { addMinute } from \"./addMinute\"\nexport { addSecond } from \"./addSecond\"\nexport { addMillisecond } from \"./addMillisecond\"\nexport { ap } from \"./ap\"\nexport { applyOffset } from \"./applyOffset\"\nexport { date } from \"./date\"\nexport { tzDate } from \"./tzDate\"\nexport { dayOfYear } from \"./dayOfYear\"\nexport { dayEnd } from \"./dayEnd\"\nexport { dayStart } from \"./dayStart\"\nexport { format } from \"./format\"\nexport { formatStr } from \"./formatStr\"\nexport { fourDigitYear } from \"./fourDigitYear\"\nexport { hourEnd } from \"./hourEnd\"\nexport { hourStart } from \"./hourStart\"\nexport { iso8601 } from \"./iso8601\"\nexport { minuteEnd } from \"./minuteEnd\"\nexport { minuteStart } from \"./minuteStart\"\nexport { monthDays } from \"./monthDays\"\nexport { monthEnd } from \"./monthEnd\"\nexport { monthStart } from \"./monthStart\"\nexport { nearestDay } from \"./nearestDay\"\nexport { offset } from \"./offset\"\nexport { parse } from \"./parse\"\nexport { parseParts } from \"./parse\"\nexport { parts } from \"./parts\"\nexport { range } from \"./range\"\nexport { removeOffset } from \"./removeOffset\"\nexport { sameDay } from \"./sameDay\"\nexport { sameSecond } from \"./sameSecond\"\nexport { sameMillisecond } from \"./sameMillisecond\"\nexport { sameMinute } from \"./sameMinute\"\nexport { sameHour } from \"./sameHour\"\nexport { sameYear } from \"./sameYear\"\nexport { setMilliseconds } from \"./setMilliseconds\"\nexport { setSeconds } from \"./setSeconds\"\nexport { setMinutes } from \"./setMinutes\"\nexport { setHour } from \"./setHour\"\nexport { setDayOfMonth } from \"./setDayOfMonth\"\nexport { setMonth } from \"./setMonth\"\nexport { setYear } from \"./setYear\"\nexport { weekEnd } from \"./weekEnd\"\nexport { weekStart } from \"./weekStart\"\nexport { yearDays } from \"./yearDays\"\nexport { yearStart } from \"./yearStart\"\nexport { yearEnd } from \"./yearEnd\"\nexport { isBefore } from \"./isBefore\"\nexport { isAfter } from \"./isAfter\"\nexport { isEqual } from \"./isEqual\"\nexport { isPast } from \"./isPast\"\nexport { isFuture } from \"./isFuture\"\nexport * from \"./types\"\nexport { diffMilliseconds } from \"./diffMilliseconds\"\nexport { diffSeconds } from \"./diffSeconds\"\nexport { diffMinutes } from \"./diffMinutes\"\nexport { diffHours } from \"./diffHours\"\nexport { diffDays } from \"./diffDays\"\nexport { diffWeeks } from \"./diffWeeks\"\nexport { diffMonths } from \"./diffMonths\"\nexport { diffYears } from \"./diffYears\"\nexport { diff, type DiffOptions } from \"./diff\"\n"],"mappings":";AAAA,SAAS,WAAW;AACpB,SAAS,cAAc;AACvB,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,iBAAiB;AAC1B,SAAS,sBAAsB;AAC/B,SAAS,UAAU;AACnB,SAAS,mBAAmB;AAC5B,SAAS,YAAY;AACrB,SAAS,cAAc;AACvB,SAAS,iBAAiB;AAC1B,SAAS,cAAc;AACvB,SAAS,gBAAgB;AACzB,SAAS,cAAc;AACvB,SAAS,iBAAiB;AAC1B,SAAS,qBAAqB;AAC9B,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB;AAC3B,SAAS,cAAc;AACvB,SAAS,aAAa;AACtB,SAAS,kBAAkB;AAC3B,SAAS,aAAa;AACtB,SAAS,aAAa;AACtB,SAAS,oBAAoB;AAC7B,SAAS,eAAe;AACxB,SAAS,kBAAkB;AAC3B,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AACzB,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB;AAC3B,SAAS,eAAe;AACxB,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAC1B,SAAS,eAAe;AACxB,SAAS,gBAAgB;AACzB,SAAS,eAAe;AACxB,SAAS,eAAe;AACxB,SAAS,cAAc;AACvB,SAAS,gBAAgB;AACzB,cAAc;AACd,SAAS,wBAAwB;AACjC,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,iBAAiB;AAC1B,SAAS,kBAAkB;AAC3B,SAAS,iBAAiB;AAC1B,SAAS,YAA8B;","names":[]}

package/dist/offset.mjs

@@ -1,25 +1,27 @@
 // src/offset.ts
 import { date } from "./date.mjs";
-import { normStr, secsToOffset } from "./common.mjs";
+import { secsToOffset } from "./common.mjs";
 import { deviceTZ } from "./deviceTZ.mjs";
 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 parts = {};
+  }).formatToParts(d);
+  const p = {};
   utcParts.forEach((part) => {
-    parts[part.type] = part.value;
+    if (part.type !== "literal") p[part.type] = part.value;
   });
-  return /* @__PURE__ */ new Date(
-    `${parts.year}-${parts.month}-${parts.day}T${parts.hour}:${parts.minute}:${parts.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;

package/dist/offset.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/offset.ts"],"sourcesContent":["import { date } from \"./date\"\nimport { normStr, secsToOffset, TimezoneToken } from \"./common\"\nimport { deviceTZ } from \"./deviceTZ\"\nimport type { DateInput, MaybeDateInput } from \"./types\"\n\n/**\n * Converts a date object from one timezone to that same time in UTC. This is\n * only for internal use.\n * @param d - A Date object\n * @param timeZone - A timezone string\n */\nfunction relativeTime(d: Date, timeZone: string): Date {\n  const utcParts = new Intl.DateTimeFormat(\"en-US\", {\n    year: \"numeric\",\n    month: \"2-digit\",\n    day: \"2-digit\",\n    hour: \"2-digit\",\n    minute: \"2-digit\",\n    second: \"2-digit\",\n    timeZone,\n    hourCycle: \"h23\",\n  })\n    .formatToParts(d)\n    .map(normStr)\n  const parts: {\n    year?: string\n    month?: string\n    day?: string\n    hour?: string\n    minute?: string\n    second?: string\n  } = {}\n  utcParts.forEach((part) => {\n    parts[part.type as keyof typeof parts] = part.value\n  })\n  return new Date(\n    `${parts.year}-${parts.month}-${parts.day}T${parts.hour}:${parts.minute}:${parts.second}Z`\n  )\n}\n\n/**\n * Returns the offset between two timezones on a given date. The results are\n * ISO8601 compatible offsets like -0800 or +0530.\n *\n * @param [dateInput] - (default: current time) The date on which to determine the offset\n * @param [tzA] - (default: UTC) The second timezone to compare determine the offset between.\n * @param [tzB] - (default: device) The first timezone to compare determine the offset between.\n */\nexport function offset(\n  utcTime?: MaybeDateInput,\n  tzA = \"UTC\",\n  tzB = \"device\",\n  timeZoneToken: TimezoneToken = \"Z\"\n): string {\n  tzB = tzB === \"device\" ? deviceTZ() ?? \"utc\" : tzB\n  const d = date(utcTime)\n  const timeA = relativeTime(d, tzA)\n  const timeB = relativeTime(d, tzB)\n  const timeDiffInSecs = Math.round((timeB.getTime() - timeA.getTime()) / 1000)\n  return secsToOffset(timeDiffInSecs, timeZoneToken)\n}\n"],"mappings":";AAAA,SAAS,YAAY;AACrB,SAAS,SAAS,oBAAmC;AACrD,SAAS,gBAAgB;AASzB,SAAS,aAAa,GAAS,UAAwB;AACrD,QAAM,WAAW,IAAI,KAAK,eAAe,SAAS;AAAA,IAChD,MAAM;AAAA,IACN,OAAO;AAAA,IACP,KAAK;AAAA,IACL,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR;AAAA,IACA,WAAW;AAAA,EACb,CAAC,EACE,cAAc,CAAC,EACf,IAAI,OAAO;AACd,QAAM,QAOF,CAAC;AACL,WAAS,QAAQ,CAAC,SAAS;AACzB,UAAM,KAAK,IAA0B,IAAI,KAAK;AAAA,EAChD,CAAC;AACD,SAAO,oBAAI;AAAA,IACT,GAAG,MAAM,IAAI,IAAI,MAAM,KAAK,IAAI,MAAM,GAAG,IAAI,MAAM,IAAI,IAAI,MAAM,MAAM,IAAI,MAAM,MAAM;AAAA,EACzF;AACF;AAUO,SAAS,OACd,SACA,MAAM,OACN,MAAM,UACN,gBAA+B,KACvB;AArDV;AAsDE,QAAM,QAAQ,YAAW,cAAS,MAAT,YAAc,QAAQ;AAC/C,QAAM,IAAI,KAAK,OAAO;AACtB,QAAM,QAAQ,aAAa,GAAG,GAAG;AACjC,QAAM,QAAQ,aAAa,GAAG,GAAG;AACjC,QAAM,iBAAiB,KAAK,OAAO,MAAM,QAAQ,IAAI,MAAM,QAAQ,KAAK,GAAI;AAC5E,SAAO,aAAa,gBAAgB,aAAa;AACnD;","names":[]}
+{"version":3,"sources":["../src/offset.ts"],"sourcesContent":["import { date } from \"./date\"\nimport { secsToOffset, TimezoneToken } from \"./common\"\nimport { deviceTZ } from \"./deviceTZ\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * Converts a date object from one timezone to that same time in UTC. This is\n * only for internal use.\n * @param d - A Date object\n * @param timeZone - A timezone string\n */\nfunction relativeTime(d: Date, timeZone: string): Date {\n  const utcParts = new Intl.DateTimeFormat(\"en-US\", {\n    era: \"short\",\n    year: \"numeric\",\n    month: \"numeric\",\n    day: \"numeric\",\n    hour: \"numeric\",\n    minute: \"numeric\",\n    second: \"numeric\",\n    timeZone,\n    hourCycle: \"h23\",\n  }).formatToParts(d)\n  const p: Record<string, string> = {}\n  utcParts.forEach((part) => {\n    if (part.type !== \"literal\") p[part.type] = part.value\n  })\n  // BC year N in Intl = ISO year (1 - N), e.g. 1 BC = year 0, 2 BC = year -1\n  const year = p.era === \"BC\" ? 1 - Number(p.year) : Number(p.year)\n  const result = new Date(Date.UTC(0, 0, 1, Number(p.hour), Number(p.minute), Number(p.second)))\n  // setUTCFullYear with year, month, day together avoids Date.UTC's 0-99 year mapping\n  // and ensures leap day validation uses the correct year\n  result.setUTCFullYear(year, Number(p.month) - 1, Number(p.day))\n  return result\n}\n\n/**\n * Returns the offset between two timezones on a given date. The results are\n * ISO8601 compatible offsets like -0800 or +0530.\n *\n * @param [dateInput] - (default: current time) The date on which to determine the offset\n * @param [tzA] - (default: UTC) The second timezone to compare determine the offset between.\n * @param [tzB] - (default: device) The first timezone to compare determine the offset between.\n */\nexport function offset(\n  utcTime?: MaybeDateInput,\n  tzA = \"UTC\",\n  tzB = \"device\",\n  timeZoneToken: TimezoneToken = \"Z\"\n): string {\n  tzB = tzB === \"device\" ? deviceTZ() ?? \"utc\" : tzB\n  const d = date(utcTime)\n  const timeA = relativeTime(d, tzA)\n  const timeB = relativeTime(d, tzB)\n  const timeDiffInSecs = Math.round((timeB.getTime() - timeA.getTime()) / 1000)\n  return secsToOffset(timeDiffInSecs, timeZoneToken)\n}\n"],"mappings":";AAAA,SAAS,YAAY;AACrB,SAAS,oBAAmC;AAC5C,SAAS,gBAAgB;AASzB,SAAS,aAAa,GAAS,UAAwB;AACrD,QAAM,WAAW,IAAI,KAAK,eAAe,SAAS;AAAA,IAChD,KAAK;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,KAAK;AAAA,IACL,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR;AAAA,IACA,WAAW;AAAA,EACb,CAAC,EAAE,cAAc,CAAC;AAClB,QAAM,IAA4B,CAAC;AACnC,WAAS,QAAQ,CAAC,SAAS;AACzB,QAAI,KAAK,SAAS,UAAW,GAAE,KAAK,IAAI,IAAI,KAAK;AAAA,EACnD,CAAC;AAED,QAAM,OAAO,EAAE,QAAQ,OAAO,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI;AAChE,QAAM,SAAS,IAAI,KAAK,KAAK,IAAI,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC;AAG7F,SAAO,eAAe,MAAM,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,EAAE,GAAG,CAAC;AAC9D,SAAO;AACT;AAUO,SAAS,OACd,SACA,MAAM,OACN,MAAM,UACN,gBAA+B,KACvB;AAjDV;AAkDE,QAAM,QAAQ,YAAW,cAAS,MAAT,YAAc,QAAQ;AAC/C,QAAM,IAAI,KAAK,OAAO;AACtB,QAAM,QAAQ,aAAa,GAAG,GAAG;AACjC,QAAM,QAAQ,aAAa,GAAG,GAAG;AACjC,QAAM,iBAAiB,KAAK,OAAO,MAAM,QAAQ,IAAI,MAAM,QAAQ,KAAK,GAAI;AAC5E,SAAO,aAAa,gBAAgB,aAAa;AACnD;","names":[]}

package/dist/setDayOfMonth.d.ts

@@ -0,0 +1,11 @@
+import { MaybeDateInput } from './types.js';
+
+/**
+ * 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;
+
+export { setDayOfMonth };

package/dist/setDayOfMonth.mjs

@@ -0,0 +1,16 @@
+// src/setDayOfMonth.ts
+import { date } from "./date.mjs";
+import { monthDays } from "./monthDays.mjs";
+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;
+}
+export {
+  setDayOfMonth
+};
+//# sourceMappingURL=setDayOfMonth.mjs.map

package/dist/setDayOfMonth.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setDayOfMonth.ts"],"sourcesContent":["import { date } from \"./date\"\nimport { monthDays } from \"./monthDays\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * set the day of the month in a date object\n * @param [inputDate] - a date or null for current time\n * @param day - the day of the month you want the date set to (1-28/29/30/31) (can over/underflow)\n * @param [dateOverflow] - Whether or not to allow the date to overflow to another month if the given day isn't in the current month\n */\nexport function setDayOfMonth(\n  inputDate: MaybeDateInput,\n  day: number,\n  dateOverflow = false\n): Date {\n  const d = date(inputDate)\n  const daysInMonth = monthDays(d)\n  if (!dateOverflow) {\n    day = day > daysInMonth ? daysInMonth : day\n  }\n  d.setDate(day)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AACrB,SAAS,iBAAiB;AASnB,SAAS,cACd,WACA,KACA,eAAe,OACT;AACN,QAAM,IAAI,KAAK,SAAS;AACxB,QAAM,cAAc,UAAU,CAAC;AAC/B,MAAI,CAAC,cAAc;AACjB,UAAM,MAAM,cAAc,cAAc;AAAA,EAC1C;AACA,IAAE,QAAQ,GAAG;AACb,SAAO;AACT;","names":[]}

package/dist/setHour.d.ts

@@ -0,0 +1,10 @@
+import { MaybeDateInput } from './types.js';
+
+/**
+ * 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;
+
+export { setHour };

package/dist/setHour.mjs

@@ -0,0 +1,11 @@
+// src/setHour.ts
+import { date } from "./date.mjs";
+function setHour(inputDate, hour) {
+  const d = date(inputDate);
+  d.setHours(hour);
+  return d;
+}
+export {
+  setHour
+};
+//# sourceMappingURL=setHour.mjs.map

package/dist/setHour.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setHour.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * set the hour of a date object\n * @param [inputDate] - a date or null for current time\n * @param hour - the hour you want the date set to (0 - 23) (can over/underflow)\n */\nexport function setHour(inputDate: MaybeDateInput, hour: number): Date {\n  const d = date(inputDate)\n  d.setHours(hour)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAQd,SAAS,QAAQ,WAA2B,MAAoB;AACrE,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,SAAS,IAAI;AACf,SAAO;AACT;","names":[]}

package/dist/setMilliseconds.d.ts

@@ -0,0 +1,10 @@
+import { MaybeDateInput } from './types.js';
+
+/**
+ * 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;
+
+export { setMilliseconds };

package/dist/setMilliseconds.mjs

@@ -0,0 +1,11 @@
+// src/setMilliseconds.ts
+import { date } from "./date.mjs";
+function setMilliseconds(inputDate, ms) {
+  const d = date(inputDate);
+  d.setMilliseconds(ms);
+  return d;
+}
+export {
+  setMilliseconds
+};
+//# sourceMappingURL=setMilliseconds.mjs.map

package/dist/setMilliseconds.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setMilliseconds.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * set the millisecond of a date object\n * @param [inputDate] - a date or null for current time\n * @param ms - the milliseconds you want the date set to (0 - 999) (can over/underflow)\n */\nexport function setMilliseconds(inputDate: MaybeDateInput, ms: number): Date {\n  const d = date(inputDate)\n  d.setMilliseconds(ms)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAQd,SAAS,gBAAgB,WAA2B,IAAkB;AAC3E,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,gBAAgB,EAAE;AACpB,SAAO;AACT;","names":[]}

package/dist/setMinutes.d.ts

@@ -0,0 +1,10 @@
+import { MaybeDateInput } from './types.js';
+
+/**
+ * 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;
+
+export { setMinutes };

package/dist/setMinutes.mjs

@@ -0,0 +1,11 @@
+// src/setMinutes.ts
+import { date } from "./date.mjs";
+function setMinutes(inputDate, minute) {
+  const d = date(inputDate);
+  d.setMinutes(minute);
+  return d;
+}
+export {
+  setMinutes
+};
+//# sourceMappingURL=setMinutes.mjs.map

package/dist/setMinutes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setMinutes.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * set the minute of a date object\n * @param [inputDate] - a date or null for current time\n * @param minute - the minute you want the date set to (0 - 59) (can over/underflow)\n */\nexport function setMinutes(inputDate: MaybeDateInput, minute: number): Date {\n  const d = date(inputDate)\n  d.setMinutes(minute)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAQd,SAAS,WAAW,WAA2B,QAAsB;AAC1E,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,WAAW,MAAM;AACnB,SAAO;AACT;","names":[]}

package/dist/setMonth.d.ts

@@ -0,0 +1,11 @@
+import { MaybeDateInput } from './types.js';
+
+/**
+ * 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;
+
+export { setMonth };

package/dist/setMonth.mjs

@@ -0,0 +1,9 @@
+// src/setMonth.ts
+import { handleOverflow } from "./handleDateOverflow.mjs";
+function setMonth(inputDate, month, dateOverflow = false) {
+  return handleOverflow(inputDate, (d) => d.setMonth(month), dateOverflow);
+}
+export {
+  setMonth
+};
+//# sourceMappingURL=setMonth.mjs.map

package/dist/setMonth.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setMonth.ts"],"sourcesContent":["import { handleOverflow } from \"./handleDateOverflow\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * set the month of a date\n * @param [inputDate] - a date or null for current time\n * @param month - the zero-based month to set (0-11, where 0 is January) (can over/underflow)\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 setMonth(\n  inputDate: MaybeDateInput,\n  month: number,\n  dateOverflow = false\n): Date {\n  return handleOverflow(inputDate, (d) => d.setMonth(month), dateOverflow)\n}\n"],"mappings":";AAAA,SAAS,sBAAsB;AASxB,SAAS,SACd,WACA,OACA,eAAe,OACT;AACN,SAAO,eAAe,WAAW,CAAC,MAAM,EAAE,SAAS,KAAK,GAAG,YAAY;AACzE;","names":[]}

package/dist/setSeconds.d.ts

@@ -0,0 +1,10 @@
+import { MaybeDateInput } from './types.js';
+
+/**
+ * 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;
+
+export { setSeconds };

package/dist/setSeconds.mjs

@@ -0,0 +1,11 @@
+// src/setSeconds.ts
+import { date } from "./date.mjs";
+function setSeconds(inputDate, second) {
+  const d = date(inputDate);
+  d.setSeconds(second);
+  return d;
+}
+export {
+  setSeconds
+};
+//# sourceMappingURL=setSeconds.mjs.map

package/dist/setSeconds.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setSeconds.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { MaybeDateInput } from \"./types\"\n\n/**\n * set the second of a date object\n * @param [inputDate] - a date or null for current time\n * @param second - the second you want the date set to (0 - 59) (can over/underflow)\n */\nexport function setSeconds(inputDate: MaybeDateInput, second: number): Date {\n  const d = date(inputDate)\n  d.setSeconds(second)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAQd,SAAS,WAAW,WAA2B,QAAsB;AAC1E,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,WAAW,MAAM;AACnB,SAAO;AACT;","names":[]}

package/dist/setYear.d.ts

@@ -0,0 +1,11 @@
+import { MaybeDateInput } from './types.js';
+
+/**
+ * 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;
+
+export { setYear };

package/dist/setYear.mjs

@@ -0,0 +1,9 @@
+// src/setYear.ts
+import { handleOverflow } from "./handleDateOverflow.mjs";
+function setYear(inputDate, year, dateOverflow = false) {
+  return handleOverflow(inputDate, (d) => d.setFullYear(year), dateOverflow);
+}
+export {
+  setYear
+};
+//# sourceMappingURL=setYear.mjs.map

package/dist/setYear.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setYear.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { MaybeDateInput } from \"./types\"\nimport { handleOverflow } from \"./handleDateOverflow\"\n\n/**\n * set the year of a date object\n * @param inputDate - a date or null for current time\n * @param year - the full year you want the date to be set to\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 setYear(\n  inputDate: MaybeDateInput,\n  year: number,\n  dateOverflow = false\n): Date {\n  return handleOverflow(inputDate, (d) => d.setFullYear(year), dateOverflow)\n}\n"],"mappings":";AAEA,SAAS,sBAAsB;AAQxB,SAAS,QACd,WACA,MACA,eAAe,OACT;AACN,SAAO,eAAe,WAAW,CAAC,MAAM,EAAE,YAAY,IAAI,GAAG,YAAY;AAC3E;","names":[]}

package/dist/types.d.ts

@@ -147,5 +147,19 @@ 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;
+}
 
-export type { DateInput, ExtendedPartTypes, FilledPart, Format, FormatOptions, FormatPattern, FormatStyle, FormatStyleObj, FormatToken, MaybeDateInput, NamedFormatOption, NamedFormats, ParseOptions, Part };
+export type { DateInput, Duration, DurationObj, ExtendedPartTypes, FilledPart, Format, FormatOptions, FormatPattern, FormatStyle, FormatStyleObj, FormatToken, MaybeDateInput, NamedFormatOption, NamedFormats, ParseOptions, Part };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formkit/tempo",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "packageManager": "pnpm@10.11.0",
   "description": "The easiest way to work with dates in JavaScript and TypeScript.",
   "type": "module",
@@ -33,11 +33,11 @@
     "url": "https://github.com/formkit/tempo/issues"
   },
   "scripts": {
-    "dev": "cd ./docs && pnpm nuxt dev",
+    "dev": "npm --prefix ./docs run dev",
     "build": "tsup",
     "post:build": "node scripts/size-limit/index.js || echo 'Size limit check skipped'",
     "test": "TZ=\"America/New_York\" vitest",
-    "docs-build": "cd ./docs && pnpm run build",
+    "docs-build": "npm --prefix ./docs run build",
     "publint": "publint",
     "release": "pnpm build && bumpp --push",
     "size": "npm run build && size-limit"