@northguild/gmt 1.18.0 → 1.19.0

package/dist/utc/get/getUtcMillisecond.js

@@ -4,21 +4,14 @@ import { Temporal } from "@js-temporal/polyfill";
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 3 digits.
- * - Returns "" on failure.
  *
- * @returns current millisecond string (zero-padded to 3 digits) or "" on failure
+ * @returns current millisecond string (zero-padded to 3 digits)
  *
  * @example getUtcMillisecond() // "123"
- * @example getUtcMillisecond() // "" (on failure)
  */
 export function getUtcMillisecond() {
-    try {
-        return Temporal.Now.instant()
-            .toZonedDateTimeISO("UTC")
-            .millisecond.toString()
-            .padStart(3, "0");
-    }
-    catch {
-        return "";
-    }
+    return Temporal.Now.instant()
+        .toZonedDateTimeISO("UTC")
+        .millisecond.toString()
+        .padStart(3, "0");
 }

package/dist/utc/get/getUtcMinute.d.ts

@@ -3,11 +3,9 @@
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 2 digits.
- * - Returns "" on failure.
  *
- * @returns current minute string (zero-padded to 2 digits) or "" on failure
+ * @returns current minute string (zero-padded to 2 digits)
  *
  * @example getUtcMinute() // "30"
- * @example getUtcMinute() // "" (on failure)
  */
 export declare function getUtcMinute(): string;

package/dist/utc/get/getUtcMinute.js

@@ -4,21 +4,14 @@ import { Temporal } from "@js-temporal/polyfill";
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 2 digits.
- * - Returns "" on failure.
  *
- * @returns current minute string (zero-padded to 2 digits) or "" on failure
+ * @returns current minute string (zero-padded to 2 digits)
  *
  * @example getUtcMinute() // "30"
- * @example getUtcMinute() // "" (on failure)
  */
 export function getUtcMinute() {
-    try {
-        return Temporal.Now.instant()
-            .toZonedDateTimeISO("UTC")
-            .minute.toString()
-            .padStart(2, "0");
-    }
-    catch {
-        return "";
-    }
+    return Temporal.Now.instant()
+        .toZonedDateTimeISO("UTC")
+        .minute.toString()
+        .padStart(2, "0");
 }

package/dist/utc/get/getUtcMonth.d.ts

@@ -3,11 +3,9 @@
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 2 digits.
- * - Returns "" on failure.
  *
- * @returns current month string (zero-padded to 2 digits) or "" on failure
+ * @returns current month string (zero-padded to 2 digits)
  *
  * @example getUtcMonth() // "02"
- * @example getUtcMonth() // "" (on failure)
  */
 export declare function getUtcMonth(): string;

package/dist/utc/get/getUtcMonth.js

@@ -4,21 +4,14 @@ import { Temporal } from "@js-temporal/polyfill";
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 2 digits.
- * - Returns "" on failure.
  *
- * @returns current month string (zero-padded to 2 digits) or "" on failure
+ * @returns current month string (zero-padded to 2 digits)
  *
  * @example getUtcMonth() // "02"
- * @example getUtcMonth() // "" (on failure)
  */
 export function getUtcMonth() {
-    try {
-        return Temporal.Now.instant()
-            .toZonedDateTimeISO("UTC")
-            .month.toString()
-            .padStart(2, "0");
-    }
-    catch {
-        return "";
-    }
+    return Temporal.Now.instant()
+        .toZonedDateTimeISO("UTC")
+        .month.toString()
+        .padStart(2, "0");
 }

package/dist/utc/get/getUtcNanosecond.d.ts

@@ -3,11 +3,9 @@
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 3 digits.
- * - Returns "" on failure.
  *
- * @returns current nanosecond string (zero-padded to 3 digits) or "" on failure
+ * @returns current nanosecond string (zero-padded to 3 digits)
  *
  * @example getUtcNanosecond() // "789"
- * @example getUtcNanosecond() // "" (on failure)
  */
 export declare function getUtcNanosecond(): string;

package/dist/utc/get/getUtcNanosecond.js

@@ -4,20 +4,13 @@ import { Temporal } from "@js-temporal/polyfill";
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 3 digits.
- * - Returns "" on failure.
  *
- * @returns current nanosecond string (zero-padded to 3 digits) or "" on failure
+ * @returns current nanosecond string (zero-padded to 3 digits)
  *
  * @example getUtcNanosecond() // "789"
- * @example getUtcNanosecond() // "" (on failure)
  */
 export function getUtcNanosecond() {
-    try {
-        return (Temporal.Now.instant().toZonedDateTimeISO("UTC").nanosecond ?? 0)
-            .toString()
-            .padStart(3, "0");
-    }
-    catch {
-        return "";
-    }
+    return (Temporal.Now.instant().toZonedDateTimeISO("UTC").nanosecond ?? 0)
+        .toString()
+        .padStart(3, "0");
 }

package/dist/utc/get/getUtcNow.d.ts

@@ -2,11 +2,9 @@
  * Return the current UTC instant as an ISO Instant string.
  *
  * - Uses Temporal.Now.instant() to get current UTC time.
- * - Returns "" on failure.
  *
- * @returns ISO Instant string (e.g. "2024-02-29T00:00:00Z") or "" on failure
+ * @returns ISO Instant string (e.g. "2024-02-29T00:00:00Z")
  *
  * @example getUtcNow() // "2024-02-29T00:00:00Z"
- * @example getUtcNow() // "" (on failure)
  */
 export declare function getUtcNow(): string;

package/dist/utc/get/getUtcNow.js

@@ -3,18 +3,11 @@ import { Temporal } from "@js-temporal/polyfill";
  * Return the current UTC instant as an ISO Instant string.
  *
  * - Uses Temporal.Now.instant() to get current UTC time.
- * - Returns "" on failure.
  *
- * @returns ISO Instant string (e.g. "2024-02-29T00:00:00Z") or "" on failure
+ * @returns ISO Instant string (e.g. "2024-02-29T00:00:00Z")
  *
  * @example getUtcNow() // "2024-02-29T00:00:00Z"
- * @example getUtcNow() // "" (on failure)
  */
 export function getUtcNow() {
-    try {
-        return Temporal.Now.instant().toString();
-    }
-    catch {
-        return "";
-    }
+    return Temporal.Now.instant().toString();
 }

package/dist/utc/get/getUtcNowUnit.d.ts

@@ -8,6 +8,8 @@ export type { UtcNowUnit };
  * - `unit` accepts the singular or plural name of a Temporal unit (`"hour"` or `"hours"`), as Temporal
  *   does; `"dayOfWeek"` has no plural.
  * - Returns "" on invalid unit or failure.
+ * - The `"year"` unit is written as Temporal writes a year: four digits (`"2024"`, `"0005"`), or a
+ *   sign and six digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  *
  * @param unit unit to extract from current utc instant
  * @returns string representation of the requested unit or "" on invalid

package/dist/utc/get/getUtcNowUnit.js

@@ -13,6 +13,8 @@ function isValidUtcNowUnit(unit) {
  * - `unit` accepts the singular or plural name of a Temporal unit (`"hour"` or `"hours"`), as Temporal
  *   does; `"dayOfWeek"` has no plural.
  * - Returns "" on invalid unit or failure.
+ * - The `"year"` unit is written as Temporal writes a year: four digits (`"2024"`, `"0005"`), or a
+ *   sign and six digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  *
  * @param unit unit to extract from current utc instant
  * @returns string representation of the requested unit or "" on invalid

package/dist/utc/get/getUtcSecond.d.ts

@@ -3,11 +3,9 @@
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 2 digits.
- * - Returns "" on failure.
  *
- * @returns current second string (zero-padded to 2 digits) or "" on failure
+ * @returns current second string (zero-padded to 2 digits)
  *
  * @example getUtcSecond() // "45"
- * @example getUtcSecond() // "" (on failure)
  */
 export declare function getUtcSecond(): string;

package/dist/utc/get/getUtcSecond.js

@@ -4,21 +4,14 @@ import { Temporal } from "@js-temporal/polyfill";
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 2 digits.
- * - Returns "" on failure.
  *
- * @returns current second string (zero-padded to 2 digits) or "" on failure
+ * @returns current second string (zero-padded to 2 digits)
  *
  * @example getUtcSecond() // "45"
- * @example getUtcSecond() // "" (on failure)
  */
 export function getUtcSecond() {
-    try {
-        return Temporal.Now.instant()
-            .toZonedDateTimeISO("UTC")
-            .second.toString()
-            .padStart(2, "0");
-    }
-    catch {
-        return "";
-    }
+    return Temporal.Now.instant()
+        .toZonedDateTimeISO("UTC")
+        .second.toString()
+        .padStart(2, "0");
 }

package/dist/utc/get/getUtcYear.d.ts

@@ -3,11 +3,11 @@
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 4 digits.
- * - Returns "" on failure.
+ * - A year outside 0000–9999 is written with a sign and six digits (`+010000`, `-000005`), as
+ *   Temporal writes it at the head of a date.
  *
- * @returns current year string (zero-padded to 4 digits) or "" on failure
+ * @returns current year string (zero-padded to 4 digits)
  *
  * @example getUtcYear() // "2024"
- * @example getUtcYear() // "" (on failure)
  */
 export declare function getUtcYear(): string;

package/dist/utc/get/getUtcYear.js

@@ -1,24 +1,17 @@
 import { Temporal } from "@js-temporal/polyfill";
+import { isoYearString } from "../../internal/isoYearString.js";
 /**
  * Return the current year from UTC as a zero-padded string.
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 4 digits.
- * - Returns "" on failure.
+ * - A year outside 0000–9999 is written with a sign and six digits (`+010000`, `-000005`), as
+ *   Temporal writes it at the head of a date.
  *
- * @returns current year string (zero-padded to 4 digits) or "" on failure
+ * @returns current year string (zero-padded to 4 digits)
  *
  * @example getUtcYear() // "2024"
- * @example getUtcYear() // "" (on failure)
  */
 export function getUtcYear() {
-    try {
-        return Temporal.Now.instant()
-            .toZonedDateTimeISO("UTC")
-            .year.toString()
-            .padStart(4, "0");
-    }
-    catch {
-        return "";
-    }
+    return isoYearString(Temporal.Now.instant().toZonedDateTimeISO("UTC").year);
 }

package/dist/utc/interval/intervalXorAllUtc.js

@@ -1,6 +1,7 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { halfOpenXor } from "../../internal/index.js";
 import { isValidUtcInterval } from "./validate/index.js";
+import { isObject } from "../../internal/isObject.js";
 /**
  * Return the symmetric difference across a list of UTC intervals — the set of instants covered
  * by an odd number of the input intervals.
@@ -30,8 +31,7 @@ export function intervalXorAllUtc(intervals) {
         if (!Array.isArray(intervals) || intervals.length === 0) {
             return [];
         }
-        if (!intervals.every((interval) => interval &&
-            typeof interval === "object" &&
+        if (!intervals.every((interval) => isObject(interval) &&
             typeof interval.start === "string" &&
             typeof interval.end === "string" &&
             isValidUtcInterval(interval.start, interval.end))) {

package/dist/utc/interval/mergeIntervalsUtc.js

@@ -1,6 +1,7 @@
 import { canonicalInstantIntervals } from "../../internal/index.js";
 import { mergeIntervals } from "../../interval/calculate/index.js";
 import { isValidUtcInterval } from "./validate/index.js";
+import { isObject } from "../../internal/isObject.js";
 /**
  * Collapse a list of UTC intervals into the minimum set of non-overlapping intervals.
  *
@@ -31,8 +32,7 @@ export function mergeIntervalsUtc(intervals) {
         if (!Array.isArray(intervals) || intervals.length === 0) {
             return [];
         }
-        if (!intervals.every((interval) => interval &&
-            typeof interval === "object" &&
+        if (!intervals.every((interval) => isObject(interval) &&
             typeof interval.start === "string" &&
             typeof interval.end === "string" &&
             isValidUtcInterval(interval.start, interval.end))) {

package/dist/utc/parse/index.d.ts

@@ -2,7 +2,7 @@ export * from "./parseDateFromUtc.js";
 export * from "./parseDayFromUtc.js";
 export * from "./parseDayOfWeekFromUtc.js";
 export * from "./parseHourFromUtc.js";
-export * from "./parseHttp.js";
+export * from "./parseHttpDate.js";
 export * from "./parseMicrosecondFromUtc.js";
 export * from "./parseMillisecondFromUtc.js";
 export * from "./parseMinuteFromUtc.js";

package/dist/utc/parse/index.js

@@ -2,7 +2,7 @@ export * from "./parseDateFromUtc.js";
 export * from "./parseDayFromUtc.js";
 export * from "./parseDayOfWeekFromUtc.js";
 export * from "./parseHourFromUtc.js";
-export * from "./parseHttp.js";
+export * from "./parseHttpDate.js";
 export * from "./parseMicrosecondFromUtc.js";
 export * from "./parseMillisecondFromUtc.js";
 export * from "./parseMinuteFromUtc.js";

package/dist/utc/parse/parseDateFromUtc.d.ts

@@ -14,8 +14,10 @@
  */
 export declare function parseDateFromUtc(value: string, options?: {
     /**
-     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset, or `"local"` for
-     * the system time zone. An unknown zone returns `""`.
+     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset (a time zone
+     * identifier such as `+05:30`, `+0530` or `-08`, or a stored offset `±HH:MM[:SS]`, what
+     * `getTimeZoneOffset` returns), or `"local"` for the system time zone. An unknown zone returns
+     * `""`.
      *
      * @defaultValue `"UTC"`
      */

package/dist/utc/parse/parseDateFromUtc.js

@@ -1,4 +1,4 @@
-import { utcZonedDateTime } from "../../internal/utcZonedDateTime.js";
+import { utcWallClock } from "../../internal/utcWallClock.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
  * Extract the date portion from a UTC datetime string.
@@ -19,7 +19,7 @@ export function parseDateFromUtc(value, options) {
         if (!isOptionsArgument(options)) {
             return "";
         }
-        const dateTime = utcZonedDateTime(value, options);
+        const dateTime = utcWallClock(value, options);
         return dateTime === null ? "" : dateTime.toPlainDate().toString();
     }
     catch {

package/dist/utc/parse/parseDayFromUtc.d.ts

@@ -14,8 +14,10 @@
  */
 export declare function parseDayFromUtc(value: string, options?: {
     /**
-     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset, or `"local"` for
-     * the system time zone. An unknown zone returns `""`.
+     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset (a time zone
+     * identifier such as `+05:30`, `+0530` or `-08`, or a stored offset `±HH:MM[:SS]`, what
+     * `getTimeZoneOffset` returns), or `"local"` for the system time zone. An unknown zone returns
+     * `""`.
      *
      * @defaultValue `"UTC"`
      */

package/dist/utc/parse/parseDayFromUtc.js

@@ -1,4 +1,4 @@
-import { utcZonedDateTime } from "../../internal/utcZonedDateTime.js";
+import { utcWallClock } from "../../internal/utcWallClock.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
  * Return the day of month (1-31) from a UTC datetime string.
@@ -19,7 +19,7 @@ export function parseDayFromUtc(value, options) {
         if (!isOptionsArgument(options)) {
             return "";
         }
-        const dateTime = utcZonedDateTime(value, options);
+        const dateTime = utcWallClock(value, options);
         return dateTime === null ? "" : dateTime.day.toString().padStart(2, "0");
     }
     catch {

package/dist/utc/parse/parseDayOfWeekFromUtc.d.ts

@@ -15,8 +15,10 @@
  */
 export declare function parseDayOfWeekFromUtc(value: string, options?: {
     /**
-     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset, or `"local"` for
-     * the system time zone. An unknown zone returns `null`.
+     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset (a time zone
+     * identifier such as `+05:30`, `+0530` or `-08`, or a stored offset `±HH:MM[:SS]`, what
+     * `getTimeZoneOffset` returns), or `"local"` for the system time zone. An unknown zone returns
+     * `null`.
      *
      * @defaultValue `"UTC"`
      */

package/dist/utc/parse/parseDayOfWeekFromUtc.js

@@ -1,5 +1,5 @@
 import { Temporal } from "@js-temporal/polyfill";
-import { normalizeTimeZone } from "../../internal/normalizeTimeZone.js";
+import { frameWallClock, normalizeZoneFrame } from "../../internal/zoneFrame.js";
 import { isValidUtc } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
@@ -24,11 +24,11 @@ export function parseDayOfWeekFromUtc(value, options) {
         }
         if (!isValidUtc(value))
             return null;
-        const timeZone = normalizeTimeZone(options?.timeZone);
-        if (timeZone === "")
+        const frame = normalizeZoneFrame(options?.timeZone);
+        if (frame === null)
             return null;
         try {
-            const dateTime = Temporal.Instant.from(value).toZonedDateTimeISO(timeZone);
+            const dateTime = frameWallClock(Temporal.Instant.from(value), frame);
             return dateTime.dayOfWeek;
         }
         catch {

package/dist/utc/parse/parseHourFromUtc.d.ts

@@ -14,8 +14,10 @@
  */
 export declare function parseHourFromUtc(value: string, options?: {
     /**
-     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset, or `"local"` for
-     * the system time zone. An unknown zone returns `""`.
+     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset (a time zone
+     * identifier such as `+05:30`, `+0530` or `-08`, or a stored offset `±HH:MM[:SS]`, what
+     * `getTimeZoneOffset` returns), or `"local"` for the system time zone. An unknown zone returns
+     * `""`.
      *
      * @defaultValue `"UTC"`
      */

package/dist/utc/parse/parseHourFromUtc.js

@@ -1,4 +1,4 @@
-import { utcZonedDateTime } from "../../internal/utcZonedDateTime.js";
+import { utcWallClock } from "../../internal/utcWallClock.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
  * Return the hour (0-23) from a UTC datetime string.
@@ -19,7 +19,7 @@ export function parseHourFromUtc(value, options) {
         if (!isOptionsArgument(options)) {
             return "";
         }
-        const dateTime = utcZonedDateTime(value, options);
+        const dateTime = utcWallClock(value, options);
         return dateTime === null ? "" : dateTime.hour.toString().padStart(2, "0");
     }
     catch {

package/dist/utc/parse/{parseHttp.d.ts → parseHttpDate.d.ts}

@@ -1,9 +1,9 @@
 /**
- * Parse an RFC 9110 HTTP-date — the fixed grammar HTTP headers like
- * `Last-Modified`/`Date`/`Expires` use — into a UTC ISO 8601 datetime string.
+ * Parse an HTTP header date — the RFC 9110 HTTP-date that headers like
+ * `Last-Modified`/`Date`/`Expires` carry — into a UTC ISO 8601 datetime string.
  *
  * - **Decoding, not display.** Accepts English weekday/month names only, per
- *   the fixed grammar (see `formatHttp`'s JSDoc).
+ *   the fixed grammar (see `formatHttpDate`'s JSDoc).
  * - **All three HTTP-date formats**, as RFC 9110 §5.6.7 requires ("A
  *   recipient that parses a timestamp value in an HTTP field MUST accept all
  *   three"): IMF-fixdate (`Sun, 06 Nov 1994 08:49:37 GMT`), the obsolete
@@ -36,14 +36,14 @@
  * @param value RFC 9110 HTTP-date string (e.g. "Fri, 15 Mar 2024 14:30:00 GMT")
  * @returns UTC ISO 8601 datetime string, or "" on invalid input
  *
- * @example parseHttp("Fri, 15 Mar 2024 14:30:00 GMT") // "2024-03-15T14:30:00Z"
- * @example parseHttp("Sunday, 06-Nov-94 08:49:37 GMT") // "1994-11-06T08:49:37Z" (rfc850-date)
- * @example parseHttp("Sun Nov  6 08:49:37 1994") // "1994-11-06T08:49:37Z" (asctime-date)
- * @example parseHttp("Fri, 15 Mar 2024 14:30:00 -0400") // "" (not an HTTP-date)
- * @example parseHttp("Sat, 15 Mar 2024 14:30:00 GMT") // "" (15 Mar 2024 was a Friday)
- * @example parseHttp("Mon Nov  6 08:49:37 1994") // "" (asctime-date; 6 Nov 1994 was a Sunday)
+ * @example parseHttpDate("Fri, 15 Mar 2024 14:30:00 GMT") // "2024-03-15T14:30:00Z"
+ * @example parseHttpDate("Sunday, 06-Nov-94 08:49:37 GMT") // "1994-11-06T08:49:37Z" (rfc850-date)
+ * @example parseHttpDate("Sun Nov  6 08:49:37 1994") // "1994-11-06T08:49:37Z" (asctime-date)
+ * @example parseHttpDate("Fri, 15 Mar 2024 14:30:00 -0400") // "" (not an HTTP-date)
+ * @example parseHttpDate("Sat, 15 Mar 2024 14:30:00 GMT") // "" (15 Mar 2024 was a Friday)
+ * @example parseHttpDate("Mon Nov  6 08:49:37 1994") // "" (asctime-date; 6 Nov 1994 was a Sunday)
  * @example convertZonedToUtc(parseRfc2822("15 Mar 2024 14:30:00 GMT")) // "2024-03-15T14:30:00Z" — the day name removed
- * @example parseHttp("Sat, 31 Feb 2024 14:30:00 GMT") // "" (impossible date)
- * @example parseHttp("not a date") // ""
+ * @example parseHttpDate("Sat, 31 Feb 2024 14:30:00 GMT") // "" (impossible date)
+ * @example parseHttpDate("not a date") // ""
  */
-export declare function parseHttp(value: string): string;
+export declare function parseHttpDate(value: string): string;

package/dist/utc/parse/{parseHttp.js → parseHttpDate.js}

@@ -3,11 +3,11 @@ import { ENGLISH_MONTH_NAMES, ENGLISH_WEEKDAY_NAMES } from "../../internal/index
 import { readObsoleteHttpDate, } from "../../internal/httpDateFields.js";
 import { httpDate } from "../../regex/index.js";
 /**
- * Parse an RFC 9110 HTTP-date — the fixed grammar HTTP headers like
- * `Last-Modified`/`Date`/`Expires` use — into a UTC ISO 8601 datetime string.
+ * Parse an HTTP header date — the RFC 9110 HTTP-date that headers like
+ * `Last-Modified`/`Date`/`Expires` carry — into a UTC ISO 8601 datetime string.
  *
  * - **Decoding, not display.** Accepts English weekday/month names only, per
- *   the fixed grammar (see `formatHttp`'s JSDoc).
+ *   the fixed grammar (see `formatHttpDate`'s JSDoc).
  * - **All three HTTP-date formats**, as RFC 9110 §5.6.7 requires ("A
  *   recipient that parses a timestamp value in an HTTP field MUST accept all
  *   three"): IMF-fixdate (`Sun, 06 Nov 1994 08:49:37 GMT`), the obsolete
@@ -40,17 +40,17 @@ import { httpDate } from "../../regex/index.js";
  * @param value RFC 9110 HTTP-date string (e.g. "Fri, 15 Mar 2024 14:30:00 GMT")
  * @returns UTC ISO 8601 datetime string, or "" on invalid input
  *
- * @example parseHttp("Fri, 15 Mar 2024 14:30:00 GMT") // "2024-03-15T14:30:00Z"
- * @example parseHttp("Sunday, 06-Nov-94 08:49:37 GMT") // "1994-11-06T08:49:37Z" (rfc850-date)
- * @example parseHttp("Sun Nov  6 08:49:37 1994") // "1994-11-06T08:49:37Z" (asctime-date)
- * @example parseHttp("Fri, 15 Mar 2024 14:30:00 -0400") // "" (not an HTTP-date)
- * @example parseHttp("Sat, 15 Mar 2024 14:30:00 GMT") // "" (15 Mar 2024 was a Friday)
- * @example parseHttp("Mon Nov  6 08:49:37 1994") // "" (asctime-date; 6 Nov 1994 was a Sunday)
+ * @example parseHttpDate("Fri, 15 Mar 2024 14:30:00 GMT") // "2024-03-15T14:30:00Z"
+ * @example parseHttpDate("Sunday, 06-Nov-94 08:49:37 GMT") // "1994-11-06T08:49:37Z" (rfc850-date)
+ * @example parseHttpDate("Sun Nov  6 08:49:37 1994") // "1994-11-06T08:49:37Z" (asctime-date)
+ * @example parseHttpDate("Fri, 15 Mar 2024 14:30:00 -0400") // "" (not an HTTP-date)
+ * @example parseHttpDate("Sat, 15 Mar 2024 14:30:00 GMT") // "" (15 Mar 2024 was a Friday)
+ * @example parseHttpDate("Mon Nov  6 08:49:37 1994") // "" (asctime-date; 6 Nov 1994 was a Sunday)
  * @example convertZonedToUtc(parseRfc2822("15 Mar 2024 14:30:00 GMT")) // "2024-03-15T14:30:00Z" — the day name removed
- * @example parseHttp("Sat, 31 Feb 2024 14:30:00 GMT") // "" (impossible date)
- * @example parseHttp("not a date") // ""
+ * @example parseHttpDate("Sat, 31 Feb 2024 14:30:00 GMT") // "" (impossible date)
+ * @example parseHttpDate("not a date") // ""
  */
-export function parseHttp(value) {
+export function parseHttpDate(value) {
     if (typeof value !== "string")
         return "";
     try {

package/dist/utc/parse/parseMicrosecondFromUtc.d.ts

@@ -15,8 +15,10 @@
  */
 export declare function parseMicrosecondFromUtc(value: string, options?: {
     /**
-     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset, or `"local"` for
-     * the system time zone. An unknown zone returns `""`.
+     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset (a time zone
+     * identifier such as `+05:30`, `+0530` or `-08`, or a stored offset `±HH:MM[:SS]`, what
+     * `getTimeZoneOffset` returns), or `"local"` for the system time zone. An unknown zone returns
+     * `""`.
      *
      * @defaultValue `"UTC"`
      */

package/dist/utc/parse/parseMicrosecondFromUtc.js

@@ -1,4 +1,4 @@
-import { utcZonedDateTime } from "../../internal/utcZonedDateTime.js";
+import { utcWallClock } from "../../internal/utcWallClock.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
  * Return the microsecond (0-999) from a UTC datetime string.
@@ -20,7 +20,7 @@ export function parseMicrosecondFromUtc(value, options) {
         if (!isOptionsArgument(options)) {
             return "";
         }
-        const dateTime = utcZonedDateTime(value, options);
+        const dateTime = utcWallClock(value, options);
         return dateTime === null
             ? ""
             : dateTime.microsecond.toString().padStart(3, "0");

package/dist/utc/parse/parseMillisecondFromUtc.d.ts

@@ -14,8 +14,10 @@
  */
 export declare function parseMillisecondFromUtc(value: string, options?: {
     /**
-     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset, or `"local"` for
-     * the system time zone. An unknown zone returns `""`.
+     * The time zone the wall-clock fields are read in: an IANA name, a UTC offset (a time zone
+     * identifier such as `+05:30`, `+0530` or `-08`, or a stored offset `±HH:MM[:SS]`, what
+     * `getTimeZoneOffset` returns), or `"local"` for the system time zone. An unknown zone returns
+     * `""`.
      *
      * @defaultValue `"UTC"`
      */

package/dist/utc/parse/parseMillisecondFromUtc.js

@@ -1,4 +1,4 @@
-import { utcZonedDateTime } from "../../internal/utcZonedDateTime.js";
+import { utcWallClock } from "../../internal/utcWallClock.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
  * Return the millisecond (0-999) from a UTC datetime string.
@@ -19,7 +19,7 @@ export function parseMillisecondFromUtc(value, options) {
         if (!isOptionsArgument(options)) {
             return "";
         }
-        const dateTime = utcZonedDateTime(value, options);
+        const dateTime = utcWallClock(value, options);
         return dateTime === null
             ? ""
             : dateTime.millisecond.toString().padStart(3, "0");