@formkit/tempo 0.0.19 → 0.1.0

package/dist/formatStr.mjs

@@ -0,0 +1,13 @@
+// src/formatStr.ts
+import { parts } from "./parts.mjs";
+import { escapeTokens } from "./common.mjs";
+function formatStr(format, locale = "en", escapeLiterals = false, filterParts = () => true) {
+  return parts(format, locale).filter(filterParts).reduce(
+    (f, p) => f += escapeLiterals && p.partName === "literal" ? escapeTokens(p.token) : p.token,
+    ""
+  ).normalize("NFKC");
+}
+export {
+  formatStr
+};
+//# sourceMappingURL=formatStr.mjs.map

package/dist/formatStr.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/formatStr.ts"],"sourcesContent":["import { parts } from \"./parts\"\nimport { escapeTokens } from \"./common\"\nimport type { Format, Part } from \"./types\"\n\n/**\n * Return the string format for a given format. For example:\n * ```js\n * formatStr({ date: 'long' }, 'en') // dddd, MMMM D, YYYY\n * ```\n * @param format - A format string or object.\n * @param locale - A locale or en by default.\n */\nexport function formatStr(\n  format: Format,\n  locale = \"en\",\n  escapeLiterals = false,\n  filterParts: (part: Part) => boolean = () => true\n): string {\n  return parts(format, locale)\n    .filter(filterParts)\n    .reduce(\n      (f, p) =>\n        (f +=\n          escapeLiterals && p.partName === \"literal\"\n            ? escapeTokens(p.token)\n            : p.token),\n      \"\"\n    )\n    .normalize(\"NFKC\")\n}\n"],"mappings":";AAAA,SAAS,aAAa;AACtB,SAAS,oBAAoB;AAWtB,SAAS,UACd,QACA,SAAS,MACT,iBAAiB,OACjB,cAAuC,MAAM,MACrC;AACR,SAAO,MAAM,QAAQ,MAAM,EACxB,OAAO,WAAW,EAClB;AAAA,IACC,CAAC,GAAG,MACD,KACC,kBAAkB,EAAE,aAAa,YAC7B,aAAa,EAAE,KAAK,IACpB,EAAE;AAAA,IACV;AAAA,EACF,EACC,UAAU,MAAM;AACrB;","names":[]}

package/dist/fourDigitYear.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Converts a 2 digit year into a 4 digit year. This function assumes years 20
+ * years into the future belong to the current century, and the past 80 are in
+ * the past.
+ *
+ * @param value - 2 digits in string format
+ */
+declare function fourDigitYear(value: string): number;
+
+export { fourDigitYear };

package/dist/fourDigitYear.mjs

@@ -0,0 +1,12 @@
+// src/fourDigitYear.ts
+function fourDigitYear(value) {
+  const y = (/* @__PURE__ */ new Date()).getFullYear();
+  const currentYear = y % 100;
+  const century = Math.floor(y / 100);
+  const parsedYear = Number(value);
+  return (century + (parsedYear > currentYear + 20 ? -1 : 0)) * 100 + parsedYear;
+}
+export {
+  fourDigitYear
+};
+//# sourceMappingURL=fourDigitYear.mjs.map

package/dist/fourDigitYear.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/fourDigitYear.ts"],"sourcesContent":["/**\n * Converts a 2 digit year into a 4 digit year. This function assumes years 20\n * years into the future belong to the current century, and the past 80 are in\n * the past.\n *\n * @param value - 2 digits in string format\n */\nexport function fourDigitYear(value: string): number {\n  const y = new Date().getFullYear()\n  const currentYear = y % 100\n  const century = Math.floor(y / 100)\n  const parsedYear = Number(value)\n  return (century + (parsedYear > currentYear + 20 ? -1 : 0)) * 100 + parsedYear\n}\n"],"mappings":";AAOO,SAAS,cAAc,OAAuB;AACnD,QAAM,KAAI,oBAAI,KAAK,GAAE,YAAY;AACjC,QAAM,cAAc,IAAI;AACxB,QAAM,UAAU,KAAK,MAAM,IAAI,GAAG;AAClC,QAAM,aAAa,OAAO,KAAK;AAC/B,UAAQ,WAAW,aAAa,cAAc,KAAK,KAAK,MAAM,MAAM;AACtE;","names":[]}

package/dist/hourEnd.d.ts

@@ -0,0 +1,9 @@
+import { DateInput } from './types.js';
+
+/**
+ * Returns a Date object for end of the given hour.
+ * @param inputDate - A string or Date object
+ */
+declare function hourEnd(inputDate: DateInput): Date;
+
+export { hourEnd };

package/dist/hourEnd.mjs

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

package/dist/hourEnd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hourEnd.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { DateInput } from \"./types\"\n\n/**\n * Returns a Date object for end of the given hour.\n * @param inputDate - A string or Date object\n */\nexport function hourEnd(inputDate: DateInput): Date {\n  const d = date(inputDate)\n  d.setMinutes(59, 59, 999)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAOd,SAAS,QAAQ,WAA4B;AAClD,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,WAAW,IAAI,IAAI,GAAG;AACxB,SAAO;AACT;","names":[]}

package/dist/hourStart.d.ts

@@ -0,0 +1,9 @@
+import { DateInput } from './types.js';
+
+/**
+ * Returns a Date object for start of the given hour.
+ * @param inputDate - A string or Date object
+ */
+declare function hourStart(inputDate: DateInput): Date;
+
+export { hourStart };

package/dist/hourStart.mjs

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

package/dist/hourStart.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hourStart.ts"],"sourcesContent":["import { date } from \"./date\"\nimport type { DateInput } from \"./types\"\n\n/**\n * Returns a Date object for start of the given hour.\n * @param inputDate - A string or Date object\n */\nexport function hourStart(inputDate: DateInput): Date {\n  const d = date(inputDate)\n  d.setMinutes(0, 0)\n  return d\n}\n"],"mappings":";AAAA,SAAS,YAAY;AAOd,SAAS,UAAU,WAA4B;AACpD,QAAM,IAAI,KAAK,SAAS;AACxB,IAAE,WAAW,GAAG,CAAC;AACjB,SAAO;AACT;","names":[]}

package/dist/index.cjs

@@ -32,6 +32,14 @@ __export(src_exports, {
   dayEnd: () => dayEnd,
   dayOfYear: () => dayOfYear,
   dayStart: () => dayStart,
+  diffDays: () => diffDays,
+  diffHours: () => diffHours,
+  diffMilliseconds: () => diffMilliseconds,
+  diffMinutes: () => diffMinutes,
+  diffMonths: () => diffMonths,
+  diffSeconds: () => diffSeconds,
+  diffWeeks: () => diffWeeks,
+  diffYears: () => diffYears,
   format: () => format,
   formatStr: () => formatStr,
   fourDigitYear: () => fourDigitYear,
@@ -204,6 +212,7 @@ var clockAgnostic = [
   ["m", { minute: "numeric" }],
   ["ss", { second: "2-digit" }],
   ["s", { second: "numeric" }],
+  ["ZZ", { timeZoneName: "long" }],
   ["Z", { timeZoneName: "short" }]
 ];
 var clock24 = [
@@ -274,7 +283,7 @@ function fill(inputDate, parts2, locale, genitive = false, offset2 = null) {
       return token === "A" ? p.toUpperCase() : p.toLowerCase();
     }
     if (partName === "timeZoneName") {
-      return offset2 != null ? offset2 : minsToOffset(-1 * d.getTimezoneOffset());
+      return offset2 != null ? offset2 : minsToOffset(-1 * d.getTimezoneOffset(), token);
     }
     return value2;
   }
@@ -345,23 +354,35 @@ function createPartMap(inputDate, parts2, locale, genitive = false) {
     return map;
   }, {});
 }
-function minsToOffset(timeDiffInMins) {
+function minsToOffset(timeDiffInMins, token = "Z") {
   const hours = String(Math.floor(Math.abs(timeDiffInMins / 60))).padStart(
     2,
     "0"
   );
   const mins = String(Math.abs(timeDiffInMins % 60)).padStart(2, "0");
   const sign = timeDiffInMins < 0 ? "-" : "+";
-  return `${sign}${hours}${mins}`;
+  if (token === "ZZ") {
+    return `${sign}${hours}${mins}`;
+  }
+  return `${sign}${hours}:${mins}`;
 }
-function offsetToMins(offset2) {
-  validOffset(offset2);
-  const [_, sign, hours, mins] = offset2.match(/([+-])([0-3][0-9])([0-6][0-9])/);
+function offsetToMins(offset2, token) {
+  validOffset(offset2, token);
+  const [_, sign, hours, mins] = offset2.match(
+    /([+-])([0-3][0-9]):?([0-6][0-9])/
+  );
   const offsetInMins = Number(hours) * 60 + Number(mins);
   return sign === "+" ? offsetInMins : -offsetInMins;
 }
-function validOffset(offset2) {
-  const valid = /^([+-])[0-3][0-9]:?[0-6][0-9]$/.test(offset2);
+function validOffset(offset2, token = "Z") {
+  const valid = ((token2) => {
+    switch (token2) {
+      case "Z":
+        return /^([+-])[0-3][0-9]:[0-6][0-9]$/.test(offset2);
+      case "ZZ":
+        return /^([+-])[0-3][0-9][0-6][0-9]$/.test(offset2);
+    }
+  })(token);
   if (!valid)
     throw new Error(`Invalid offset: ${offset2}`);
   return offset2;
@@ -391,6 +412,12 @@ function validate(parts2) {
   }
   return parts2;
 }
+function getOffsetFormat(format2) {
+  if (typeof format2 === "string") {
+    return format2.includes("ZZ") ? "ZZ" : "Z";
+  }
+  return "time" in format2 && format2.time === "full" ? "Z" : "ZZ";
+}
 
 // src/ap.ts
 function ap(ampm, locale) {
@@ -417,9 +444,17 @@ function ap(ampm, locale) {
 }
 
 // src/applyOffset.ts
-function applyOffset(dateInput, offset2 = "+0000") {
+function applyOffset(dateInput, offset2 = "+00:00") {
   const d = date(dateInput);
-  const timeDiffInMins = offsetToMins(offset2);
+  const token = (() => {
+    switch (fixedLengthByOffset(offset2)) {
+      case 5:
+        return "ZZ";
+      case 6:
+        return "Z";
+    }
+  })();
+  const timeDiffInMins = offsetToMins(offset2, token);
   return new Date(d.getTime() + timeDiffInMins * 1e3 * 60);
 }
 
@@ -448,14 +483,14 @@ function relativeTime(d, timeZone) {
     `${parts2.year}-${parts2.month}-${parts2.day}T${parts2.hour}:${parts2.minute}:${parts2.second}Z`
   );
 }
-function offset(utcTime, tzA = "UTC", tzB = "device") {
+function offset(utcTime, tzA = "UTC", tzB = "device", timeZoneToken = "Z") {
   var _a;
   tzB = tzB === "device" ? (_a = deviceTZ()) != null ? _a : "utc" : tzB;
   const d = date(utcTime);
   const timeA = relativeTime(d, tzA);
   const timeB = relativeTime(d, tzB);
   const timeDiffInMins = (timeB.getTime() - timeA.getTime()) / 1e3 / 60;
-  return minsToOffset(timeDiffInMins);
+  return minsToOffset(timeDiffInMins, timeZoneToken);
 }
 
 // src/tzDate.ts
@@ -572,7 +607,8 @@ function styleParts(format2, locale) {
       part.type,
       part.value,
       locale,
-      part.type === "hour" ? hourType : void 0
+      part.type === "hour" ? hourType : void 0,
+      options
     );
     if (formatPattern === void 0)
       return;
@@ -591,7 +627,7 @@ function styleParts(format2, locale) {
     };
   }).filter((part) => !!part);
 }
-function guessPattern(partName, partValue, locale, hour) {
+function guessPattern(partName, partValue, locale, hour, options) {
   const l = partValue.length;
   const n = !isNaN(Number(partValue));
   let style;
@@ -633,8 +669,7 @@ function guessPattern(partName, partValue, locale, hour) {
     case "literal":
       return [partValue, { literal: partValue }, new RegExp("")];
     case "timeZoneName":
-      const offset2 = partValue.split("-");
-      return offset2.length === 2 && offset2[1].length === 4 ? tokens.get("ZZ") : tokens.get("Z");
+      return options.timeStyle === "full" ? tokens.get("Z") : tokens.get("ZZ");
     default:
       return void 0;
   }
@@ -688,7 +723,7 @@ function partStyle(locale, part, value) {
 }
 
 // src/removeOffset.ts
-function removeOffset(dateInput, offset2 = "+0000") {
+function removeOffset(dateInput, offset2 = "+00:00") {
   const positive = offset2.slice(0, 1) === "+";
   return applyOffset(
     dateInput,
@@ -718,7 +753,7 @@ function format(inputDateOrOptions, format2 = "long", locale = "device", genitiv
   if (format2 === "ISO8601")
     return date(inputDateOrOptions).toISOString();
   if (tz) {
-    forceOffset = offset(inputDateOrOptions, "utc", tz);
+    forceOffset = offset(inputDateOrOptions, "utc", tz, getOffsetFormat(format2));
   }
   tz != null ? tz : tz = deviceTZ();
   if ((tz == null ? void 0 : tz.toLowerCase()) !== "utc") {
@@ -950,8 +985,8 @@ function parse(dateStrOrOptions, format2 = "ISO8601", locale = "device") {
         parsed.set("MM", v);
       } else if (t === "a" || t === "A") {
         a = part.value.toLowerCase() === ap("am", locale).toLowerCase();
-      } else if (t === "Z") {
-        offset2 = validOffset(part.value);
+      } else if (t === "Z" || t === "ZZ") {
+        offset2 = validOffset(part.value, t);
       } else {
         const values = range(t, locale, genitive);
         const index = values.indexOf(part.value);
@@ -1124,6 +1159,82 @@ function isEqual(dateLeft, dateRight) {
   const _dateRight = date(dateRight);
   return +_dateLeft === +_dateRight;
 }
+
+// src/diffMilliseconds.ts
+function diffMilliseconds(dateA, dateB) {
+  const left = date(dateA);
+  const right = date(dateB);
+  return +left - +right;
+}
+
+// src/diffRound.ts
+function diffRound(value, method = "trunc") {
+  const r = Math[method](value);
+  return r == 0 ? 0 : r;
+}
+
+// src/diffSeconds.ts
+function diffSeconds(dateA, dateB, roundingMethod) {
+  return diffRound(diffMilliseconds(dateA, dateB) / 1e3, roundingMethod);
+}
+
+// src/diffMinutes.ts
+function diffMinutes(dateA, dateB, roundingMethod) {
+  return diffRound(diffMilliseconds(dateA, dateB) / 6e4, roundingMethod);
+}
+
+// src/diffHours.ts
+function diffHours(dateA, dateB, roundingMethod) {
+  return diffRound(
+    diffMilliseconds(dateA, dateB) / 36e5,
+    // 1000 * 60 * 60
+    roundingMethod
+  );
+}
+
+// src/diffDays.ts
+function diffDays(dateA, dateB, roundingMethod) {
+  return diffRound(
+    diffMilliseconds(dateA, dateB) / 864e5,
+    // hour * 24
+    roundingMethod
+  );
+}
+
+// src/diffWeeks.ts
+function diffWeeks(dateA, dateB, roundingMethod) {
+  return diffRound(
+    diffMilliseconds(dateA, dateB) / 6048e5,
+    // day * 7
+    roundingMethod
+  );
+}
+
+// src/diffMonths.ts
+function diffMonths(dateA, dateB) {
+  const l = date(dateA);
+  const r = date(dateB);
+  if (l < r) {
+    const rs = diffMonths(r, l);
+    return rs == 0 ? 0 : -rs;
+  }
+  let months = (l.getFullYear() - r.getFullYear()) * 12 + (l.getMonth() - r.getMonth());
+  const ld = l.getDate();
+  const rd = r.getDate();
+  if (ld < rd) {
+    const lm = monthDays(l);
+    if (!(lm == ld && lm < rd)) {
+      months--;
+    }
+  }
+  return months == 0 ? 0 : months;
+}
+
+// src/diffYears.ts
+function diffYears(dateA, dateB) {
+  const r = Math.trunc(diffMonths(dateA, dateB) / 12);
+  return r == 0 ? 0 : r;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   addDay,
@@ -1138,6 +1249,14 @@ function isEqual(dateLeft, dateRight) {
   dayEnd,
   dayOfYear,
   dayStart,
+  diffDays,
+  diffHours,
+  diffMilliseconds,
+  diffMinutes,
+  diffMonths,
+  diffSeconds,
+  diffWeeks,
+  diffYears,
   format,
   formatStr,
   fourDigitYear,