@northguild/gmt 1.18.0 → 1.20.0

package/dist/zoned/format/formatZonedDateTime.js

@@ -1,3 +1,4 @@
+import { cachedFormatter } from "../../internal/formatterCache.js";
 import { normalizeDateTime, zonedDateTimeFrom } from "../../internal/index.js";
 import { instantFormatOptions } from "../../internal/instantFormatOptions.js";
 import { isValidZonedDateTime } from "../validate/index.js";
@@ -22,21 +23,21 @@ import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOpti
  *   options value formats with the defaults, as `Intl.DateTimeFormat` does).
  *
  * @param value zoned ISO 8601 datetime string
- * @param locale optional locale tag (e.g. "en-US"), or a preference list of tags (ECMA-402)
+ * @param locale optional locale tag (e.g. "en-GB", "ja-JP"), or a preference list of tags (ECMA-402)
  * @param options optional Intl.DateTimeFormatOptions
  * @returns localized string or "" when invalid
  *
- * @example formatZonedDateTime("2024-02-29T12:34:56.789+00:00[UTC]", "en-US", { dateStyle: "long", timeStyle: "long" }) // "February 29, 2024 at 12:34:56 PM UTC"
+ * @example formatZonedDateTime("2024-02-29T12:34:56.789+00:00[UTC]", "de-DE", { dateStyle: "long", timeStyle: "long" }) // "29. Februar 2024 um 12:34:56 UTC"
  * @example formatZonedDateTime("2024-02-29T12:34:56.789+00:00[UTC]", "en-GB", { dateStyle: "short", timeStyle: "short" }) // "29/02/2024, 12:34"
- * @example formatZonedDateTime("2024-02-03T14:30:45-05:00[America/New_York]", "ja-JP-u-ca-japanese", { year: "numeric", month: "long" }) // "令和6年2月"
- * @example formatZonedDateTime("2024-02-03T14:30:45-05:00[America/New_York]", "ja-JP-u-ca-japanese", { year: "numeric", month: "numeric" }) // "R6/2" — the pre-1.16.0 text
- * @example formatZonedDateTime("2024-02-03T14:30:45-05:00[America/New_York]", "en-US", { era: "long" }) // "2/3/2024 Anno Domini, 2:30:45 PM EST"
- * @example formatZonedDateTime("2024-02-03T14:30:45-05:00[America/New_York]", "en-US", { era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "2/3/2024 Anno Domini" — the pre-1.16.0 text
- * @example formatZonedDateTime("2024-02-03T14:30:45-05:00[America/New_York]", "en-US", { timeZone: "Asia/Tokyo" }) // "" — a ZonedDateTime keeps its own zone
- * @example formatUtc("2024-02-03T19:30:45Z", "en-US", { timeZone: "Asia/Tokyo", includeTimeZoneName: true }) // "2/4/2024, 4:30:45 AM GMT+9" — the same instant in another zone
- * @example formatZonedDateTime("invalid", "en-US") // "" (invalid input)
+ * @example formatZonedDateTime("2024-02-03T14:30:45+09:00[Asia/Tokyo]", "ja-JP-u-ca-japanese", { year: "numeric", month: "long" }) // "令和6年2月"
+ * @example formatZonedDateTime("2024-02-03T14:30:45+09:00[Asia/Tokyo]", "ja-JP-u-ca-japanese", { year: "numeric", month: "numeric" }) // "R6/2" — the pre-1.16.0 text
+ * @example formatZonedDateTime("2024-02-03T14:30:45+00:00[Europe/London]", "en-GB", { era: "long" }) // "03/02/2024 Anno Domini, 14:30:45 GMT"
+ * @example formatZonedDateTime("2024-02-03T14:30:45+00:00[Europe/London]", "en-GB", { era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "03/02/2024 Anno Domini" — the pre-1.16.0 text
+ * @example formatZonedDateTime("2024-02-03T14:30:45+00:00[Europe/London]", "en-GB", { timeZone: "Asia/Tokyo" }) // "" — a ZonedDateTime keeps its own zone
+ * @example formatUtc("2024-02-03T14:30:45Z", "en-GB", { timeZone: "Asia/Tokyo", includeTimeZoneName: true }) // "03/02/2024, 23:30:45 GMT+9" — the same instant in another zone
+ * @example formatZonedDateTime("invalid", "pt-BR") // "" (invalid input)
  * @example formatZonedDateTime("2024-02-03T14:30:45+01:00[Europe/Paris]", ["fr-FR", "en-US"], { dateStyle: "short", timeStyle: "short" }) // "03/02/2024 14:30"
- * @example formatZonedDateTime("2024-02-03T14:30:00-05:00[America/New_York]", "en-US", null as never) // "" (null options, as ECMA-402 rejects them)
+ * @example formatZonedDateTime("2024-02-03T14:30:00+05:30[Asia/Kolkata]", "hi-IN", null as never) // "" (null options, as ECMA-402 rejects them)
  */
 export function formatZonedDateTime(value, locale, options) {
     // ECMA-402 CoerceOptionsToObject: null options throw TypeError, so they are invalid input.
@@ -56,7 +57,7 @@ export function formatZonedDateTime(value, locale, options) {
         if (resolved === null) {
             return "";
         }
-        return normalizeDateTime(new Intl.DateTimeFormat(locale, resolved).format(zonedDateTime.epochMilliseconds));
+        return normalizeDateTime(cachedFormatter("DateTimeFormat", locale, resolved).format(zonedDateTime.epochMilliseconds));
     }
     catch {
         return "";

package/dist/zoned/format/formatZonedRange.d.ts

@@ -24,14 +24,14 @@ import type { DateTimeFormatOptions } from "../../types/index.js";
  * @param options optional Intl.DateTimeFormatOptions
  * @returns localized range string or "" when invalid
  *
- * @example formatZonedRange("2024-02-29T12:00:00.000+00:00[UTC]", "2024-02-29T14:00:00.000+00:00[UTC]", "en-US", { dateStyle: "long", timeStyle: "short" }) // "February 29, 2024, 12:00 - 2:00 PM"
+ * @example formatZonedRange("2024-02-29T12:00:00.000+00:00[UTC]", "2024-02-29T14:00:00.000+00:00[UTC]", "de-DE", { dateStyle: "long", timeStyle: "short" }) // "29. Februar 2024, 12:00-14:00 Uhr"
  * @example formatZonedRange("2024-02-29T12:00:00.000+00:00[UTC]", "2024-02-29T14:00:00.000+00:00[UTC]", "en-GB", { dateStyle: "short", timeStyle: "short" }) // "29/02/2024, 12:00-14:00"
- * @example formatZonedRange("2024-02-03T14:30:45-05:00[America/New_York]", "2024-02-03T15:30:45-05:00[America/New_York]", "zh-CN", { year: "numeric", month: "long" }) // "2024年2月"
- * @example formatZonedRange("2024-02-03T14:30:45-05:00[America/New_York]", "2024-02-03T15:30:45-05:00[America/New_York]", "en-US", { era: "long" }) // "2/3/2024 Anno Domini, 2:30:45 PM - 3:30:45 PM"
- * @example formatZonedRange("2024-02-29T10:00:00-05:00[America/New_York]", "2024-02-29T12:00:00-05:00[America/New_York]", "en-US", { hour: "numeric", timeZone: "UTC" }) // "" — a ZonedDateTime keeps its own zone
- * @example formatZonedRange("2024-02-29T10:00:00-05:00[America/New_York]", "2024-02-29T12:00:00-05:00[America/New_York]", "en-US", { hour: "numeric", minute: "numeric", timeZoneName: "short" }) // "10:00 AM - 12:00 PM EST" — the pre-1.16.0 text
- * @example formatZonedRange("invalid", "2024-02-29T14:00:00.000+00:00[UTC]", "en-US") // "" (invalid input)
+ * @example formatZonedRange("2024-02-03T14:30:45+08:00[Asia/Shanghai]", "2024-02-03T15:30:45+08:00[Asia/Shanghai]", "zh-CN", { year: "numeric", month: "long" }) // "2024年2月"
+ * @example formatZonedRange("2024-02-03T14:30:45+00:00[Europe/London]", "2024-02-03T15:30:45+00:00[Europe/London]", "en-GB", { era: "long" }) // "03/02/2024 Anno Domini, 14:30:45 - 15:30:45"
+ * @example formatZonedRange("2024-02-29T10:00:00+09:00[Asia/Tokyo]", "2024-02-29T12:00:00+09:00[Asia/Tokyo]", "ja-JP", { hour: "numeric", timeZone: "UTC" }) // "" — a ZonedDateTime keeps its own zone
+ * @example formatZonedRange("2024-02-29T10:00:00+00:00[Europe/London]", "2024-02-29T12:00:00+00:00[Europe/London]", "en-GB", { hour: "numeric", minute: "numeric", timeZoneName: "short" }) // "10:00-12:00 GMT" — the pre-1.16.0 text
+ * @example formatZonedRange("invalid", "2024-02-29T14:00:00.000+00:00[UTC]", "fr-FR") // "" (invalid input)
  * @example formatZonedRange("2024-02-03T14:30:45+01:00[Europe/Paris]", "2024-02-03T16:46:15+01:00[Europe/Paris]", ["fr-FR", "en-US"], { dateStyle: "short", timeStyle: "short" }) // "03/02/2024, 14:30 - 16:46"
- * @example formatZonedRange("2024-02-03T14:30:00-05:00[America/New_York]", "2024-02-05T17:00:00-05:00[America/New_York]", "en-US", null as never) // "" (null options, as ECMA-402 rejects them)
+ * @example formatZonedRange("2024-02-03T14:30:00-03:00[America/Sao_Paulo]", "2024-02-05T17:00:00-03:00[America/Sao_Paulo]", "pt-BR", null as never) // "" (null options, as ECMA-402 rejects them)
  */
 export declare function formatZonedRange(from: string, to: string, locale?: string | string[], options?: DateTimeFormatOptions): string;

package/dist/zoned/format/formatZonedRange.js

@@ -1,3 +1,4 @@
+import { cachedFormatter } from "../../internal/formatterCache.js";
 import { normalizeDateTime, zonedDateTimeFrom } from "../../internal/index.js";
 import { instantFormatOptions } from "../../internal/instantFormatOptions.js";
 import { isValidZonedDateTime } from "../validate/index.js";
@@ -27,15 +28,15 @@ import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOpti
  * @param options optional Intl.DateTimeFormatOptions
  * @returns localized range string or "" when invalid
  *
- * @example formatZonedRange("2024-02-29T12:00:00.000+00:00[UTC]", "2024-02-29T14:00:00.000+00:00[UTC]", "en-US", { dateStyle: "long", timeStyle: "short" }) // "February 29, 2024, 12:00 - 2:00 PM"
+ * @example formatZonedRange("2024-02-29T12:00:00.000+00:00[UTC]", "2024-02-29T14:00:00.000+00:00[UTC]", "de-DE", { dateStyle: "long", timeStyle: "short" }) // "29. Februar 2024, 12:00-14:00 Uhr"
  * @example formatZonedRange("2024-02-29T12:00:00.000+00:00[UTC]", "2024-02-29T14:00:00.000+00:00[UTC]", "en-GB", { dateStyle: "short", timeStyle: "short" }) // "29/02/2024, 12:00-14:00"
- * @example formatZonedRange("2024-02-03T14:30:45-05:00[America/New_York]", "2024-02-03T15:30:45-05:00[America/New_York]", "zh-CN", { year: "numeric", month: "long" }) // "2024年2月"
- * @example formatZonedRange("2024-02-03T14:30:45-05:00[America/New_York]", "2024-02-03T15:30:45-05:00[America/New_York]", "en-US", { era: "long" }) // "2/3/2024 Anno Domini, 2:30:45 PM - 3:30:45 PM"
- * @example formatZonedRange("2024-02-29T10:00:00-05:00[America/New_York]", "2024-02-29T12:00:00-05:00[America/New_York]", "en-US", { hour: "numeric", timeZone: "UTC" }) // "" — a ZonedDateTime keeps its own zone
- * @example formatZonedRange("2024-02-29T10:00:00-05:00[America/New_York]", "2024-02-29T12:00:00-05:00[America/New_York]", "en-US", { hour: "numeric", minute: "numeric", timeZoneName: "short" }) // "10:00 AM - 12:00 PM EST" — the pre-1.16.0 text
- * @example formatZonedRange("invalid", "2024-02-29T14:00:00.000+00:00[UTC]", "en-US") // "" (invalid input)
+ * @example formatZonedRange("2024-02-03T14:30:45+08:00[Asia/Shanghai]", "2024-02-03T15:30:45+08:00[Asia/Shanghai]", "zh-CN", { year: "numeric", month: "long" }) // "2024年2月"
+ * @example formatZonedRange("2024-02-03T14:30:45+00:00[Europe/London]", "2024-02-03T15:30:45+00:00[Europe/London]", "en-GB", { era: "long" }) // "03/02/2024 Anno Domini, 14:30:45 - 15:30:45"
+ * @example formatZonedRange("2024-02-29T10:00:00+09:00[Asia/Tokyo]", "2024-02-29T12:00:00+09:00[Asia/Tokyo]", "ja-JP", { hour: "numeric", timeZone: "UTC" }) // "" — a ZonedDateTime keeps its own zone
+ * @example formatZonedRange("2024-02-29T10:00:00+00:00[Europe/London]", "2024-02-29T12:00:00+00:00[Europe/London]", "en-GB", { hour: "numeric", minute: "numeric", timeZoneName: "short" }) // "10:00-12:00 GMT" — the pre-1.16.0 text
+ * @example formatZonedRange("invalid", "2024-02-29T14:00:00.000+00:00[UTC]", "fr-FR") // "" (invalid input)
  * @example formatZonedRange("2024-02-03T14:30:45+01:00[Europe/Paris]", "2024-02-03T16:46:15+01:00[Europe/Paris]", ["fr-FR", "en-US"], { dateStyle: "short", timeStyle: "short" }) // "03/02/2024, 14:30 - 16:46"
- * @example formatZonedRange("2024-02-03T14:30:00-05:00[America/New_York]", "2024-02-05T17:00:00-05:00[America/New_York]", "en-US", null as never) // "" (null options, as ECMA-402 rejects them)
+ * @example formatZonedRange("2024-02-03T14:30:00-03:00[America/Sao_Paulo]", "2024-02-05T17:00:00-03:00[America/Sao_Paulo]", "pt-BR", null as never) // "" (null options, as ECMA-402 rejects them)
  */
 export function formatZonedRange(from, to, locale, options) {
     try {
@@ -67,7 +68,7 @@ export function formatZonedRange(from, to, locale, options) {
             return "";
         }
         try {
-            const out = new Intl.DateTimeFormat(locale, formatOptions).formatRange(zdt1.epochMilliseconds, zdt2.epochMilliseconds);
+            const out = cachedFormatter("DateTimeFormat", locale, formatOptions).formatRange(zdt1.epochMilliseconds, zdt2.epochMilliseconds);
             return normalizeDateTime(out);
         }
         catch {

package/dist/zoned/format/formatZonedToParts.d.ts

@@ -2,10 +2,10 @@ import type { DateTimeFormatOptions } from "../../types/index.js";
 /**
  * Return the locale-formatted parts of a ZonedDateTime.
  *
- * - This is GMT's substitute for a token formatter (Luxon `toFormat`, date-fns
- *   `format`). A token pattern hard-codes field order and ships US ordering to
- *   every locale; `formatToParts` gives the caller full control over presentation
- *   while the *locale* keeps control of order.
+ * - Use the parts instead of a fixed field pattern. A pattern such as UTS #35's `dd/MM/yyyy` fixes
+ *   one field order for every locale; ECMA-402's `Intl.DateTimeFormat.prototype.formatToParts`
+ *   (§11.3.6; `FormatDateTimeToParts` §11.5.7) returns the fields in the order of the locale's
+ *   CLDR date pattern, so the caller controls presentation and the locale keeps control of order.
  * - Each part is `{ type, value }` where `type` can be:
  *   `"era"`, `"year"`, `"relatedYear"`, `"yearName"`, `"month"`, `"day"`, `"weekday"`,
  *   `"hour"`, `"minute"`, `"second"`, `"fractionalSecond"`, `"dayPeriod"`,
@@ -37,17 +37,17 @@ import type { DateTimeFormatOptions } from "../../types/index.js";
  *   options value formats with the defaults, as `Intl.DateTimeFormat` does).
  *
  * @param value zoned ISO 8601 datetime string
- * @param locale optional locale tag (e.g. "en-US"), or a preference list of tags (ECMA-402)
+ * @param locale optional locale tag (e.g. "en-GB", "ja-JP"), or a preference list of tags (ECMA-402)
  * @param options optional Intl.DateTimeFormatOptions
  * @returns array of `{ type, value }` parts, or `[]` on invalid input
  *
- * @example formatZonedToParts("2024-03-15T14:30:00.000-04:00[America/New_York]", "en-US") // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "2" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "EDT" }]
- * @example formatZonedToParts("2024-03-15T14:30:00.000-04:00[America/New_York]", "en-US", { timeZoneName: "longOffset" }) // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "2" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "GMT-04:00" }]
- * @example formatZonedToParts("2024-03-15T14:30:00.000-04:00[America/New_York]", "en-US", { year: "numeric", month: "numeric", day: "numeric" }) // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }] — the pre-1.16.0 default
- * @example formatZonedToParts("2024-03-15T14:30:00.000-04:00[America/New_York]", "en-US", { timeZone: "Asia/Tokyo" }) // [] — a ZonedDateTime keeps its own zone
- * @example formatZonedToParts("invalid", "en-US") // []
+ * @example formatZonedToParts("2024-03-15T14:30:00.000+00:00[Europe/London]", "en-GB") // [{ type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "month", value: "03" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "14" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "GMT" }]
+ * @example formatZonedToParts("2024-03-15T14:30:00.000+05:30[Asia/Kolkata]", "en-US", { timeZoneName: "longOffset" }) // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "2" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "GMT+05:30" }]
+ * @example formatZonedToParts("2024-03-15T14:30:00.000+00:00[Europe/London]", "en-GB", { year: "numeric", month: "numeric", day: "numeric" }) // [{ type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "month", value: "03" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }] — the pre-1.16.0 default
+ * @example formatZonedToParts("2024-03-15T14:30:00.000+00:00[Europe/London]", "en-GB", { timeZone: "Asia/Tokyo" }) // [] — a ZonedDateTime keeps its own zone
+ * @example formatZonedToParts("invalid", "de-DE") // []
  * @example formatZonedToParts("2024-02-03T14:30:45+01:00[Europe/Paris]", ["fr-FR", "en-US"], { dateStyle: "medium", timeStyle: "short" }) // parts of "3 févr. 2024, 14:30"
- * @example formatZonedToParts("2024-02-03T14:30:00-05:00[America/New_York]", "en-US", null as never) // [] (null options, as ECMA-402 rejects them)
+ * @example formatZonedToParts("2024-02-03T14:30:00+02:00[Africa/Johannesburg]", "ar-EG", null as never) // [] (null options, as ECMA-402 rejects them)
  */
 export declare function formatZonedToParts(value: string, locale?: string | string[], options?: DateTimeFormatOptions): Array<{
     /**

package/dist/zoned/format/formatZonedToParts.js

@@ -1,3 +1,4 @@
+import { cachedFormatter } from "../../internal/formatterCache.js";
 import { isValidZonedDateTime } from "../validate/index.js";
 import { zonedDateTimeFrom } from "../../internal/index.js";
 import { instantFormatOptions } from "../../internal/instantFormatOptions.js";
@@ -5,10 +6,10 @@ import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOpti
 /**
  * Return the locale-formatted parts of a ZonedDateTime.
  *
- * - This is GMT's substitute for a token formatter (Luxon `toFormat`, date-fns
- *   `format`). A token pattern hard-codes field order and ships US ordering to
- *   every locale; `formatToParts` gives the caller full control over presentation
- *   while the *locale* keeps control of order.
+ * - Use the parts instead of a fixed field pattern. A pattern such as UTS #35's `dd/MM/yyyy` fixes
+ *   one field order for every locale; ECMA-402's `Intl.DateTimeFormat.prototype.formatToParts`
+ *   (§11.3.6; `FormatDateTimeToParts` §11.5.7) returns the fields in the order of the locale's
+ *   CLDR date pattern, so the caller controls presentation and the locale keeps control of order.
  * - Each part is `{ type, value }` where `type` can be:
  *   `"era"`, `"year"`, `"relatedYear"`, `"yearName"`, `"month"`, `"day"`, `"weekday"`,
  *   `"hour"`, `"minute"`, `"second"`, `"fractionalSecond"`, `"dayPeriod"`,
@@ -40,17 +41,17 @@ import { readDateTimeFormatOptions } from "../../internal/readDateTimeFormatOpti
  *   options value formats with the defaults, as `Intl.DateTimeFormat` does).
  *
  * @param value zoned ISO 8601 datetime string
- * @param locale optional locale tag (e.g. "en-US"), or a preference list of tags (ECMA-402)
+ * @param locale optional locale tag (e.g. "en-GB", "ja-JP"), or a preference list of tags (ECMA-402)
  * @param options optional Intl.DateTimeFormatOptions
  * @returns array of `{ type, value }` parts, or `[]` on invalid input
  *
- * @example formatZonedToParts("2024-03-15T14:30:00.000-04:00[America/New_York]", "en-US") // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "2" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "EDT" }]
- * @example formatZonedToParts("2024-03-15T14:30:00.000-04:00[America/New_York]", "en-US", { timeZoneName: "longOffset" }) // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "2" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "GMT-04:00" }]
- * @example formatZonedToParts("2024-03-15T14:30:00.000-04:00[America/New_York]", "en-US", { year: "numeric", month: "numeric", day: "numeric" }) // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }] — the pre-1.16.0 default
- * @example formatZonedToParts("2024-03-15T14:30:00.000-04:00[America/New_York]", "en-US", { timeZone: "Asia/Tokyo" }) // [] — a ZonedDateTime keeps its own zone
- * @example formatZonedToParts("invalid", "en-US") // []
+ * @example formatZonedToParts("2024-03-15T14:30:00.000+00:00[Europe/London]", "en-GB") // [{ type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "month", value: "03" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "14" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "GMT" }]
+ * @example formatZonedToParts("2024-03-15T14:30:00.000+05:30[Asia/Kolkata]", "en-US", { timeZoneName: "longOffset" }) // [{ type: "month", value: "3" }, { type: "literal", value: "/" }, { type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }, { type: "literal", value: ", " }, { type: "hour", value: "2" }, { type: "literal", value: ":" }, { type: "minute", value: "30" }, { type: "literal", value: ":" }, { type: "second", value: "00" }, { type: "literal", value: "\u202f" }, { type: "dayPeriod", value: "PM" }, { type: "literal", value: " " }, { type: "timeZoneName", value: "GMT+05:30" }]
+ * @example formatZonedToParts("2024-03-15T14:30:00.000+00:00[Europe/London]", "en-GB", { year: "numeric", month: "numeric", day: "numeric" }) // [{ type: "day", value: "15" }, { type: "literal", value: "/" }, { type: "month", value: "03" }, { type: "literal", value: "/" }, { type: "year", value: "2024" }] — the pre-1.16.0 default
+ * @example formatZonedToParts("2024-03-15T14:30:00.000+00:00[Europe/London]", "en-GB", { timeZone: "Asia/Tokyo" }) // [] — a ZonedDateTime keeps its own zone
+ * @example formatZonedToParts("invalid", "de-DE") // []
  * @example formatZonedToParts("2024-02-03T14:30:45+01:00[Europe/Paris]", ["fr-FR", "en-US"], { dateStyle: "medium", timeStyle: "short" }) // parts of "3 févr. 2024, 14:30"
- * @example formatZonedToParts("2024-02-03T14:30:00-05:00[America/New_York]", "en-US", null as never) // [] (null options, as ECMA-402 rejects them)
+ * @example formatZonedToParts("2024-02-03T14:30:00+02:00[Africa/Johannesburg]", "ar-EG", null as never) // [] (null options, as ECMA-402 rejects them)
  */
 export function formatZonedToParts(value, locale, options) {
     // ECMA-402 CoerceOptionsToObject: null options throw TypeError, so they are invalid input.
@@ -70,7 +71,7 @@ export function formatZonedToParts(value, locale, options) {
         if (resolved === null) {
             return [];
         }
-        return new Intl.DateTimeFormat(locale, resolved)
+        return cachedFormatter("DateTimeFormat", locale, resolved)
             .formatToParts(zonedDateTime.epochMilliseconds)
             .map((p) => ({ type: p.type, value: p.value }));
     }

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

@@ -5,17 +5,17 @@
  * @example
  * import { DstTransition } from "@northguild/gmt/zoned";
  * const t: DstTransition = {
- *   instant: "2024-03-10T07:00:00Z",
- *   offsetBefore: "-05:00",
- *   offsetAfter: "-04:00",
+ *   instant: "2024-10-05T16:00:00Z",
+ *   offsetBefore: "+10:00",
+ *   offsetAfter: "+11:00",
  * };
  */
 export interface DstTransition {
-    /** The UTC instant of the offset change, ISO 8601 ending in `Z` (e.g. `2024-03-10T07:00:00Z`). */
+    /** The UTC instant of the offset change, ISO 8601 ending in `Z` (e.g. `2024-10-05T16:00:00Z`). */
     instant: string;
-    /** The UTC offset in effect immediately before the transition (e.g. `-05:00`). */
+    /** The UTC offset in effect immediately before the transition (e.g. `+10:00`). */
     offsetBefore: string;
-    /** The UTC offset in effect immediately after the transition (e.g. `-04:00`). */
+    /** The UTC offset in effect immediately after the transition (e.g. `+11:00`). */
     offsetAfter: string;
 }
 /**
@@ -35,22 +35,24 @@ export interface DstTransition {
  * - Returns `[]` for an invalid timeZone, a non-integer year, or a valid zone
  *   with zero transitions in that year (not an error case), and when the scan
  *   exhausts its internal bound — never a partial list.
- * - A UTC offset such as `"+05:30"` is a valid zone whose offset never changes,
- *   so it has no transitions and returns `[]` for every year.
+ * - A UTC offset, with or without seconds (`"+05:30"`, `"-00:44:30"`), never changes, so it has no
+ *   transitions and returns `[]` for every year.
  *
- * @param timeZone IANA name or UTC offset
+ * @param timeZone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or a
+ *   stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @param year calendar year to scan (must be an integer)
  * @returns array of `{ instant, offsetBefore, offsetAfter }`, in chronological order
  *
- * @example getDstTransitions("America/New_York", 2024)
+ * @example getDstTransitions("Australia/Sydney", 2024)
  * // [
- * //   { instant: "2024-03-10T07:00:00Z", offsetBefore: "-05:00", offsetAfter: "-04:00" },
- * //   { instant: "2024-11-03T06:00:00Z", offsetBefore: "-04:00", offsetAfter: "-05:00" },
+ * //   { instant: "2024-04-06T16:00:00Z", offsetBefore: "+11:00", offsetAfter: "+10:00" },
+ * //   { instant: "2024-10-05T16:00:00Z", offsetBefore: "+10:00", offsetAfter: "+11:00" },
  * // ]
  * @example getDstTransitions("Asia/Singapore", 1982)
  * // [{ instant: "1981-12-31T16:00:00Z", offsetBefore: "+07:30", offsetAfter: "+08:00" }]
  * @example getDstTransitions("Asia/Tokyo", 2024) // []
  * @example getDstTransitions("+05:30", 2024) // [] (a fixed offset has no transitions)
  * @example getDstTransitions("Invalid/Zone", 2024) // []
+ * @example getDstTransitions("-00:44:30", 1970) // [] (a fixed offset)
  */
 export declare function getDstTransitions(timeZone: string, year: number): DstTransition[];

package/dist/zoned/get/getDstTransitions.js

@@ -1,5 +1,4 @@
-import { isValidTimeZone } from "../validate/index.js";
-import { zonedDateTimeFrom, zonedNextTransition, zonedStartOfDay, } from "../../internal/index.js";
+import { zonedDateTimeFrom, zonedNextTransition, zonedStartOfDay, zoneFrame, } from "../../internal/index.js";
 const MAX_TRANSITIONS_PER_YEAR = 20;
 /** 368 days: a 366-day year plus a day at each end for the zone's offset. */
 const SEARCH_SPAN_NANOSECONDS = 368n * 86400000000000n;
@@ -20,32 +19,38 @@ const SEARCH_SPAN_NANOSECONDS = 368n * 86400000000000n;
  * - Returns `[]` for an invalid timeZone, a non-integer year, or a valid zone
  *   with zero transitions in that year (not an error case), and when the scan
  *   exhausts its internal bound — never a partial list.
- * - A UTC offset such as `"+05:30"` is a valid zone whose offset never changes,
- *   so it has no transitions and returns `[]` for every year.
+ * - A UTC offset, with or without seconds (`"+05:30"`, `"-00:44:30"`), never changes, so it has no
+ *   transitions and returns `[]` for every year.
  *
- * @param timeZone IANA name or UTC offset
+ * @param timeZone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or a
+ *   stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @param year calendar year to scan (must be an integer)
  * @returns array of `{ instant, offsetBefore, offsetAfter }`, in chronological order
  *
- * @example getDstTransitions("America/New_York", 2024)
+ * @example getDstTransitions("Australia/Sydney", 2024)
  * // [
- * //   { instant: "2024-03-10T07:00:00Z", offsetBefore: "-05:00", offsetAfter: "-04:00" },
- * //   { instant: "2024-11-03T06:00:00Z", offsetBefore: "-04:00", offsetAfter: "-05:00" },
+ * //   { instant: "2024-04-06T16:00:00Z", offsetBefore: "+11:00", offsetAfter: "+10:00" },
+ * //   { instant: "2024-10-05T16:00:00Z", offsetBefore: "+10:00", offsetAfter: "+11:00" },
  * // ]
  * @example getDstTransitions("Asia/Singapore", 1982)
  * // [{ instant: "1981-12-31T16:00:00Z", offsetBefore: "+07:30", offsetAfter: "+08:00" }]
  * @example getDstTransitions("Asia/Tokyo", 2024) // []
  * @example getDstTransitions("+05:30", 2024) // [] (a fixed offset has no transitions)
  * @example getDstTransitions("Invalid/Zone", 2024) // []
+ * @example getDstTransitions("-00:44:30", 1970) // [] (a fixed offset)
  */
 export function getDstTransitions(timeZone, year) {
-    if (!isValidTimeZone(timeZone) || !Number.isInteger(year)) {
+    const frame = zoneFrame(timeZone);
+    // A stored offset with seconds is a fixed offset: it has no transitions, as "-00:45" has none.
+    if (frame === null ||
+        frame.shiftNanoseconds !== 0n ||
+        !Number.isInteger(year)) {
         return [];
     }
     try {
         // getTimeZoneTransition("next") is strictly after its receiver, so start 1ns before the
         // year opens to catch a transition landing exactly on local January 1 00:00.
-        let cur = zonedStartOfDay(zonedDateTimeFrom({ year, month: 1, day: 1, timeZone })).subtract({ nanoseconds: 1 });
+        let cur = zonedStartOfDay(zonedDateTimeFrom({ year, month: 1, day: 1, timeZone: frame.timeZone })).subtract({ nanoseconds: 1 });
         // A calendar year is at most 366 days and an offset is under a day, so no search needs to
         // read past this.
         const searchEnd = cur.epochNanoseconds + SEARCH_SPAN_NANOSECONDS;

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

@@ -1,11 +1,13 @@
 /**
- * Return the runtime system timeZone name (for example "America/New_York").
+ * Return the runtime system timeZone name (for example "Europe/London").
  *
  * - Uses Intl.DateTimeFormat().resolvedOptions().timeZone to get system timezone.
- * - Returns "" when timezone is unavailable.
+ * - Returns "" when the host reports no usable time zone. With an empty `TZ` the runtime reports
+ *   ICU's placeholder `"Etc/Unknown"`, and with an unrecognised `TZ` it reports `undefined`;
+ *   neither is a zone that Temporal or `Intl.DateTimeFormat` accepts.
  *
  * @returns system timeZone name or "" on failure
  *
- * @example getSystemTimeZone() // "America/New_York"
+ * @example getSystemTimeZone() // "Europe/London"
  */
 export declare function getSystemTimeZone(): string;

package/dist/zoned/get/getSystemTimeZone.js

@@ -1,17 +1,20 @@
+import { isValidTimeZone } from "../validate/isValidTimeZone.js";
 /**
- * Return the runtime system timeZone name (for example "America/New_York").
+ * Return the runtime system timeZone name (for example "Europe/London").
  *
  * - Uses Intl.DateTimeFormat().resolvedOptions().timeZone to get system timezone.
- * - Returns "" when timezone is unavailable.
+ * - Returns "" when the host reports no usable time zone. With an empty `TZ` the runtime reports
+ *   ICU's placeholder `"Etc/Unknown"`, and with an unrecognised `TZ` it reports `undefined`;
+ *   neither is a zone that Temporal or `Intl.DateTimeFormat` accepts.
  *
  * @returns system timeZone name or "" on failure
  *
- * @example getSystemTimeZone() // "America/New_York"
+ * @example getSystemTimeZone() // "Europe/London"
  */
 export function getSystemTimeZone() {
     try {
         const systemTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
-        return systemTimeZone || "";
+        return isValidTimeZone(systemTimeZone) ? systemTimeZone : "";
     }
     catch {
         return "";

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

@@ -1,5 +1,5 @@
 /**
- * Return an IANA timeZone's UTC offset at a given instant.
+ * Return a time zone's UTC offset at a given instant.
  *
  * - Unlike `getZonedOffset`, this doesn't need an existing zoned value in
  *   hand — pass any timeZone identifier and an instant to look up, which is
@@ -17,17 +17,25 @@
  * - Only the instant is read from `instant`, as `isValidInstant` describes it: a bracketed zone
  *   in it is not validated, and an offset written to the minute that is that zone's sub-minute
  *   offset rounded (`-00:45[Africa/Monrovia]`, for −00:44:30) names the instant the zone gives.
+ * - The result is `±HH:MM`, or `±HH:MM:SS` where the zone was not on a whole minute
+ *   (`Africa/Monrovia` stood at `-00:44:30` until 1972). It goes straight into the time zone
+ *   position of any function whose result has no zone in it, and of this one: a UTC offset is its
+ *   own answer at every instant, written without seconds when they are zero.
  *
- * @param timeZone IANA name or UTC offset
+ * @param timeZone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or a
+ *   stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @param instant ISO 8601 instant string (e.g. "2024-07-15T12:00:00Z")
- * @returns offset string (e.g. "-04:00"), or "" on invalid input
+ * @returns offset string (e.g. "+10:00"), or "" on invalid input
  *
- * @example getTimeZoneOffset("America/New_York", "2024-07-15T12:00:00Z") // "-04:00"
- * @example getTimeZoneOffset("America/New_York", "2024-01-15T12:00:00Z") // "-05:00"
+ * @example getTimeZoneOffset("Australia/Sydney", "2024-07-15T12:00:00Z") // "+10:00"
+ * @example getTimeZoneOffset("Australia/Sydney", "2024-01-15T12:00:00Z") // "+11:00"
  * @example getTimeZoneOffset("Asia/Kathmandu", "2024-01-15T12:00:00Z") // "+05:45"
+ * @example getTimeZoneOffset("Africa/Monrovia", "1970-01-01T12:00:00Z") // "-00:44:30" (an offset with seconds)
+ * @example getTimeZoneOffset("-00:44:30", "1970-01-01T12:00:00Z") // "-00:44:30" (its own result, read back)
+ * @example getTimeZoneOffset("+05:30:00", "1970-01-01T12:00:00Z") // "+05:30"
  * @example getTimeZoneOffset("Invalid/Zone", "2024-07-15T12:00:00Z") // ""
- * @example getTimeZoneOffset("America/New_York", "not an instant") // ""
- * @example getTimeZoneOffset("America/New_York", "2024-07-15T16:00:00z") // "" (lower-case z)
+ * @example getTimeZoneOffset("Africa/Johannesburg", "not an instant") // ""
+ * @example getTimeZoneOffset("Africa/Johannesburg", "2024-07-15T16:00:00z") // "" (lower-case z)
  * @example getTimeZoneOffset("UTC", "2016-12-31T23:59:60Z") // "" (leap second)
  * @example getTimeZoneOffset("UTC", "2016-12-31T23:59:60Z".replace(":60", ":59")) // "+00:00" (the clamped instant)
  */

package/dist/zoned/get/getTimeZoneOffset.js

@@ -1,9 +1,9 @@
 import { instantFrom } from "../../internal/instantNanoseconds.js";
 import { hasInstantShape } from "../../internal/isoStringBody.js";
 import { instantLeapSecond } from "../../regex/index.js";
-import { isValidTimeZone } from "../validate/index.js";
+import { frameOffset, zoneFrame } from "../../internal/zoneFrame.js";
 /**
- * Return an IANA timeZone's UTC offset at a given instant.
+ * Return a time zone's UTC offset at a given instant.
  *
  * - Unlike `getZonedOffset`, this doesn't need an existing zoned value in
  *   hand — pass any timeZone identifier and an instant to look up, which is
@@ -21,17 +21,25 @@ import { isValidTimeZone } from "../validate/index.js";
  * - Only the instant is read from `instant`, as `isValidInstant` describes it: a bracketed zone
  *   in it is not validated, and an offset written to the minute that is that zone's sub-minute
  *   offset rounded (`-00:45[Africa/Monrovia]`, for −00:44:30) names the instant the zone gives.
+ * - The result is `±HH:MM`, or `±HH:MM:SS` where the zone was not on a whole minute
+ *   (`Africa/Monrovia` stood at `-00:44:30` until 1972). It goes straight into the time zone
+ *   position of any function whose result has no zone in it, and of this one: a UTC offset is its
+ *   own answer at every instant, written without seconds when they are zero.
  *
- * @param timeZone IANA name or UTC offset
+ * @param timeZone IANA name or UTC offset: a time zone identifier (`+05:30`, `+0530`, `-08`) or a
+ *   stored offset (`±HH:MM[:SS]`, what `getTimeZoneOffset` returns)
  * @param instant ISO 8601 instant string (e.g. "2024-07-15T12:00:00Z")
- * @returns offset string (e.g. "-04:00"), or "" on invalid input
+ * @returns offset string (e.g. "+10:00"), or "" on invalid input
  *
- * @example getTimeZoneOffset("America/New_York", "2024-07-15T12:00:00Z") // "-04:00"
- * @example getTimeZoneOffset("America/New_York", "2024-01-15T12:00:00Z") // "-05:00"
+ * @example getTimeZoneOffset("Australia/Sydney", "2024-07-15T12:00:00Z") // "+10:00"
+ * @example getTimeZoneOffset("Australia/Sydney", "2024-01-15T12:00:00Z") // "+11:00"
  * @example getTimeZoneOffset("Asia/Kathmandu", "2024-01-15T12:00:00Z") // "+05:45"
+ * @example getTimeZoneOffset("Africa/Monrovia", "1970-01-01T12:00:00Z") // "-00:44:30" (an offset with seconds)
+ * @example getTimeZoneOffset("-00:44:30", "1970-01-01T12:00:00Z") // "-00:44:30" (its own result, read back)
+ * @example getTimeZoneOffset("+05:30:00", "1970-01-01T12:00:00Z") // "+05:30"
  * @example getTimeZoneOffset("Invalid/Zone", "2024-07-15T12:00:00Z") // ""
- * @example getTimeZoneOffset("America/New_York", "not an instant") // ""
- * @example getTimeZoneOffset("America/New_York", "2024-07-15T16:00:00z") // "" (lower-case z)
+ * @example getTimeZoneOffset("Africa/Johannesburg", "not an instant") // ""
+ * @example getTimeZoneOffset("Africa/Johannesburg", "2024-07-15T16:00:00z") // "" (lower-case z)
  * @example getTimeZoneOffset("UTC", "2016-12-31T23:59:60Z") // "" (leap second)
  * @example getTimeZoneOffset("UTC", "2016-12-31T23:59:60Z".replace(":60", ":59")) // "+00:00" (the clamped instant)
  */
@@ -39,13 +47,18 @@ export function getTimeZoneOffset(timeZone, instant) {
     if (typeof instant !== "string") {
         return "";
     }
-    if (!isValidTimeZone(timeZone) ||
+    const frame = zoneFrame(timeZone);
+    if (frame === null ||
         instantLeapSecond.test(instant) ||
         !hasInstantShape(instant)) {
         return "";
     }
     try {
-        return instantFrom(instant).toZonedDateTimeISO(timeZone).offset;
+        const at = instantFrom(instant);
+        // A stored offset with seconds is its own answer at every valid instant.
+        return frame.shiftNanoseconds !== 0n
+            ? frameOffset(frame)
+            : at.toZonedDateTimeISO(frame.timeZone).offset;
     }
     catch {
         return "";

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

@@ -6,7 +6,7 @@
  *
  * @returns array of IANA timezone identifier strings, or `[]` on failure
  *
- * @example getTimeZones() // ["America/New_York", "Europe/London", ...]
+ * @example getTimeZones() // ["Africa/Abidjan", "Africa/Accra", ...]
  * @example getTimeZones().length // ~422 (varies by runtime/ICU)
  */
 export declare function getTimeZones(): string[];

package/dist/zoned/get/getTimeZones.js

@@ -6,7 +6,7 @@
  *
  * @returns array of IANA timezone identifier strings, or `[]` on failure
  *
- * @example getTimeZones() // ["America/New_York", "Europe/London", ...]
+ * @example getTimeZones() // ["Africa/Abidjan", "Africa/Accra", ...]
  * @example getTimeZones().length // ~422 (varies by runtime/ICU)
  */
 export function getTimeZones() {

package/dist/zoned/get/getZonedDay.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 day string (zero-padded to 2 digits) or "" on invalid input
  *
- * @example getZonedDay("America/New_York") // "28"
+ * @example getZonedDay("Asia/Tokyo") // "29"
  * @example getZonedDay("invalid") // ""
  */
 export declare function getZonedDay(ianaTimezone: string): string;

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

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

@@ -5,10 +5,11 @@
  * - 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 declare function getZonedDayOfWeek(ianaTimezone: string): number | null;