@northguild/gmt 1.18.0 → 1.19.0

package/dist/zoned/get/getZonedMicrosecond.js

@@ -1,22 +1,23 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { isValidTimeZone } from "../validate/index.js";
+import { frameNowWallClock, zoneFrame } from "../../internal/zoneFrame.js";
 /**
  * Return the current microsecond for the specified IANA timeZone.
  *
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current microsecond string (zero-padded to 3 digits) or "" on invalid input
  *
  * @example getZonedMicrosecond("America/New_York") // "000"
  * @example getZonedMicrosecond("invalid") // ""
  */
 export function getZonedMicrosecond(ianaTimezone) {
-    if (!isValidTimeZone(ianaTimezone))
+    const frame = zoneFrame(ianaTimezone);
+    if (frame === null)
         return "";
     try {
-        return (Temporal.Now.zonedDateTimeISO(ianaTimezone).microsecond ?? 0)
+        return (frameNowWallClock(frame).microsecond ?? 0)
             .toString()
             .padStart(3, "0");
     }

package/dist/zoned/get/getZonedMillisecond.d.ts

@@ -4,7 +4,8 @@
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current millisecond string (zero-padded to 3 digits) or "" on invalid input
  *
  * @example getZonedMillisecond("America/New_York") // "000"

package/dist/zoned/get/getZonedMillisecond.js

@@ -1,24 +1,23 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { isValidTimeZone } from "../validate/index.js";
+import { frameNowWallClock, zoneFrame } from "../../internal/zoneFrame.js";
 /**
  * Return the current millisecond for the specified IANA timeZone.
  *
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current millisecond string (zero-padded to 3 digits) or "" on invalid input
  *
  * @example getZonedMillisecond("America/New_York") // "000"
  * @example getZonedMillisecond("invalid") // ""
  */
 export function getZonedMillisecond(ianaTimezone) {
-    if (!isValidTimeZone(ianaTimezone))
+    const frame = zoneFrame(ianaTimezone);
+    if (frame === null)
         return "";
     try {
-        return Temporal.Now.zonedDateTimeISO(ianaTimezone)
-            .millisecond.toString()
-            .padStart(3, "0");
+        return frameNowWallClock(frame).millisecond.toString().padStart(3, "0");
     }
     catch {
         return "";

package/dist/zoned/get/getZonedMinute.d.ts

@@ -4,7 +4,8 @@
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current minute string (zero-padded to 2 digits) or "" on invalid input
  *
  * @example getZonedMinute("America/New_York") // "00"

package/dist/zoned/get/getZonedMinute.js

@@ -1,24 +1,23 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { isValidTimeZone } from "../validate/index.js";
+import { frameNowWallClock, zoneFrame } from "../../internal/zoneFrame.js";
 /**
  * Return the current minute for the specified IANA timeZone.
  *
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current minute string (zero-padded to 2 digits) or "" on invalid input
  *
  * @example getZonedMinute("America/New_York") // "00"
  * @example getZonedMinute("invalid") // ""
  */
 export function getZonedMinute(ianaTimezone) {
-    if (!isValidTimeZone(ianaTimezone))
+    const frame = zoneFrame(ianaTimezone);
+    if (frame === null)
         return "";
     try {
-        return Temporal.Now.zonedDateTimeISO(ianaTimezone)
-            .minute.toString()
-            .padStart(2, "0");
+        return frameNowWallClock(frame).minute.toString().padStart(2, "0");
     }
     catch {
         return "";

package/dist/zoned/get/getZonedMonth.d.ts

@@ -4,7 +4,8 @@
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current month string (zero-padded to 2 digits) or "" on invalid input
  *
  * @example getZonedMonth("America/New_York") // "02"

package/dist/zoned/get/getZonedMonth.js

@@ -1,24 +1,23 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { isValidTimeZone } from "../validate/index.js";
+import { frameNowWallClock, zoneFrame } from "../../internal/zoneFrame.js";
 /**
  * Return the current month for the specified IANA timeZone.
  *
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current month string (zero-padded to 2 digits) or "" on invalid input
  *
  * @example getZonedMonth("America/New_York") // "02"
  * @example getZonedMonth("invalid") // ""
  */
 export function getZonedMonth(ianaTimezone) {
-    if (!isValidTimeZone(ianaTimezone))
+    const frame = zoneFrame(ianaTimezone);
+    if (frame === null)
         return "";
     try {
-        return Temporal.Now.zonedDateTimeISO(ianaTimezone)
-            .month.toString()
-            .padStart(2, "0");
+        return frameNowWallClock(frame).month.toString().padStart(2, "0");
     }
     catch {
         return "";

package/dist/zoned/get/getZonedNanosecond.d.ts

@@ -4,7 +4,8 @@
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current nanosecond string (zero-padded to 3 digits) or "" on invalid input
  *
  * @example getZonedNanosecond("America/New_York") // "000"

package/dist/zoned/get/getZonedNanosecond.js

@@ -1,22 +1,23 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { isValidTimeZone } from "../validate/index.js";
+import { frameNowWallClock, zoneFrame } from "../../internal/zoneFrame.js";
 /**
  * Return the current nanosecond for the specified IANA timeZone.
  *
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current nanosecond string (zero-padded to 3 digits) or "" on invalid input
  *
  * @example getZonedNanosecond("America/New_York") // "000"
  * @example getZonedNanosecond("invalid") // ""
  */
 export function getZonedNanosecond(ianaTimezone) {
-    if (!isValidTimeZone(ianaTimezone))
+    const frame = zoneFrame(ianaTimezone);
+    if (frame === null)
         return "";
     try {
-        return (Temporal.Now.zonedDateTimeISO(ianaTimezone).nanosecond ?? 0)
+        return (frameNowWallClock(frame).nanosecond ?? 0)
             .toString()
             .padStart(3, "0");
     }

package/dist/zoned/get/getZonedNow.d.ts

@@ -7,8 +7,12 @@ import { Temporal } from "@js-temporal/polyfill";
  * - `smallestUnit` is the only option read. Any other key on `optionsArg` is ignored, so the
  *   string always carries the offset and the bracketed time zone, and smaller units are always
  *   truncated.
+ * - An offset with seconds (`-00:44:30`) returns `""`. A written zone cannot carry seconds (RFC
+ *   9557 §4.1), so the result could not name it. Pass the IANA name, or call
+ *   `fromOffsetInstant({ instant, offset })` for the local time with its full offset and no
+ *   bracket.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or a UTC offset to the minute (what `isValidTimeZone` accepts)
  * @param optionsArg optional setting for the precision of the output string
  * @returns zoned ISO 8601 datetime string or "" on invalid input
  *

package/dist/zoned/get/getZonedNow.js

@@ -10,8 +10,12 @@ import { optionOrDefault } from "../../internal/optionOrDefault.js";
  * - `smallestUnit` is the only option read. Any other key on `optionsArg` is ignored, so the
  *   string always carries the offset and the bracketed time zone, and smaller units are always
  *   truncated.
+ * - An offset with seconds (`-00:44:30`) returns `""`. A written zone cannot carry seconds (RFC
+ *   9557 §4.1), so the result could not name it. Pass the IANA name, or call
+ *   `fromOffsetInstant({ instant, offset })` for the local time with its full offset and no
+ *   bracket.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or a UTC offset to the minute (what `isValidTimeZone` accepts)
  * @param optionsArg optional setting for the precision of the output string
  * @returns zoned ISO 8601 datetime string or "" on invalid input
  *

package/dist/zoned/get/getZonedNowUnit.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "@js-temporal/polyfill";
 /**
  * Units extractable from the current time in a specific IANA timeZone, as
  * consumed by `getZonedNowUnit`.
@@ -7,7 +7,7 @@ import { Temporal } from "@js-temporal/polyfill";
  *
  * | Member | Description |
  * | --- | --- |
- * | `year` | Full calendar year (e.g. `2024`), no padding. |
+ * | `year` | Four digits (e.g. `2024`, `0005`); a sign and six digits outside 0000–9999 (e.g. `+010000`). |
  * | `month` | 1–12, zero-padded to 2 digits (e.g. `02`). |
  * | `week` | Week-of-year from `parseWeekFromDate`, 1–53. |
  * | `day` | Day of month 1–31, zero-padded (e.g. `15`). |
@@ -32,8 +32,11 @@ export type ZonedNowUnit = Temporal.SmallestUnit<"year" | "month" | "week" | "da
  * - Validation is performed on timezone and unit.
  * - `unit` accepts the singular or plural name of a Temporal unit (`"hour"` or `"hours"`), as Temporal
  *   does; `"dayOfWeek"` has no plural.
+ * - 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 ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @param unit unit to extract from current zoned time
  * @returns string representation of the requested unit or "" on invalid input
  *

package/dist/zoned/get/getZonedNowUnit.js

@@ -1,7 +1,6 @@
-import { Temporal } from "@js-temporal/polyfill";
 import { zonedNowUnitValue } from "../../internal/zonedNowUnitValue.js";
 import { parseWeekFromDate } from "../../plain/parse/index.js";
-import { isValidTimeZone } from "../validate/index.js";
+import { frameNowWallClock, zoneFrame } from "../../internal/zoneFrame.js";
 import { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.js";
 function isValidZonedNowUnit(unit) {
     return [
@@ -26,8 +25,11 @@ function isValidZonedNowUnit(unit) {
  * - Validation is performed on timezone and unit.
  * - `unit` accepts the singular or plural name of a Temporal unit (`"hour"` or `"hours"`), as Temporal
  *   does; `"dayOfWeek"` has no plural.
+ * - 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 ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @param unit unit to extract from current zoned time
  * @returns string representation of the requested unit or "" on invalid input
  *
@@ -40,13 +42,14 @@ export function getZonedNowUnit(ianaTimezone, unit) {
         return "";
     }
     const resolvedUnit = resolveDateTimeUnit(unit);
-    if (!isValidTimeZone(ianaTimezone) || !isValidZonedNowUnit(resolvedUnit)) {
+    const frame = zoneFrame(ianaTimezone);
+    if (frame === null || !isValidZonedNowUnit(resolvedUnit)) {
         return "";
     }
     try {
-        const now = Temporal.Now.zonedDateTimeISO(ianaTimezone);
-        return zonedNowUnitValue(now, resolvedUnit, (zdt) => {
-            const w = parseWeekFromDate(zdt.toPlainDate().toString());
+        const now = frameNowWallClock(frame);
+        return zonedNowUnitValue(now, resolvedUnit, (wallClock) => {
+            const w = parseWeekFromDate(wallClock.toPlainDate().toString());
             return w === null ? "" : w.toString();
         });
     }

package/dist/zoned/get/getZonedSecond.d.ts

@@ -4,7 +4,8 @@
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current second string (zero-padded to 2 digits) or "" on invalid input
  *
  * @example getZonedSecond("America/New_York") // "00"

package/dist/zoned/get/getZonedSecond.js

@@ -1,24 +1,23 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { isValidTimeZone } from "../validate/index.js";
+import { frameNowWallClock, zoneFrame } from "../../internal/zoneFrame.js";
 /**
  * Return the current second for the specified IANA timeZone.
  *
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current second string (zero-padded to 2 digits) or "" on invalid input
  *
  * @example getZonedSecond("America/New_York") // "00"
  * @example getZonedSecond("invalid") // ""
  */
 export function getZonedSecond(ianaTimezone) {
-    if (!isValidTimeZone(ianaTimezone))
+    const frame = zoneFrame(ianaTimezone);
+    if (frame === null)
         return "";
     try {
-        return Temporal.Now.zonedDateTimeISO(ianaTimezone)
-            .second.toString()
-            .padStart(2, "0");
+        return frameNowWallClock(frame).second.toString().padStart(2, "0");
     }
     catch {
         return "";

package/dist/zoned/get/getZonedToday.d.ts

@@ -4,7 +4,8 @@
  * - Uses Temporal.Now.zonedDateTimeISO to get current date in timezone.
  * - Returns "" for invalid timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns ISO date string (YYYY-MM-DD) or "" when invalid
  *
  * @example getZonedToday("America/New_York") // "2024-02-29"

package/dist/zoned/get/getZonedToday.js

@@ -1,23 +1,24 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { isValidTimeZone } from "../validate/index.js";
+import { frameNowWallClock, zoneFrame } from "../../internal/zoneFrame.js";
 /**
  * Return today's date in the given IANA timeZone as an ISO date string.
  *
  * - Uses Temporal.Now.zonedDateTimeISO to get current date in timezone.
  * - Returns "" for invalid timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns ISO date string (YYYY-MM-DD) or "" when invalid
  *
  * @example getZonedToday("America/New_York") // "2024-02-29"
  * @example getZonedToday("invalid") // ""
  */
 export function getZonedToday(ianaTimezone) {
-    if (!isValidTimeZone(ianaTimezone)) {
+    const frame = zoneFrame(ianaTimezone);
+    if (frame === null) {
         return "";
     }
     try {
-        const today = Temporal.Now.zonedDateTimeISO(ianaTimezone).toPlainDate();
+        const today = frameNowWallClock(frame).toPlainDate();
         return today.toString();
     }
     catch {

package/dist/zoned/get/getZonedWeekOfYear.d.ts

@@ -5,7 +5,8 @@
  * - Uses Temporal.PlainDate.weekOfYear for ISO week number.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current week number (1-53) or null on invalid input
  *
  * @example getZonedWeekOfYear("America/New_York") // 9

package/dist/zoned/get/getZonedWeekOfYear.js

@@ -1,5 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { isValidTimeZone } from "../validate/index.js";
+import { frameNowWallClock, zoneFrame } from "../../internal/zoneFrame.js";
 /**
  * Return the current week of year for the specified IANA timeZone.
  *
@@ -7,17 +6,19 @@ import { isValidTimeZone } from "../validate/index.js";
  * - Uses Temporal.PlainDate.weekOfYear for ISO week number.
  * - Validation is performed on the timezone.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current week number (1-53) or null on invalid input
  *
  * @example getZonedWeekOfYear("America/New_York") // 9
  * @example getZonedWeekOfYear("invalid") // null
  */
 export function getZonedWeekOfYear(ianaTimezone) {
-    if (!isValidTimeZone(ianaTimezone))
+    const frame = zoneFrame(ianaTimezone);
+    if (frame === null)
         return null;
     try {
-        const now = Temporal.Now.zonedDateTimeISO(ianaTimezone);
+        const now = frameNowWallClock(frame);
         return now.toPlainDate().weekOfYear ?? null;
     }
     catch {

package/dist/zoned/get/getZonedYear.d.ts

@@ -3,8 +3,11 @@
  *
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
+ * - The year is zero-padded to 4 digits. 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.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current year string (zero-padded to 4 digits) or "" on invalid input
  *
  * @example getZonedYear("America/New_York") // "2024"

package/dist/zoned/get/getZonedYear.js

@@ -1,24 +1,26 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { isValidTimeZone } from "../validate/index.js";
+import { frameNowWallClock, zoneFrame } from "../../internal/zoneFrame.js";
+import { isoYearString } from "../../internal/isoYearString.js";
 /**
  * Return the current year for the specified IANA timeZone.
  *
  * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
  * - Validation is performed on the timezone.
+ * - The year is zero-padded to 4 digits. 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.
  *
- * @param ianaTimezone IANA timeZone identifier
+ * @param ianaTimezone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or
+ *   a stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @returns current year string (zero-padded to 4 digits) or "" on invalid input
  *
  * @example getZonedYear("America/New_York") // "2024"
  * @example getZonedYear("invalid") // ""
  */
 export function getZonedYear(ianaTimezone) {
-    if (!isValidTimeZone(ianaTimezone))
+    const frame = zoneFrame(ianaTimezone);
+    if (frame === null)
         return "";
     try {
-        return Temporal.Now.zonedDateTimeISO(ianaTimezone)
-            .year.toString()
-            .padStart(4, "0");
+        return isoYearString(frameNowWallClock(frame).year);
     }
     catch {
         return "";

package/dist/zoned/interval/intervalXorAllZoned.js

@@ -2,6 +2,7 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { calendarOfAllZonedValues, formatZonedInCalendar, halfOpenXor, parseCalendarZonedValue, } from "../../internal/index.js";
 import { isValidCalendarZonedInterval } from "./validate/index.js";
+import { isObject } from "../../internal/isObject.js";
 /**
  * Return the symmetric difference across a list of zoned intervals — the set of instants
  * covered by an odd number of the input intervals.
@@ -39,8 +40,7 @@ export function intervalXorAllZoned(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" &&
             isValidCalendarZonedInterval(interval.start, interval.end))) {

package/dist/zoned/interval/mergeIntervalsZoned.js

@@ -2,6 +2,7 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { calendarOfAllZonedValues, formatZonedInCalendar, halfOpenMerge, parseCalendarZonedValue, } from "../../internal/index.js";
 import { isValidCalendarZonedInterval } from "./validate/index.js";
+import { isObject } from "../../internal/isObject.js";
 /**
  * Collapse a list of zoned intervals into the minimum set of non-overlapping intervals.
  *
@@ -43,8 +44,7 @@ export function mergeIntervalsZoned(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" &&
             isValidCalendarZonedInterval(interval.start, interval.end))) {

package/dist/zoned/parse/parseUnitFromZoned.d.ts

@@ -8,7 +8,7 @@ import type { Temporal } from "@js-temporal/polyfill";
  *
  * | Member | Description |
  * | --- | --- |
- * | `year` | Full year, no padding (e.g. `2024`). |
+ * | `year` | Four digits (e.g. `2024`, `0005`); a sign and six digits outside 0000–9999 (e.g. `+010000`). |
  * | `month` | Zero-padded 2 (e.g. `03`). |
  * | `week` | Week-of-year, 1–53 (`weekStartsOn`-controlled). |
  * | `day` | Zero-padded 2. |
@@ -34,6 +34,8 @@ export type ZonedParseUnit = Temporal.SmallestUnit<"year" | "month" | "week" | "
  * - `unit` accepts the singular or plural name of a Temporal unit (`"hour"` or `"hours"`), as Temporal
  *   does; `"dayOfWeek"` has no plural.
  * - Returns "" for invalid input.
+ * - 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 value zoned ISO 8601 datetime string
  * @param unit unit to extract
@@ -41,6 +43,7 @@ export type ZonedParseUnit = Temporal.SmallestUnit<"year" | "month" | "week" | "
  * @returns string representation of the requested unit or "" when invalid
  *
  * @example parseUnitFromZoned("2024-02-29T12:34:56.789+00:00[UTC]", "year") // "2024"
+ * @example parseUnitFromZoned("0005-06-01T12:30:00+00:00[UTC]", "year") // "0005"
  * @example parseUnitFromZoned("2024-02-29T12:34:56.789+00:00[UTC]", "milliseconds") // "789"
  * @example parseUnitFromZoned("2024-12-31T12:00:00+00:00[UTC]", "week", { weekStartsOn: "sunday" }) // "1"
  * @example parseUnitFromZoned("invalid", "year") // ""

package/dist/zoned/parse/parseUnitFromZoned.js

@@ -4,6 +4,7 @@ import { zonedDateTimeFrom } from "../../internal/index.js";
 import { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.js";
 import { resolveWeekStartsOn } from "../../internal/resolveWeekStartsOn.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
+import { isoYearString } from "../../internal/isoYearString.js";
 function isValidZonedUnit(unit) {
     return [
         "year",
@@ -28,6 +29,8 @@ function isValidZonedUnit(unit) {
  * - `unit` accepts the singular or plural name of a Temporal unit (`"hour"` or `"hours"`), as Temporal
  *   does; `"dayOfWeek"` has no plural.
  * - Returns "" for invalid input.
+ * - 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 value zoned ISO 8601 datetime string
  * @param unit unit to extract
@@ -35,6 +38,7 @@ function isValidZonedUnit(unit) {
  * @returns string representation of the requested unit or "" when invalid
  *
  * @example parseUnitFromZoned("2024-02-29T12:34:56.789+00:00[UTC]", "year") // "2024"
+ * @example parseUnitFromZoned("0005-06-01T12:30:00+00:00[UTC]", "year") // "0005"
  * @example parseUnitFromZoned("2024-02-29T12:34:56.789+00:00[UTC]", "milliseconds") // "789"
  * @example parseUnitFromZoned("2024-12-31T12:00:00+00:00[UTC]", "week", { weekStartsOn: "sunday" }) // "1"
  * @example parseUnitFromZoned("invalid", "year") // ""
@@ -56,7 +60,7 @@ export function parseUnitFromZoned(value, unit, optionsArg) {
             const zonedDateTime = zonedDateTimeFrom(value);
             switch (resolvedUnit) {
                 case "year":
-                    return zonedDateTime.year.toString();
+                    return isoYearString(zonedDateTime.year);
                 case "month":
                     return zonedDateTime.month.toString().padStart(2, "0");
                 case "week":

package/dist/zoned/parse/parseYearFromZoned.d.ts

@@ -1,13 +1,15 @@
 /**
  * Return the year for a given ISO 8601 zoned datetime string.
  *
- * - Returns string for year.
+ * - Returns the year as Temporal writes it: four digits (`"2024"`, `"0005"`), or a sign and six
+ *   digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  * - Returns "" for invalid input.
  *
  * @param value ISO zoned datetime string
- * @returns Year as string or "" on invalid input
+ * @returns the year as four digits, or a sign and six digits outside 0000–9999, or "" on invalid input
  *
  * @example parseYearFromZoned("2024-03-15T14:30:45.123+00:00[UTC]") // "2024"
+ * @example parseYearFromZoned("0005-06-01T12:30:00+00:00[UTC]") // "0005"
  * @example parseYearFromZoned("invalid") // ""
  */
 export declare function parseYearFromZoned(value: string): string;

package/dist/zoned/parse/parseYearFromZoned.js

@@ -1,15 +1,18 @@
 import { isValidZonedDateTime } from "../validate/index.js";
 import { zonedDateTimeFrom } from "../../internal/index.js";
+import { isoYearString } from "../../internal/isoYearString.js";
 /**
  * Return the year for a given ISO 8601 zoned datetime string.
  *
- * - Returns string for year.
+ * - Returns the year as Temporal writes it: four digits (`"2024"`, `"0005"`), or a sign and six
+ *   digits outside 0000–9999 (`"+010000"`, `"-000005"`).
  * - Returns "" for invalid input.
  *
  * @param value ISO zoned datetime string
- * @returns Year as string or "" on invalid input
+ * @returns the year as four digits, or a sign and six digits outside 0000–9999, or "" on invalid input
  *
  * @example parseYearFromZoned("2024-03-15T14:30:45.123+00:00[UTC]") // "2024"
+ * @example parseYearFromZoned("0005-06-01T12:30:00+00:00[UTC]") // "0005"
  * @example parseYearFromZoned("invalid") // ""
  */
 export function parseYearFromZoned(value) {
@@ -18,7 +21,7 @@ export function parseYearFromZoned(value) {
     }
     try {
         const zonedDateTime = zonedDateTimeFrom(value);
-        return zonedDateTime.year.toString();
+        return isoYearString(zonedDateTime.year);
     }
     catch {
         return "";