@northguild/gmt 1.18.0 → 1.20.0

package/dist/zoned/get/getZonedDayOfWeek.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 day of week for the specified IANA timeZone.
  *
@@ -7,17 +6,19 @@ import { isValidTimeZone } from "../validate/index.js";
  * - Returns 1-7 (Monday=1 through Sunday=7).
  * - 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 day of week number (1-7) or null on invalid input
  *
- * @example getZonedDayOfWeek("America/New_York") // 3
+ * @example getZonedDayOfWeek("Australia/Sydney") // 5
  * @example getZonedDayOfWeek("invalid") // null
  */
 export function getZonedDayOfWeek(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.dayOfWeek;
     }
     catch {

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

@@ -4,10 +4,11 @@
  * - 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 hour string (zero-padded to 2 digits) or "" on invalid input
  *
- * @example getZonedHour("America/New_York") // "19"
+ * @example getZonedHour("Africa/Johannesburg") // "16"
  * @example getZonedHour("invalid") // ""
  */
 export declare function getZonedHour(ianaTimezone: string): string;

package/dist/zoned/get/getZonedHour.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 hour 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 hour string (zero-padded to 2 digits) or "" on invalid input
  *
- * @example getZonedHour("America/New_York") // "19"
+ * @example getZonedHour("Africa/Johannesburg") // "16"
  * @example getZonedHour("invalid") // ""
  */
 export function getZonedHour(ianaTimezone) {
-    if (!isValidTimeZone(ianaTimezone))
+    const frame = zoneFrame(ianaTimezone);
+    if (frame === null)
         return "";
     try {
-        return Temporal.Now.zonedDateTimeISO(ianaTimezone)
-            .hour.toString()
-            .padStart(2, "0");
+        return frameNowWallClock(frame).hour.toString().padStart(2, "0");
     }
     catch {
         return "";

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

@@ -4,10 +4,11 @@
  * - 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("Europe/London") // "000"
  * @example getZonedMicrosecond("invalid") // ""
  */
 export declare function getZonedMicrosecond(ianaTimezone: string): string;

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("Europe/London") // "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,10 +4,11 @@
  * - 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("America/Sao_Paulo") // "123"
  * @example getZonedMillisecond("invalid") // ""
  */
 export declare function getZonedMillisecond(ianaTimezone: string): string;

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("America/Sao_Paulo") // "123"
  * @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,10 +4,11 @@
  * - 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("Asia/Kolkata") // "00"
  * @example getZonedMinute("invalid") // ""
  */
 export declare function getZonedMinute(ianaTimezone: string): string;

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("Asia/Kolkata") // "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,10 +4,11 @@
  * - 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("Australia/Sydney") // "03"
  * @example getZonedMonth("invalid") // ""
  */
 export declare function getZonedMonth(ianaTimezone: string): string;

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("Australia/Sydney") // "03"
  * @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,10 +4,11 @@
  * - 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("Africa/Johannesburg") // "000"
  * @example getZonedNanosecond("invalid") // ""
  */
 export declare function getZonedNanosecond(ianaTimezone: string): string;

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("Africa/Johannesburg") // "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

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current zoned datetime for the specified IANA timeZone.
  *
@@ -7,15 +7,19 @@ 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
  *
- * @example getZonedNow("America/New_York") // "2024-02-29T09:30:45.123-05:00[America/New_York]"
- * @example getZonedNow("America/New_York", { smallestUnit: "second" }) // "2024-02-29T09:30:45-05:00[America/New_York]"
+ * @example getZonedNow("Asia/Tokyo") // "2024-02-29T23:30:45.123+09:00[Asia/Tokyo]"
+ * @example getZonedNow("Asia/Tokyo", { smallestUnit: "second" }) // "2024-02-29T23:30:45+09:00[Asia/Tokyo]"
  * @example getZonedNow("Invalid/Zone") // ""
- * @example getZonedNow("America/New_York", { smallestUnit: "fortnight" as never }) // "" (not a unit from minute to nanosecond)
+ * @example getZonedNow("Asia/Tokyo", { smallestUnit: "fortnight" as never }) // "" (not a unit from minute to nanosecond)
  */
 export declare function getZonedNow(ianaTimezone: string, optionsArg?: {
     /**

package/dist/zoned/get/getZonedNow.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidTimeZone } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 import { optionOrDefault } from "../../internal/optionOrDefault.js";
@@ -10,15 +10,19 @@ 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
  *
- * @example getZonedNow("America/New_York") // "2024-02-29T09:30:45.123-05:00[America/New_York]"
- * @example getZonedNow("America/New_York", { smallestUnit: "second" }) // "2024-02-29T09:30:45-05:00[America/New_York]"
+ * @example getZonedNow("Asia/Tokyo") // "2024-02-29T23:30:45.123+09:00[Asia/Tokyo]"
+ * @example getZonedNow("Asia/Tokyo", { smallestUnit: "second" }) // "2024-02-29T23:30:45+09:00[Asia/Tokyo]"
  * @example getZonedNow("Invalid/Zone") // ""
- * @example getZonedNow("America/New_York", { smallestUnit: "fortnight" as never }) // "" (not a unit from minute to nanosecond)
+ * @example getZonedNow("Asia/Tokyo", { smallestUnit: "fortnight" as never }) // "" (not a unit from minute to nanosecond)
  */
 export function getZonedNow(ianaTimezone, optionsArg) {
     try {

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

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../../internal/temporal.js";
 /**
  * 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,12 +32,15 @@ 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
  *
- * @example getZonedNowUnit("America/New_York", "hour") // "07"
+ * @example getZonedNowUnit("Asia/Tokyo", "hour") // "23"
  * @example getZonedNowUnit("UTC", "hours") // "14", if the UTC time is 14:xx (plural unit name)
  * @example getZonedNowUnit("invalid", "hour") // ""
  */

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,12 +25,15 @@ 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
  *
- * @example getZonedNowUnit("America/New_York", "hour") // "07"
+ * @example getZonedNowUnit("Asia/Tokyo", "hour") // "23"
  * @example getZonedNowUnit("UTC", "hours") // "14", if the UTC time is 14:xx (plural unit name)
  * @example getZonedNowUnit("invalid", "hour") // ""
  */
@@ -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,10 +4,11 @@
  * - 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("Europe/London") // "45"
  * @example getZonedSecond("invalid") // ""
  */
 export declare function getZonedSecond(ianaTimezone: string): string;

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("Europe/London") // "45"
  * @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,10 +4,11 @@
  * - 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("Asia/Kolkata") // "2024-02-29"
  * @example getZonedToday("invalid") // ""
  */
 export declare function getZonedToday(ianaTimezone: string): string;

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("Asia/Kolkata") // "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,10 +5,11 @@
  * - 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("America/Sao_Paulo") // 9
  * @example getZonedWeekOfYear("invalid") // null
  */
 export declare function getZonedWeekOfYear(ianaTimezone: string): number | null;

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("America/Sao_Paulo") // 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,11 +3,14 @@
  *
  * - 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("Africa/Johannesburg") // "2024"
  * @example getZonedYear("invalid") // ""
  */
 export declare function getZonedYear(ianaTimezone: string): string;