@northguild/gmt 1.18.0 → 1.20.0

package/dist/unix/get/getUnixMinute.js

@@ -1,24 +1,17 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current minute from the Unix timestamp in 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 minute string (zero-padded to 2 digits) or "" on failure
+ * @returns current minute string (zero-padded to 2 digits)
  *
  * @example getUnixMinute() // "30"
- * @example getUnixMinute() // "" (on failure)
  */
 export function getUnixMinute() {
-    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/unix/get/getUnixMonth.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 getUnixMonth() // "02"
- * @example getUnixMonth() // "" (on failure)
  */
 export declare function getUnixMonth(): string;

package/dist/unix/get/getUnixMonth.js

@@ -1,24 +1,17 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current month from the Unix timestamp in 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 month string (zero-padded to 2 digits) or "" on failure
+ * @returns current month string (zero-padded to 2 digits)
  *
  * @example getUnixMonth() // "02"
- * @example getUnixMonth() // "" (on failure)
  */
 export function getUnixMonth() {
-    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/unix/get/getUnixNanosecond.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 getUnixNanosecond() // "789"
- * @example getUnixNanosecond() // "" (on failure)
  */
 export declare function getUnixNanosecond(): string;

package/dist/unix/get/getUnixNanosecond.js

@@ -1,23 +1,16 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current nanosecond from the Unix timestamp in 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 getUnixNanosecond() // "789"
- * @example getUnixNanosecond() // "" (on failure)
  */
 export function getUnixNanosecond() {
-    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/unix/get/getUnixNow.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { resolveUnixEpochUnitOptions, toUnixEpoch, } from "../../internal/unixEpochValue.js";
 /**
  * Return the current Unix timestamp in either seconds or milliseconds.

package/dist/unix/get/getUnixNowUnit.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import type { UnixNowUnit } from "../../types/index.js";
 export type { UnixNowUnit };
 /**
@@ -8,6 +8,8 @@ export type { UnixNowUnit };
  * - `microsecond` and `nanosecond` are Temporal's 0–999 fields, zero-padded to 3 digits.
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - 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 unix timestamp
  * @returns string representation of the requested unit or "" on invalid

package/dist/unix/get/getUnixNowUnit.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 { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.js";
 import { isValidDateTimeUnit } from "../../plain/validate/index.js";
@@ -12,6 +12,8 @@ function isValidUnixNowUnit(unit) {
  * - `microsecond` and `nanosecond` are Temporal's 0–999 fields, zero-padded to 3 digits.
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - 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 unix timestamp
  * @returns string representation of the requested unit or "" on invalid

package/dist/unix/get/getUnixSecond.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 getUnixSecond() // "45"
- * @example getUnixSecond() // "" (on failure)
  */
 export declare function getUnixSecond(): string;

package/dist/unix/get/getUnixSecond.js

@@ -1,24 +1,17 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current second from the Unix timestamp in 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 getUnixSecond() // "45"
- * @example getUnixSecond() // "" (on failure)
  */
 export function getUnixSecond() {
-    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/unix/get/getUnixYear.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 getUnixYear() // "2024"
- * @example getUnixYear() // "" (on failure)
  */
 export declare function getUnixYear(): string;

package/dist/unix/get/getUnixYear.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 the Unix timestamp in 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 getUnixYear() // "2024"
- * @example getUnixYear() // "" (on failure)
  */
 export function getUnixYear() {
-    try {
-        return Temporal.Now.instant()
-            .toZonedDateTimeISO("UTC")
-            .year.toString()
-            .padStart(4, "0");
-    }
-    catch {
-        return "";
-    }
+    return isoYearString(Temporal.Now.instant().toZonedDateTimeISO("UTC").year);
 }

package/dist/unix/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 "./compare/index.js";
 export * from "./convert/index.js";

package/dist/unix/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 "./compare/index.js";
 export * from "./convert/index.js";

package/dist/unix/interval/intervalCountUnix.d.ts

@@ -21,6 +21,12 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * - Returns `null` on invalid input (`start`/`end` that is not a safe integer or numeric string of
  *   one, or lies outside the Temporal instant range, `start > end`, an unsupported unit, an invalid
  *   `epochUnit` or an unknown `timeZone`).
+ * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
+ *   moved by its seconds, and the moved instant must be inside Temporal's range. So within the
+ *   offset's seconds (under a minute) of the last instant Temporal supports
+ *   (`+275760-09-13T00:00:00Z`) for an offset east of UTC, or of the first
+ *   (`-271821-04-20T00:00:00Z`) for one west, this returns `null`. An offset to the minute has no
+ *   such limit.
  *
  * @param start Unix epoch in `epochUnit` — interval start
  * @param end Unix epoch in `epochUnit` — interval end
@@ -35,6 +41,7 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * @example intervalCountUnix(1704151800000, 1704155400000, "day", { timeZone: "Asia/Tokyo" }) // 1 (08:30 to 09:30 on one Tokyo day)
  * @example intervalCountUnix("1704151800", "1704155400", "days", { epochUnit: "second" }) // 2
  * @example intervalCountUnix(NaN, 86400000, "hour") // null
+ * @example intervalCountUnix(2669999, 2670001, "day", { timeZone: "-00:44:30" }) // 2 (the local day turns at 00:44:30Z)
  */
 export declare function intervalCountUnix(start: number | string, end: number | string, unit: string, options?: {
     /**
@@ -45,8 +52,10 @@ export declare function intervalCountUnix(start: number | string, end: number |
      */
     epochUnit?: UnixUnit;
     /**
-     * The time zone the unit boundaries are found in: an IANA name, a UTC offset, or `"local"` for
-     * the system time zone. An unknown zone returns `null`.
+     * The time zone the unit boundaries are found 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/unix/interval/intervalCountUnix.js

@@ -24,6 +24,12 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * - Returns `null` on invalid input (`start`/`end` that is not a safe integer or numeric string of
  *   one, or lies outside the Temporal instant range, `start > end`, an unsupported unit, an invalid
  *   `epochUnit` or an unknown `timeZone`).
+ * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
+ *   moved by its seconds, and the moved instant must be inside Temporal's range. So within the
+ *   offset's seconds (under a minute) of the last instant Temporal supports
+ *   (`+275760-09-13T00:00:00Z`) for an offset east of UTC, or of the first
+ *   (`-271821-04-20T00:00:00Z`) for one west, this returns `null`. An offset to the minute has no
+ *   such limit.
  *
  * @param start Unix epoch in `epochUnit` — interval start
  * @param end Unix epoch in `epochUnit` — interval end
@@ -38,6 +44,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @example intervalCountUnix(1704151800000, 1704155400000, "day", { timeZone: "Asia/Tokyo" }) // 1 (08:30 to 09:30 on one Tokyo day)
  * @example intervalCountUnix("1704151800", "1704155400", "days", { epochUnit: "second" }) // 2
  * @example intervalCountUnix(NaN, 86400000, "hour") // null
+ * @example intervalCountUnix(2669999, 2670001, "day", { timeZone: "-00:44:30" }) // 2 (the local day turns at 00:44:30Z)
  */
 export function intervalCountUnix(start, end, unit, options) {
     try {

package/dist/unix/interval/intervalFromDurationUnix.d.ts

@@ -18,6 +18,12 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * - Returns null on invalid input (a `value` that is not a safe integer or numeric string of one —
  *   fractions, empty strings and values beyond ±(2^53 − 1) are invalid — invalid `duration`, an
  *   `anchor` other than `"start"`/`"end"`, or an invalid/unavailable timeZone).
+ * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
+ *   moved by its seconds, and the moved instant must be inside Temporal's range. So within the
+ *   offset's seconds (under a minute) of the last instant Temporal supports
+ *   (`+275760-09-13T00:00:00Z`) for an offset east of UTC, or of the first
+ *   (`-271821-04-20T00:00:00Z`) for one west, this returns `null`. An offset to the minute has no
+ *   such limit.
  *
  * @param value Unix epoch value (seconds or milliseconds): a safe integer or a digit string
  * @param duration ISO 8601 duration string
@@ -41,8 +47,10 @@ export declare function intervalFromDurationUnix(value: number | string, duratio
      */
     epochUnit?: UnixUnit;
     /**
-     * The time zone the calendar arithmetic runs in: an IANA name, a UTC offset, or `"local"` for
-     * the system time zone. An unknown zone returns `null`.
+     * The time zone the calendar arithmetic runs 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/unix/interval/intervalFromDurationUnix.js

@@ -1,8 +1,7 @@
 // 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 { addToZoned, resolveOverflow, subtractFromZoned } from "../../internal/index.js";
-import { normalizeTimeZone } from "../../internal/normalizeTimeZone.js";
+import { addToZoned, frameInstant, frameZoned, normalizeZoneFrame, resolveOverflow, subtractFromZoned, } from "../../internal/index.js";
 import { resolveUnixEpochUnit, toUnixEpoch, unixEpochToInstant, } from "../../internal/unixEpochValue.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
@@ -23,6 +22,12 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * - Returns null on invalid input (a `value` that is not a safe integer or numeric string of one —
  *   fractions, empty strings and values beyond ±(2^53 − 1) are invalid — invalid `duration`, an
  *   `anchor` other than `"start"`/`"end"`, or an invalid/unavailable timeZone).
+ * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
+ *   moved by its seconds, and the moved instant must be inside Temporal's range. So within the
+ *   offset's seconds (under a minute) of the last instant Temporal supports
+ *   (`+275760-09-13T00:00:00Z`) for an offset east of UTC, or of the first
+ *   (`-271821-04-20T00:00:00Z`) for one west, this returns `null`. An offset to the minute has no
+ *   such limit.
  *
  * @param value Unix epoch value (seconds or milliseconds): a safe integer or a digit string
  * @param duration ISO 8601 duration string
@@ -49,8 +54,8 @@ export function intervalFromDurationUnix(value, duration, anchor, options) {
             return null;
         }
         const epochUnit = resolveUnixEpochUnit(options?.epochUnit);
-        const timeZone = normalizeTimeZone(options?.timeZone);
-        if (!timeZone || epochUnit === null) {
+        const frame = normalizeZoneFrame(options?.timeZone);
+        if (frame === null || epochUnit === null) {
             return null;
         }
         const instant = unixEpochToInstant(value, epochUnit);
@@ -58,7 +63,7 @@ export function intervalFromDurationUnix(value, duration, anchor, options) {
             return null;
         }
         try {
-            const point = instant.toZonedDateTimeISO(timeZone);
+            const point = frameZoned(instant, frame);
             const dur = Temporal.Duration.from(duration);
             const overflow = resolveOverflow(options?.overflow);
             const other = anchor === "start"
@@ -70,8 +75,8 @@ export function intervalFromDurationUnix(value, duration, anchor, options) {
                 return null;
             }
             return {
-                start: toUnixEpoch(start, epochUnit),
-                end: toUnixEpoch(end, epochUnit),
+                start: toUnixEpoch(frameInstant(start, frame), epochUnit),
+                end: toUnixEpoch(frameInstant(end, frame), epochUnit),
             };
         }
         catch {

package/dist/unix/interval/intervalLengthUnix.d.ts

@@ -6,12 +6,18 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  *   rather than measuring exact duration.
  * - `start` and `end` are each a safe integer or a string of optionally negative ASCII digits.
  * - Fixed-length units (hour, minute, second, …) are zone-independent; a day is a local day in
- *   `options.timeZone`, so New York's 23-hour 2024-03-10 is 1 day long there.
+ *   `options.timeZone`, so Sydney's 23-hour 2024-10-06 is 1 day long there.
  * - Accepts singular or plural units (`"day"` and `"days"` behave identically).
  * - Returns `0` for a zero-length interval (`start === end`).
  * - Returns `null` on invalid input (`start`/`end` that is not a safe integer or numeric string of
  *   one, or lies outside the Temporal instant range, `start > end`, an unsupported unit, an invalid
  *   `epochUnit` or an unknown `timeZone`).
+ * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
+ *   moved by its seconds, and the moved instant must be inside Temporal's range. So within the
+ *   offset's seconds (under a minute) of the last instant Temporal supports
+ *   (`+275760-09-13T00:00:00Z`) for an offset east of UTC, or of the first
+ *   (`-271821-04-20T00:00:00Z`) for one west, this returns `null`. An offset to the minute has no
+ *   such limit.
  *
  * @param start Unix epoch in `epochUnit` — interval start
  * @param end Unix epoch in `epochUnit` — interval end
@@ -23,7 +29,7 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * @example intervalLengthUnix(0, 5400000, "hour") // 1.5
  * @example intervalLengthUnix(0, 0, "hour") // 0
  * @example intervalLengthUnix(86400000, 0, "hour") // null
- * @example intervalLengthUnix(1710046800000, 1710129600000, "day", { timeZone: "America/New_York" }) // 1 (the 23-hour local day)
+ * @example intervalLengthUnix(1728136800000, 1728219600000, "day", { timeZone: "Australia/Sydney" }) // 1 (the 23-hour local day)
  * @example intervalLengthUnix(1710046800000, 1710129600000, "day") // 0.9583333333333334 (23/24 of a UTC day)
  * @example intervalLengthUnix("0", "86400", "hours", { epochUnit: "second" }) // 24
  * @example intervalLengthUnix(NaN, 86400000, "hour") // null
@@ -37,8 +43,10 @@ export declare function intervalLengthUnix(start: number | string, end: number |
      */
     epochUnit?: UnixUnit;
     /**
-     * The time zone calendar units are measured in: an IANA name, a UTC offset, or `"local"` for
-     * the system time zone. An unknown zone returns `null`.
+     * The time zone calendar units are measured 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/unix/interval/intervalLengthUnix.js

@@ -9,12 +9,18 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  *   rather than measuring exact duration.
  * - `start` and `end` are each a safe integer or a string of optionally negative ASCII digits.
  * - Fixed-length units (hour, minute, second, …) are zone-independent; a day is a local day in
- *   `options.timeZone`, so New York's 23-hour 2024-03-10 is 1 day long there.
+ *   `options.timeZone`, so Sydney's 23-hour 2024-10-06 is 1 day long there.
  * - Accepts singular or plural units (`"day"` and `"days"` behave identically).
  * - Returns `0` for a zero-length interval (`start === end`).
  * - Returns `null` on invalid input (`start`/`end` that is not a safe integer or numeric string of
  *   one, or lies outside the Temporal instant range, `start > end`, an unsupported unit, an invalid
  *   `epochUnit` or an unknown `timeZone`).
+ * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
+ *   moved by its seconds, and the moved instant must be inside Temporal's range. So within the
+ *   offset's seconds (under a minute) of the last instant Temporal supports
+ *   (`+275760-09-13T00:00:00Z`) for an offset east of UTC, or of the first
+ *   (`-271821-04-20T00:00:00Z`) for one west, this returns `null`. An offset to the minute has no
+ *   such limit.
  *
  * @param start Unix epoch in `epochUnit` — interval start
  * @param end Unix epoch in `epochUnit` — interval end
@@ -26,7 +32,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @example intervalLengthUnix(0, 5400000, "hour") // 1.5
  * @example intervalLengthUnix(0, 0, "hour") // 0
  * @example intervalLengthUnix(86400000, 0, "hour") // null
- * @example intervalLengthUnix(1710046800000, 1710129600000, "day", { timeZone: "America/New_York" }) // 1 (the 23-hour local day)
+ * @example intervalLengthUnix(1728136800000, 1728219600000, "day", { timeZone: "Australia/Sydney" }) // 1 (the 23-hour local day)
  * @example intervalLengthUnix(1710046800000, 1710129600000, "day") // 0.9583333333333334 (23/24 of a UTC day)
  * @example intervalLengthUnix("0", "86400", "hours", { epochUnit: "second" }) // 24
  * @example intervalLengthUnix(NaN, 86400000, "hour") // null

package/dist/unix/interval/intervalOverlappingDaysUnix.d.ts

@@ -24,6 +24,12 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  *   24-hour periods instead of counting calendar dates. To reproduce date-fns's number,
  *   compose `intervalIntersectionUnix` with `intervalCountUnix`:
  *   `const span = intervalIntersectionUnix(aStart, aEnd, bStart, bEnd); span ? intervalCountUnix(span.start, span.end, "day") : 0;`
+ * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
+ *   moved by its seconds, and the moved instant must be inside Temporal's range. So within the
+ *   offset's seconds (under a minute) of the last instant Temporal supports
+ *   (`+275760-09-13T00:00:00Z`) for an offset east of UTC, or of the first
+ *   (`-271821-04-20T00:00:00Z`) for one west, this returns `null`. An offset to the minute has no
+ *   such limit.
  *
  * @param aStart Unix epoch value (seconds or milliseconds) — first interval start
  * @param aEnd Unix epoch value (seconds or milliseconds) — first interval end
@@ -49,8 +55,10 @@ export declare function intervalOverlappingDaysUnix(aStart: number | string, aEn
      */
     epochUnit?: UnixUnit;
     /**
-     * The time zone the calendar dates are counted in: an IANA name, a UTC offset, or `"local"` for
-     * the system time zone. An unknown zone returns `null`.
+     * The time zone the calendar dates are counted 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/unix/interval/intervalOverlappingDaysUnix.js

@@ -1,5 +1,4 @@
-import { normalizeTimeZone } from "../../internal/normalizeTimeZone.js";
-import { countZonedLocalDates, halfOpenIntersection, parseUnixEpochInterval, } from "../../internal/index.js";
+import { countZonedLocalDates, frameZoned, halfOpenIntersection, normalizeZoneFrame, parseUnixEpochInterval, } from "../../internal/index.js";
 import { resolveUnixEpochUnit, unixEpochToInstant, } from "../../internal/unixEpochValue.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
@@ -27,6 +26,12 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  *   24-hour periods instead of counting calendar dates. To reproduce date-fns's number,
  *   compose `intervalIntersectionUnix` with `intervalCountUnix`:
  *   `const span = intervalIntersectionUnix(aStart, aEnd, bStart, bEnd); span ? intervalCountUnix(span.start, span.end, "day") : 0;`
+ * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
+ *   moved by its seconds, and the moved instant must be inside Temporal's range. So within the
+ *   offset's seconds (under a minute) of the last instant Temporal supports
+ *   (`+275760-09-13T00:00:00Z`) for an offset east of UTC, or of the first
+ *   (`-271821-04-20T00:00:00Z`) for one west, this returns `null`. An offset to the minute has no
+ *   such limit.
  *
  * @param aStart Unix epoch value (seconds or milliseconds) — first interval start
  * @param aEnd Unix epoch value (seconds or milliseconds) — first interval end
@@ -56,8 +61,8 @@ export function intervalOverlappingDaysUnix(aStart, aEnd, bStart, bEnd, options)
         const { start: a1, end: a2 } = a;
         const { start: b1, end: b2 } = b;
         const epochUnit = resolveUnixEpochUnit(options?.epochUnit);
-        const timeZone = normalizeTimeZone(options?.timeZone);
-        if (!timeZone || epochUnit === null) {
+        const frame = normalizeZoneFrame(options?.timeZone);
+        if (frame === null || epochUnit === null) {
             return null;
         }
         const overlap = halfOpenIntersection({ start: a1, end: a2 }, { start: b1, end: b2 }, (left, right) => left - right);
@@ -77,7 +82,7 @@ export function intervalOverlappingDaysUnix(aStart, aEnd, bStart, bEnd, options)
         try {
             // The last instant the half-open intersection holds is one nanosecond before its end, so the
             // closed local-date count runs to there.
-            return countZonedLocalDates(first.toZonedDateTimeISO(timeZone), afterLast.toZonedDateTimeISO(timeZone).subtract({ nanoseconds: 1 }));
+            return countZonedLocalDates(frameZoned(first, frame), frameZoned(afterLast, frame).subtract({ nanoseconds: 1 }));
         }
         catch {
             return null;

package/dist/unix/interval/splitIntervalByUnitUnix.d.ts

@@ -11,7 +11,8 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.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` (boundaries are then floored to milliseconds).
@@ -31,6 +32,12 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * - Accepts singular or plural units (`"day"` and `"days"` behave identically).
  * - A split into more than `options.maxPieces` slices returns `[]`, decided from the span before
  *   stepping where it can be, and otherwise as soon as slice `maxPieces + 1` is due.
+ * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
+ *   moved by its seconds, and the moved instant must be inside Temporal's range. So within the
+ *   offset's seconds (under a minute) of the last instant Temporal supports
+ *   (`+275760-09-13T00:00:00Z`) for an offset east of UTC, or of the first
+ *   (`-271821-04-20T00:00:00Z`) for one west, this returns `[]`. An offset to the minute has no
+ *   such limit.
  *
  * @param start Unix epoch in `epochUnit` — interval start
  * @param end Unix epoch in `epochUnit` — interval end
@@ -46,7 +53,7 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * @example splitIntervalByUnitUnix("invalid", 86400000, "hour", 1) // []
  * @example splitIntervalByUnitUnix(0, 86400000, "hour", 6, { maxPieces: 3 }) // [] (4 slices exceed the limit)
  * @example splitIntervalByUnitUnix(0, 86400000, "hour", 6, { maxPieces: 4 }) // [{ start: 0, end: 21600000 }, { start: 21600000, end: 43200000 }, { start: 43200000, end: 64800000 }, { start: 64800000, end: 86400000 }]
- * @example splitIntervalByUnitUnix(1710046800000, 1710216000000, "day", 1, { timeZone: "America/New_York" }) // [{ start: 1710046800000, end: 1710129600000 }, { start: 1710129600000, end: 1710216000000 }] (the first local day is 23 hours)
+ * @example splitIntervalByUnitUnix(1728136800000, 1728306000000, "day", 1, { timeZone: "Australia/Sydney" }) // [{ start: 1728136800000, end: 1728219600000 }, { start: 1728219600000, end: 1728306000000 }] (the first local day is 23 hours)
  * @example splitIntervalByUnitUnix("0", "86400", "hours", 12, { epochUnit: "second" }) // [{ start: 0, end: 43200 }, { start: 43200, end: 86400 }]
  * @example splitIntervalByUnitUnix(0, 2, "millisecond", 500, { epochUnit: "seconds" }) // [{ start: 0, end: 1 }, { start: 1, end: 2 }] (a step finer than the epoch unit gives one-second pieces)
  */
@@ -67,8 +74,10 @@ export declare function splitIntervalByUnitUnix(start: number | string, end: num
      */
     epochUnit?: UnixUnit;
     /**
-     * The time zone the calendar arithmetic runs in: an IANA name, a UTC offset, or `"local"` for
-     * the system time zone. An unknown zone returns `[]`.
+     * The time zone the calendar arithmetic runs 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"`
      */