@northguild/gmt 1.18.0 → 1.19.0

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

package/dist/unix/get/getUnixMinute.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 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

@@ -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 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

@@ -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 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/getUnixNowUnit.d.ts

@@ -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

@@ -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

@@ -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 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 { 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/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 { 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

@@ -12,6 +12,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
@@ -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

@@ -15,6 +15,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

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

@@ -31,6 +31,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
@@ -67,8 +73,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"`
      */

package/dist/unix/interval/splitIntervalByUnitUnix.js

@@ -1,6 +1,6 @@
 // fallow-ignore-file code-duplication -- cross-family Temporal type clone, by design (rule 5)
 import { Temporal } from "@js-temporal/polyfill";
-import { resolveDurationUnit, tileByUnit } from "../../internal/index.js";
+import { frameInstant, resolveDurationUnit, tileByUnit } from "../../internal/index.js";
 import { exceedsPieceLimit, resolveMaxPieces } from "../../internal/maxPieces.js";
 import { resolveUnixIntervalPair } from "../../internal/resolveUnixIntervalPair.js";
 import { minSlicesForSpan, stepNoFinerThan } from "../../internal/splitStep.js";
@@ -37,6 +37,12 @@ import { toUnixEpoch } from "../../internal/unixEpochValue.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
@@ -69,7 +75,7 @@ export function splitIntervalByUnitUnix(start, end, unit, amount, options) {
         if (maxPieces === null) {
             return [];
         }
-        const { startVal, endVal, epochUnit } = pair;
+        const { startVal, endVal, epochUnit, frame } = pair;
         // Temporal's plural duration field name, as the tiling steps add `{ [unit]: amount }`. A step
         // finer than the epoch unit would floor neighbouring boundaries to one value (an empty slice),
         // so it steps by one epoch unit instead.
@@ -77,8 +83,8 @@ export function splitIntervalByUnitUnix(start, end, unit, amount, options) {
         if (startVal.epochNanoseconds === endVal.epochNanoseconds) {
             return [
                 {
-                    start: toUnixEpoch(startVal, epochUnit),
-                    end: toUnixEpoch(endVal, epochUnit),
+                    start: toUnixEpoch(frameInstant(startVal, frame), epochUnit),
+                    end: toUnixEpoch(frameInstant(endVal, frame), epochUnit),
                 },
             ];
         }
@@ -90,8 +96,8 @@ export function splitIntervalByUnitUnix(start, end, unit, amount, options) {
             // Boundaries stay ZonedDateTime (nanosecond) values; only the output is floored to epochUnit.
             const slices = tileByUnit(startVal, endVal, Temporal.ZonedDateTime.compare, resolvedUnit, stepAmount, maxPieces);
             return (slices ?? []).map(([sliceStart, sliceEnd]) => ({
-                start: toUnixEpoch(sliceStart, epochUnit),
-                end: toUnixEpoch(sliceEnd, epochUnit),
+                start: toUnixEpoch(frameInstant(sliceStart, frame), epochUnit),
+                end: toUnixEpoch(frameInstant(sliceEnd, frame), epochUnit),
             }));
         }
         catch {

package/dist/unix/parse/parseDateFromUnix.d.ts

@@ -24,8 +24,10 @@ export declare function parseDateFromUnix(value: number | string, options?: {
      */
     epochUnit?: UnixUnit;
     /**
-     * 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/unix/parse/parseDateFromUnix.js

@@ -1,4 +1,4 @@
-import { unixZonedDateTime } from "../../internal/unixZonedDateTime.js";
+import { unixWallClock } from "../../internal/unixWallClock.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
  * Extract the date portion from a unix epoch value.
@@ -21,8 +21,8 @@ export function parseDateFromUnix(value, options) {
         if (!isOptionsArgument(options)) {
             return "";
         }
-        const zdt = unixZonedDateTime(value, options);
-        return zdt === null ? "" : zdt.toPlainDate().toString();
+        const wallClock = unixWallClock(value, options);
+        return wallClock === null ? "" : wallClock.toPlainDate().toString();
     }
     catch {
         // Never throws (Core Rule 3): a hostile

package/dist/unix/parse/parseDayFromUnix.d.ts

@@ -23,8 +23,10 @@ export declare function parseDayFromUnix(value: number | string, options?: {
      */
     epochUnit?: UnixUnit;
     /**
-     * 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"`
      */