@northguild/gmt 1.18.0 → 1.20.0

package/dist/utc/get/getUtcNanosecond.js

@@ -1,23 +1,16 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current nanosecond from UTC as a zero-padded string.
  *
  * - 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

@@ -1,20 +1,13 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * 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

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isoWeekOfYear, zonedNowUnitValue, } from "../../internal/zonedNowUnitValue.js";
 import { isValidDateTimeUnit } from "../../plain/validate/index.js";
 import { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.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

@@ -1,24 +1,17 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current second from UTC as a zero-padded string.
  *
  * - 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 { Temporal } from "../../internal/temporal.js";
+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/index.d.ts

@@ -1,4 +1,4 @@
-export * from "@js-temporal/polyfill";
+export { Intl, Temporal, toTemporalInstant } from "../internal/temporal.js";
 export * from "./calculate/index.js";
 export * from "./chop/index.js";
 export * from "./compare/index.js";

package/dist/utc/index.js

@@ -1,5 +1,5 @@
-// Re-export the Temporal polyfill (`Temporal`, `Intl`, `toTemporalInstant`) so every namespace subpath offers it
-export * from "@js-temporal/polyfill";
+// Re-export `Temporal`, `Intl` and `toTemporalInstant` from the internal seam so every namespace subpath offers them
+export { Intl, Temporal, toTemporalInstant } from "../internal/temporal.js";
 export * from "./calculate/index.js";
 export * from "./chop/index.js";
 export * from "./compare/index.js";

package/dist/utc/interval/intervalAbutsUtc.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { halfOpenAbuts } from "../../internal/index.js";
 import { isValidUtc } from "../validate/index.js";
 /**

package/dist/utc/interval/intervalContainsUtc.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { halfOpenContainsSpan } from "../../internal/index.js";
 import { intervalContains } from "../../interval/compare/index.js";
 import { isValidUtc } from "../validate/index.js";

package/dist/utc/interval/intervalCountUtc.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- cross-family Temporal type clone, by design (rule 5)
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { countZonedBuckets, resolveDateTimeUnit } from "../../internal/index.js";
 import { isValidDateTimeUnit } from "../../plain/validate/index.js";
 import { isValidUtc } from "../validate/isValidUtc.js";

package/dist/utc/interval/intervalDivideEquallyUtc.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- cross-family Temporal type clone, by design (rule 5)
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidUtcInterval } from "./validate/index.js";
 import { divisionBoundary } from "../../internal/divisionBoundary.js";
 import { exceedsPieceLimit, resolveMaxPieces } from "../../internal/maxPieces.js";

package/dist/utc/interval/intervalEngulfsUtc.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { halfOpenContainsSpan } from "../../internal/index.js";
 import { isValidUtc } from "../validate/index.js";
 /**

package/dist/utc/interval/intervalFromDurationUtc.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- cross-family Temporal type clone, by design (rule 5)
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDuration } from "../../duration/validate/index.js";
 import { resolveOverflow } from "../../internal/index.js";
 import { isValidUtc } from "../validate/isValidUtc.js";

package/dist/utc/interval/intervalLengthUtc.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { durationTotal, resolveDateTimeUnit, zonedUntil } from "../../internal/index.js";
 import { isValidDateTimeUnit } from "../../plain/validate/index.js";
 import { isValidUtcInterval } from "./validate/index.js";

package/dist/utc/interval/intervalOverlappingDaysUtc.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { halfOpenIntersection } from "../../internal/index.js";
 import { isValidUtc } from "../validate/index.js";
 /**

package/dist/utc/interval/intervalSplitAtUtc.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidUtcInterval } from "./validate/index.js";
 import { isValidUtc } from "../validate/index.js";
 /**

package/dist/utc/interval/intervalXorAllUtc.js

@@ -1,6 +1,7 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 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/intervalXorUtc.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { halfOpenXor } from "../../internal/index.js";
 import { isValidUtc } from "../validate/index.js";
 /**

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/interval/splitIntervalByUnitUtc.d.ts

@@ -12,7 +12,8 @@
  *   lands on February 29, March 31, April 30. Temporal's `add` constrains a day the month lacks
  *   to the month's last day, and stepping from that boundary would keep the shortened day
  *   (February 29, then March 29).
- * - Comparison: Luxon's `Interval.splitBy` computes each boundary from the start the same way.
+ * - Each calendar-unit boundary is `start.add(amount × k)` with Temporal's
+ *   `overflow: "constrain"` (TC39 Temporal `add`), never a step from the previous boundary.
  * - Exact-unit boundaries (hours and smaller) step from the previous boundary. Exact units never
  *   clamp, and stepping keeps nanosecond precision where `k × amount` would pass
  *   `Number.MAX_SAFE_INTEGER`.

package/dist/utc/interval/splitIntervalByUnitUtc.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- cross-family Temporal type clone, by design (rule 5)
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTimeDurationUnit } from "../../plain/validate/index.js";
 import { isValidUtc } from "../validate/isValidUtc.js";
 import { resolveDurationUnit, tileByUnit } from "../../internal/index.js";
@@ -19,7 +19,8 @@ import { minSlicesForSpan } from "../../internal/splitStep.js";
  *   lands on February 29, March 31, April 30. Temporal's `add` constrains a day the month lacks
  *   to the month's last day, and stepping from that boundary would keep the shortened day
  *   (February 29, then March 29).
- * - Comparison: Luxon's `Interval.splitBy` computes each boundary from the start the same way.
+ * - Each calendar-unit boundary is `start.add(amount × k)` with Temporal's
+ *   `overflow: "constrain"` (TC39 Temporal `add`), never a step from the previous boundary.
  * - Exact-unit boundaries (hours and smaller) step from the previous boundary. Exact units never
  *   clamp, and stepping keeps nanosecond precision where `k × amount` would pass
  *   `Number.MAX_SAFE_INTEGER`.

package/dist/utc/interval/validate/isValidUtcInterval.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../../internal/temporal.js";
 import { isValidUtc } from "../../validate/index.js";
 /**
  * Return true if `start` and `end` form a valid UTC interval — both parseable as

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

@@ -9,13 +9,15 @@
  * @returns ISO date string (e.g., "2024-03-17") or "" on invalid input
  *
  * @example parseDateFromUtc("2024-03-17T14:30:45Z") // "2024-03-17"
- * @example parseDateFromUtc("2025-01-01T02:00:00Z", { timeZone: "America/New_York" }) // "2024-12-31"
+ * @example parseDateFromUtc("2025-01-01T02:00:00Z", { timeZone: "America/Sao_Paulo" }) // "2024-12-31"
  * @example parseDateFromUtc("invalid") // ""
  */
 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.
@@ -11,7 +11,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @returns ISO date string (e.g., "2024-03-17") or "" on invalid input
  *
  * @example parseDateFromUtc("2024-03-17T14:30:45Z") // "2024-03-17"
- * @example parseDateFromUtc("2025-01-01T02:00:00Z", { timeZone: "America/New_York" }) // "2024-12-31"
+ * @example parseDateFromUtc("2025-01-01T02:00:00Z", { timeZone: "America/Sao_Paulo" }) // "2024-12-31"
  * @example parseDateFromUtc("invalid") // ""
  */
 export function parseDateFromUtc(value, options) {
@@ -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

@@ -9,13 +9,15 @@
  * @returns Day (01-31) or "" on invalid input
  *
  * @example parseDayFromUtc("2024-03-17T14:30:45Z") // "17"
- * @example parseDayFromUtc("2024-03-17T02:30:45Z", { timeZone: "America/New_York" }) // "16"
+ * @example parseDayFromUtc("2024-03-17T02:30:45Z", { timeZone: "America/Lima" }) // "16"
  * @example parseDayFromUtc("invalid") // ""
  */
 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.
@@ -11,7 +11,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @returns Day (01-31) or "" on invalid input
  *
  * @example parseDayFromUtc("2024-03-17T14:30:45Z") // "17"
- * @example parseDayFromUtc("2024-03-17T02:30:45Z", { timeZone: "America/New_York" }) // "16"
+ * @example parseDayFromUtc("2024-03-17T02:30:45Z", { timeZone: "America/Lima" }) // "16"
  * @example parseDayFromUtc("invalid") // ""
  */
 export function parseDayFromUtc(value, options) {
@@ -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

@@ -10,13 +10,15 @@
  *
  * @example parseDayOfWeekFromUtc("2024-03-17T14:30:45Z") // 7
  * @example parseDayOfWeekFromUtc("2024-03-18T00:00:00Z") // 1
- * @example parseDayOfWeekFromUtc("2024-03-17T02:30:45Z", { timeZone: "America/New_York" }) // 6 (Saturday in New York)
+ * @example parseDayOfWeekFromUtc("2024-03-17T02:30:45Z", { timeZone: "America/Sao_Paulo" }) // 6 (Saturday in São Paulo)
  * @example parseDayOfWeekFromUtc("invalid") // null
  */
 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 { Temporal } from "../../internal/temporal.js";
+import { frameWallClock, normalizeZoneFrame } from "../../internal/zoneFrame.js";
 import { isValidUtc } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
@@ -14,7 +14,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  *
  * @example parseDayOfWeekFromUtc("2024-03-17T14:30:45Z") // 7
  * @example parseDayOfWeekFromUtc("2024-03-18T00:00:00Z") // 1
- * @example parseDayOfWeekFromUtc("2024-03-17T02:30:45Z", { timeZone: "America/New_York" }) // 6 (Saturday in New York)
+ * @example parseDayOfWeekFromUtc("2024-03-17T02:30:45Z", { timeZone: "America/Sao_Paulo" }) // 6 (Saturday in São Paulo)
  * @example parseDayOfWeekFromUtc("invalid") // null
  */
 export function parseDayOfWeekFromUtc(value, options) {
@@ -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

@@ -9,13 +9,15 @@
  * @returns Hour (00-23) or "" on invalid input
  *
  * @example parseHourFromUtc("2024-03-17T14:30:45Z") // "14"
- * @example parseHourFromUtc("2024-03-17T02:30:45Z", { timeZone: "America/New_York" }) // "22"
+ * @example parseHourFromUtc("2024-03-17T02:30:45Z", { timeZone: "Asia/Kolkata" }) // "08"
  * @example parseHourFromUtc("invalid") // ""
  */
 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.
@@ -11,7 +11,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @returns Hour (00-23) or "" on invalid input
  *
  * @example parseHourFromUtc("2024-03-17T14:30:45Z") // "14"
- * @example parseHourFromUtc("2024-03-17T02:30:45Z", { timeZone: "America/New_York" }) // "22"
+ * @example parseHourFromUtc("2024-03-17T02:30:45Z", { timeZone: "Asia/Kolkata" }) // "08"
  * @example parseHourFromUtc("invalid") // ""
  */
 export function parseHourFromUtc(value, options) {
@@ -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;