@northguild/gmt 1.18.0 → 1.20.0

package/dist/utc/format/formatCalendarUtc.js

@@ -4,23 +4,28 @@ import { normalizeTimeZone } from "../../internal/normalizeTimeZone.js";
 import { toInstantFromUtc, toReferenceInstantFromUtc, } from "../../internal/toInstantFromUtc.js";
 import { isValidUtc } from "../validate/index.js";
 import { optionOrDefault } from "../../internal/optionOrDefault.js";
+import { isObject } from "../../internal/isObject.js";
 /**
  * Format a UTC ISO string as a relative day label plus time-of-day, e.g.
- * "Tomorrow at 2:30 PM" — the UTC counterpart of `formatCalendar`. See that
+ * "tomorrow at 14:30" — the UTC counterpart of `formatCalendar`. See that
  * function's JSDoc for the day-label/threshold/connector design; this
  * variant compares calendar days and renders the clock time in `timeZone`.
  *
  * - `options` must be an object or omitted: `null` returns `""`, as Temporal's GetOptionsObject
  *   rejects it.
+ * - An offset with seconds (`-00:44:30`) returns `""`. `Intl.DateTimeFormat` takes a time zone
+ *   identifier only: constructing one with an offset that has seconds throws (ECMA-402, the
+ *   `DateTimeFormat` construction step "If parseResult contains more than one MinuteSecond Parse
+ *   Node, throw a RangeError exception"). Pass the IANA name.
  *
  * @param value UTC ISO string to format
  * @param locale optional: BCP 47 locale tag, or a preference list of tags (ECMA-402)
  * @param options The reference instant, the time zone and the time style
  * @returns the formatted calendar string, or "" on invalid input
  *
- * @example formatCalendarUtc("2026-03-16T18:30:00Z", "en-US", { timeZone: "America/New_York", reference: "2026-03-15T13:00:00Z" }) // "tomorrow at 2:30 PM"
+ * @example formatCalendarUtc("2026-03-16T18:30:00Z", "en-GB", { timeZone: "Africa/Johannesburg", reference: "2026-03-15T13:00:00Z" }) // "tomorrow at 20:30"
  * @example formatCalendarUtc("2026-03-16T13:30:00Z", "fr-FR", { timeZone: "Europe/Paris", reference: "2026-03-15T12:00:00Z" }) // "demain à 14:30"
- * @example formatCalendarUtc("2026-03-16T18:30:00Z", "en-US", null as never) // ""
+ * @example formatCalendarUtc("2026-03-16T18:30:00Z", "hi-IN", null as never) // ""
  * @example formatCalendarUtc("not-a-date") // ""
  * @example formatCalendarUtc("2024-03-16T18:30:00Z", ["fr-FR", "en-US"], { reference: "2024-03-15T13:00:00Z" }) // "demain à 18:30"
  */
@@ -28,7 +33,7 @@ export function formatCalendarUtc(value, locale, options = {}) {
     try {
         // Temporal GetOptionsObject: undefined is defaults (the parameter default); anything else that is
         // not an object, including null, is a TypeError.
-        if (options === null || typeof options !== "object")
+        if (!isObject(options))
             return "";
         if (!isValidUtc(value))
             return "";

package/dist/utc/format/{formatHttp.d.ts → formatHttpDate.d.ts}

@@ -1,6 +1,6 @@
 /**
- * Format a UTC ISO 8601 datetime string as an RFC 9110 IMF-fixdate — the
- * fixed grammar HTTP headers like `Last-Modified`/`Date`/`Expires` require.
+ * Format a UTC ISO 8601 datetime string as an HTTP header date — the RFC 9110
+ * IMF-fixdate that headers like `Last-Modified`/`Date`/`Expires` require.
  *
  * - **Fixed grammar, not a display format.** RFC 9110 mandates English
  *   weekday/month abbreviations and a literal `GMT` suffix regardless of
@@ -19,10 +19,10 @@
  * @param value UTC ISO 8601 datetime string (e.g. "2024-03-15T14:30:00Z")
  * @returns RFC 9110 IMF-fixdate string, or "" on invalid input or a year outside 0000–9999
  *
- * @example formatHttp("2024-03-15T14:30:00Z") // "Fri, 15 Mar 2024 14:30:00 GMT"
- * @example formatHttp("2024-03-15T14:30:00.500Z") // "Fri, 15 Mar 2024 14:30:00 GMT"
- * @example formatHttp("-000001-06-15T12:00:00Z") // ""
+ * @example formatHttpDate("2024-03-15T14:30:00Z") // "Fri, 15 Mar 2024 14:30:00 GMT"
+ * @example formatHttpDate("2024-03-15T14:30:00.500Z") // "Fri, 15 Mar 2024 14:30:00 GMT"
+ * @example formatHttpDate("-000001-06-15T12:00:00Z") // ""
  * @example Temporal.Instant.from("-000001-06-15T12:00:00Z").toString() // "-000001-06-15T12:00:00Z"
- * @example formatHttp("invalid") // ""
+ * @example formatHttpDate("invalid") // ""
  */
-export declare function formatHttp(value: string): string;
+export declare function formatHttpDate(value: string): string;

package/dist/utc/format/{formatHttp.js → formatHttpDate.js}

@@ -1,9 +1,9 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { englishDateTimeStem } from "../../internal/englishCalendarNames.js";
 import { isValidUtc } from "../validate/index.js";
 /**
- * Format a UTC ISO 8601 datetime string as an RFC 9110 IMF-fixdate — the
- * fixed grammar HTTP headers like `Last-Modified`/`Date`/`Expires` require.
+ * Format a UTC ISO 8601 datetime string as an HTTP header date — the RFC 9110
+ * IMF-fixdate that headers like `Last-Modified`/`Date`/`Expires` require.
  *
  * - **Fixed grammar, not a display format.** RFC 9110 mandates English
  *   weekday/month abbreviations and a literal `GMT` suffix regardless of
@@ -22,13 +22,13 @@ import { isValidUtc } from "../validate/index.js";
  * @param value UTC ISO 8601 datetime string (e.g. "2024-03-15T14:30:00Z")
  * @returns RFC 9110 IMF-fixdate string, or "" on invalid input or a year outside 0000–9999
  *
- * @example formatHttp("2024-03-15T14:30:00Z") // "Fri, 15 Mar 2024 14:30:00 GMT"
- * @example formatHttp("2024-03-15T14:30:00.500Z") // "Fri, 15 Mar 2024 14:30:00 GMT"
- * @example formatHttp("-000001-06-15T12:00:00Z") // ""
+ * @example formatHttpDate("2024-03-15T14:30:00Z") // "Fri, 15 Mar 2024 14:30:00 GMT"
+ * @example formatHttpDate("2024-03-15T14:30:00.500Z") // "Fri, 15 Mar 2024 14:30:00 GMT"
+ * @example formatHttpDate("-000001-06-15T12:00:00Z") // ""
  * @example Temporal.Instant.from("-000001-06-15T12:00:00Z").toString() // "-000001-06-15T12:00:00Z"
- * @example formatHttp("invalid") // ""
+ * @example formatHttpDate("invalid") // ""
  */
-export function formatHttp(value) {
+export function formatHttpDate(value) {
     if (!isValidUtc(value))
         return "";
     try {

package/dist/utc/format/formatRelativeUtc.d.ts

@@ -20,9 +20,10 @@ export interface FormatRelativeUtcOptions extends RelativeTimeFormatOptions {
      */
     reference?: string;
     /**
-     * The time zone that anchors a calendar unit (week, month or year): an IANA name, a UTC offset,
-     * or `"local"` for the system time zone. An unknown zone returns `""` whatever the unit, as
-     * ECMA-402 throws RangeError for it.
+     * The time zone that anchors a calendar unit (week, month or year): 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
+     * `""` whatever the unit.
      *
      * @defaultValue `"UTC"`
      */
@@ -39,17 +40,24 @@ export interface FormatRelativeUtcOptions extends RelativeTimeFormatOptions {
  *   other value returns `""`.
  * - `options` must be an object or omitted: `null` returns `""`, as Temporal's GetOptionsObject
  *   rejects it.
+ * - **Limit at an offset with seconds.** A month or a year is measured from `reference`, placed in
+ *   the offset's whole-minute zone and moved by its seconds, and the moved instant must be inside
+ *   Temporal's range. So when one is measured and `reference` is 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 value UTC ISO string to format
  * @param locale optional: BCP 47 locale tag, or a preference list of tags (ECMA-402)
  * @param options The reference instant, the display unit, rounding, wording and time zone
  * @returns the formatted relative-time string, or "" on invalid input
  *
- * @example formatRelativeUtc("2026-01-15T14:30:45Z", "en-US", { reference: "2026-04-15T14:30:45Z" }) // "3 months ago"
- * @example formatRelativeUtc("2026-01-15T00:00:00Z", "en-US", { reference: "2026-01-15T10:30:00Z", roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
- * @example formatRelativeUtc("2026-01-15T00:00:00Z", "en-US", { reference: "2026-01-15T00:30:00Z", timeZone: "Invalid/Zone" }) // ""
- * @example formatRelativeUtc("2026-01-15T14:30:45Z", "en-US", null as never) // ""
+ * @example formatRelativeUtc("2026-01-15T14:30:45Z", "de-DE", { reference: "2026-04-15T14:30:45Z" }) // "vor 3 Monaten"
+ * @example formatRelativeUtc("2026-01-15T00:00:00Z", "en-GB", { reference: "2026-01-15T10:30:00Z", roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
+ * @example formatRelativeUtc("2026-01-15T00:00:00Z", "zh-CN", { reference: "2026-01-15T00:30:00Z", timeZone: "Invalid/Zone" }) // ""
+ * @example formatRelativeUtc("2026-01-15T14:30:45Z", "pt-BR", null as never) // ""
  * @example formatRelativeUtc("not-a-date") // ""
  * @example formatRelativeUtc("2024-03-15T11:30:00Z", ["fr-FR", "en-US"], { reference: "2024-03-15T12:00:00Z" }) // "il y a 30 minutes"
+ * @example formatRelativeUtc("1970-01-03T12:00:00Z", "en-GB", { reference: "1970-01-01T12:00:00Z", timeZone: "-00:44:30" }) // "in 2 days" (a stored offset with seconds)
  */
 export declare function formatRelativeUtc(value: string, locale?: string | string[], options?: FormatRelativeUtcOptions): string;

package/dist/utc/format/formatRelativeUtc.js

@@ -1,9 +1,10 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
 import { formatRelativeDuration } from "../../internal/formatRelativeDuration.js";
-import { normalizeTimeZone } from "../../internal/normalizeTimeZone.js";
+import { frameZoned, normalizeZoneFrame } from "../../internal/zoneFrame.js";
 import { toInstantFromUtc, toReferenceInstantFromUtc, } from "../../internal/toInstantFromUtc.js";
 import { durationTotal } from "../../internal/zonedWallClockDifference.js";
 import { isValidUtc } from "../validate/index.js";
+import { isObject } from "../../internal/isObject.js";
 /**
  * Format the relative time between a UTC ISO string and a reference instant.
  *
@@ -15,29 +16,36 @@ import { isValidUtc } from "../validate/index.js";
  *   other value returns `""`.
  * - `options` must be an object or omitted: `null` returns `""`, as Temporal's GetOptionsObject
  *   rejects it.
+ * - **Limit at an offset with seconds.** A month or a year is measured from `reference`, placed in
+ *   the offset's whole-minute zone and moved by its seconds, and the moved instant must be inside
+ *   Temporal's range. So when one is measured and `reference` is 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 value UTC ISO string to format
  * @param locale optional: BCP 47 locale tag, or a preference list of tags (ECMA-402)
  * @param options The reference instant, the display unit, rounding, wording and time zone
  * @returns the formatted relative-time string, or "" on invalid input
  *
- * @example formatRelativeUtc("2026-01-15T14:30:45Z", "en-US", { reference: "2026-04-15T14:30:45Z" }) // "3 months ago"
- * @example formatRelativeUtc("2026-01-15T00:00:00Z", "en-US", { reference: "2026-01-15T10:30:00Z", roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
- * @example formatRelativeUtc("2026-01-15T00:00:00Z", "en-US", { reference: "2026-01-15T00:30:00Z", timeZone: "Invalid/Zone" }) // ""
- * @example formatRelativeUtc("2026-01-15T14:30:45Z", "en-US", null as never) // ""
+ * @example formatRelativeUtc("2026-01-15T14:30:45Z", "de-DE", { reference: "2026-04-15T14:30:45Z" }) // "vor 3 Monaten"
+ * @example formatRelativeUtc("2026-01-15T00:00:00Z", "en-GB", { reference: "2026-01-15T10:30:00Z", roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
+ * @example formatRelativeUtc("2026-01-15T00:00:00Z", "zh-CN", { reference: "2026-01-15T00:30:00Z", timeZone: "Invalid/Zone" }) // ""
+ * @example formatRelativeUtc("2026-01-15T14:30:45Z", "pt-BR", null as never) // ""
  * @example formatRelativeUtc("not-a-date") // ""
  * @example formatRelativeUtc("2024-03-15T11:30:00Z", ["fr-FR", "en-US"], { reference: "2024-03-15T12:00:00Z" }) // "il y a 30 minutes"
+ * @example formatRelativeUtc("1970-01-03T12:00:00Z", "en-GB", { reference: "1970-01-01T12:00:00Z", timeZone: "-00:44:30" }) // "in 2 days" (a stored offset with seconds)
  */
 export function formatRelativeUtc(value, locale, options = {}) {
     try {
         // Temporal GetOptionsObject: undefined is defaults (the parameter default); anything else that is
         // not an object, including null, is a TypeError.
-        if (options === null || typeof options !== "object")
+        if (!isObject(options))
             return "";
         if (!isValidUtc(value))
             return "";
-        const tz = normalizeTimeZone(options.timeZone);
-        if (!tz)
+        const frame = normalizeZoneFrame(options.timeZone);
+        if (frame === null)
             return "";
         // Each option is read once (GetOption).
         const referenceOption = options.reference;
@@ -52,7 +60,7 @@ export function formatRelativeUtc(value, locale, options = {}) {
         try {
             const diff = target.since(reference);
             // Only a calendrical unit (month, year) reads the anchor, so the zone is applied lazily.
-            return formatRelativeDuration(diff, locale, options, (unit) => durationTotal(diff, unit, reference.toZonedDateTimeISO(tz)));
+            return formatRelativeDuration(diff, locale, options, (unit) => durationTotal(diff, unit, frameZoned(reference, frame)));
         }
         catch {
             return "";

package/dist/utc/format/formatUtc.d.ts

@@ -9,8 +9,9 @@
  */
 export interface FormatUtcOptions extends Intl.DateTimeFormatOptions {
     /**
-     * The time zone the value is rendered in: an IANA name, a UTC offset, or `"local"` for the system
-     * time zone. An unknown zone returns `""`, as ECMA-402 throws RangeError for it.
+     * The time zone the value is rendered in: an IANA name, a UTC offset to the minute (what
+     * `isValidTimeZone` accepts), or `"local"` for the system time zone. An unknown zone returns
+     * `""`, as ECMA-402 throws RangeError for it.
      *
      * @defaultValue `"UTC"`
      */
@@ -35,22 +36,26 @@ export interface FormatUtcOptions extends Intl.DateTimeFormatOptions {
  *   the `dateStyle` width, `era` alone dropped the time, and `timeZoneName` alone without
  *   `includeTimeZoneName` returned `""`. Pass the fields the old text showed to keep it.
  * - `options` null returns `""`, as ECMA-402's CoerceOptionsToObject rejects it.
+ * - An offset with seconds (`-00:44:30`) returns `""`. `Intl.DateTimeFormat` takes a time zone
+ *   identifier only: constructing one with an offset that has seconds throws (ECMA-402, the
+ *   `DateTimeFormat` construction step "If parseResult contains more than one MinuteSecond Parse
+ *   Node, throw a RangeError exception"). Pass the IANA name.
  *
  * @param value UTC ISO string to format
  * @param locale optional: BCP 47 locale tag, or a preference list of tags (ECMA-402)
  * @param options The time zone, the zone-name switch and any `Intl.DateTimeFormatOptions`
  * @returns the formatted date/time string, or "" on invalid input
  *
- * @example formatUtc("2026-03-16T18:30:00Z") // "3/16/2026, 6:30:00 PM"
- * @example formatUtc("2026-03-16T18:30:00Z", "en-US", { timeZone: "America/New_York" }) // "3/16/2026, 2:30:00 PM"
- * @example formatUtc("2026-03-16T18:30:00Z", "en-US", { timeZone: "America/New_York", includeTimeZoneName: true }) // "3/16/2026, 2:30:00 PM EDT"
+ * @example formatUtc("2026-03-16T18:30:00Z") // "3/16/2026, 6:30:00 PM" (varies by the runtime's default locale; shown for en-US)
+ * @example formatUtc("2026-03-16T18:30:00Z", "ja-JP", { timeZone: "Asia/Tokyo" }) // "2026/3/17 3:30:00"
+ * @example formatUtc("2026-03-16T18:30:00Z", "ja-JP", { timeZone: "Asia/Tokyo", includeTimeZoneName: true }) // "2026/3/17 3:30:00 JST"
  * @example formatUtc("2024-02-03T14:30:45Z", "ja-JP-u-ca-japanese", { year: "numeric", month: "long" }) // "令和6年2月"
  * @example formatUtc("2024-02-03T14:30:45Z", "ja-JP-u-ca-japanese", { year: "numeric", month: "numeric" }) // "R6/2" — the pre-1.16.0 text
- * @example formatUtc("2024-02-03T14:30:45Z", "en-US", { era: "long" }) // "2/3/2024 Anno Domini, 2:30:45 PM"
- * @example formatUtc("2024-02-03T14:30:45Z", "en-US", { era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "2/3/2024 Anno Domini" — the pre-1.16.0 text
- * @example formatUtc("2024-02-03T14:30:45Z", "en-US", { timeZoneName: "short" }) // "2/3/2024, 2:30:45 PM"
- * @example formatUtc("2024-02-03T14:30:45Z", "en-US", { timeZone: "Europe/Londn" }) // "" (unknown zone)
- * @example formatUtc("2024-02-03T14:30:45Z", "en-US", null as never) // "" (null options, as ECMA-402 rejects them)
+ * @example formatUtc("2024-02-03T14:30:45Z", "en-GB", { era: "long" }) // "03/02/2024 Anno Domini, 14:30:45"
+ * @example formatUtc("2024-02-03T14:30:45Z", "en-GB", { era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "03/02/2024 Anno Domini" — the pre-1.16.0 text
+ * @example formatUtc("2024-02-03T14:30:45Z", "de-DE", { timeZoneName: "short" }) // "3.2.2024, 14:30:45"
+ * @example formatUtc("2024-02-03T14:30:45Z", "zh-CN", { timeZone: "Europe/Londn" }) // "" (unknown zone)
+ * @example formatUtc("2024-02-03T14:30:45Z", "pt-BR", null as never) // "" (null options, as ECMA-402 rejects them)
  * @example formatUtc("not-a-date") // ""
  * @example formatUtc("2024-02-03T14:30:45Z", ["fr-FR", "en-US"], { dateStyle: "long" }) // "3 février 2024"
  */

package/dist/utc/format/formatUtc.js

@@ -17,22 +17,26 @@ import { optionOrDefault } from "../../internal/optionOrDefault.js";
  *   the `dateStyle` width, `era` alone dropped the time, and `timeZoneName` alone without
  *   `includeTimeZoneName` returned `""`. Pass the fields the old text showed to keep it.
  * - `options` null returns `""`, as ECMA-402's CoerceOptionsToObject rejects it.
+ * - An offset with seconds (`-00:44:30`) returns `""`. `Intl.DateTimeFormat` takes a time zone
+ *   identifier only: constructing one with an offset that has seconds throws (ECMA-402, the
+ *   `DateTimeFormat` construction step "If parseResult contains more than one MinuteSecond Parse
+ *   Node, throw a RangeError exception"). Pass the IANA name.
  *
  * @param value UTC ISO string to format
  * @param locale optional: BCP 47 locale tag, or a preference list of tags (ECMA-402)
  * @param options The time zone, the zone-name switch and any `Intl.DateTimeFormatOptions`
  * @returns the formatted date/time string, or "" on invalid input
  *
- * @example formatUtc("2026-03-16T18:30:00Z") // "3/16/2026, 6:30:00 PM"
- * @example formatUtc("2026-03-16T18:30:00Z", "en-US", { timeZone: "America/New_York" }) // "3/16/2026, 2:30:00 PM"
- * @example formatUtc("2026-03-16T18:30:00Z", "en-US", { timeZone: "America/New_York", includeTimeZoneName: true }) // "3/16/2026, 2:30:00 PM EDT"
+ * @example formatUtc("2026-03-16T18:30:00Z") // "3/16/2026, 6:30:00 PM" (varies by the runtime's default locale; shown for en-US)
+ * @example formatUtc("2026-03-16T18:30:00Z", "ja-JP", { timeZone: "Asia/Tokyo" }) // "2026/3/17 3:30:00"
+ * @example formatUtc("2026-03-16T18:30:00Z", "ja-JP", { timeZone: "Asia/Tokyo", includeTimeZoneName: true }) // "2026/3/17 3:30:00 JST"
  * @example formatUtc("2024-02-03T14:30:45Z", "ja-JP-u-ca-japanese", { year: "numeric", month: "long" }) // "令和6年2月"
  * @example formatUtc("2024-02-03T14:30:45Z", "ja-JP-u-ca-japanese", { year: "numeric", month: "numeric" }) // "R6/2" — the pre-1.16.0 text
- * @example formatUtc("2024-02-03T14:30:45Z", "en-US", { era: "long" }) // "2/3/2024 Anno Domini, 2:30:45 PM"
- * @example formatUtc("2024-02-03T14:30:45Z", "en-US", { era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "2/3/2024 Anno Domini" — the pre-1.16.0 text
- * @example formatUtc("2024-02-03T14:30:45Z", "en-US", { timeZoneName: "short" }) // "2/3/2024, 2:30:45 PM"
- * @example formatUtc("2024-02-03T14:30:45Z", "en-US", { timeZone: "Europe/Londn" }) // "" (unknown zone)
- * @example formatUtc("2024-02-03T14:30:45Z", "en-US", null as never) // "" (null options, as ECMA-402 rejects them)
+ * @example formatUtc("2024-02-03T14:30:45Z", "en-GB", { era: "long" }) // "03/02/2024 Anno Domini, 14:30:45"
+ * @example formatUtc("2024-02-03T14:30:45Z", "en-GB", { era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "03/02/2024 Anno Domini" — the pre-1.16.0 text
+ * @example formatUtc("2024-02-03T14:30:45Z", "de-DE", { timeZoneName: "short" }) // "3.2.2024, 14:30:45"
+ * @example formatUtc("2024-02-03T14:30:45Z", "zh-CN", { timeZone: "Europe/Londn" }) // "" (unknown zone)
+ * @example formatUtc("2024-02-03T14:30:45Z", "pt-BR", null as never) // "" (null options, as ECMA-402 rejects them)
  * @example formatUtc("not-a-date") // ""
  * @example formatUtc("2024-02-03T14:30:45Z", ["fr-FR", "en-US"], { dateStyle: "long" }) // "3 février 2024"
  */

package/dist/utc/format/index.d.ts

@@ -1,4 +1,4 @@
 export * from "./formatCalendarUtc.js";
-export * from "./formatHttp.js";
+export * from "./formatHttpDate.js";
 export * from "./formatRelativeUtc.js";
 export * from "./formatUtc.js";

package/dist/utc/format/index.js

@@ -1,4 +1,4 @@
 export * from "./formatCalendarUtc.js";
-export * from "./formatHttp.js";
+export * from "./formatHttpDate.js";
 export * from "./formatRelativeUtc.js";
 export * from "./formatUtc.js";

package/dist/utc/get/getUtcDay.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 day string (zero-padded to 2 digits) or "" on failure
+ * @returns current day string (zero-padded to 2 digits)
  *
  * @example getUtcDay() // "29"
- * @example getUtcDay() // "" (on failure)
  */
 export declare function getUtcDay(): string;

package/dist/utc/get/getUtcDay.js

@@ -1,24 +1,17 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current day from UTC as a zero-padded string.
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 2 digits.
- * - Returns "" on failure.
  *
- * @returns current day string (zero-padded to 2 digits) or "" on failure
+ * @returns current day string (zero-padded to 2 digits)
  *
  * @example getUtcDay() // "29"
- * @example getUtcDay() // "" (on failure)
  */
 export function getUtcDay() {
-    try {
-        return Temporal.Now.instant()
-            .toZonedDateTimeISO("UTC")
-            .day.toString()
-            .padStart(2, "0");
-    }
-    catch {
-        return "";
-    }
+    return Temporal.Now.instant()
+        .toZonedDateTimeISO("UTC")
+        .day.toString()
+        .padStart(2, "0");
 }

package/dist/utc/get/getUtcHour.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 hour string (zero-padded to 2 digits) or "" on failure
+ * @returns current hour string (zero-padded to 2 digits)
  *
  * @example getUtcHour() // "00"
- * @example getUtcHour() // "" (on failure)
  */
 export declare function getUtcHour(): string;

package/dist/utc/get/getUtcHour.js

@@ -1,24 +1,17 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current hour from UTC as a zero-padded string.
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 2 digits.
- * - Returns "" on failure.
  *
- * @returns current hour string (zero-padded to 2 digits) or "" on failure
+ * @returns current hour string (zero-padded to 2 digits)
  *
  * @example getUtcHour() // "00"
- * @example getUtcHour() // "" (on failure)
  */
 export function getUtcHour() {
-    try {
-        return Temporal.Now.instant()
-            .toZonedDateTimeISO("UTC")
-            .hour.toString()
-            .padStart(2, "0");
-    }
-    catch {
-        return "";
-    }
+    return Temporal.Now.instant()
+        .toZonedDateTimeISO("UTC")
+        .hour.toString()
+        .padStart(2, "0");
 }

package/dist/utc/get/getUtcMicrosecond.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 microsecond string (zero-padded to 3 digits) or "" on failure
+ * @returns current microsecond string (zero-padded to 3 digits)
  *
  * @example getUtcMicrosecond() // "456"
- * @example getUtcMicrosecond() // "" (on failure)
  */
 export declare function getUtcMicrosecond(): string;

package/dist/utc/get/getUtcMicrosecond.js

@@ -1,23 +1,16 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current microsecond from UTC as a zero-padded string.
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 3 digits.
- * - Returns "" on failure.
  *
- * @returns current microsecond string (zero-padded to 3 digits) or "" on failure
+ * @returns current microsecond string (zero-padded to 3 digits)
  *
  * @example getUtcMicrosecond() // "456"
- * @example getUtcMicrosecond() // "" (on failure)
  */
 export function getUtcMicrosecond() {
-    try {
-        return (Temporal.Now.instant().toZonedDateTimeISO("UTC").microsecond ?? 0)
-            .toString()
-            .padStart(3, "0");
-    }
-    catch {
-        return "";
-    }
+    return (Temporal.Now.instant().toZonedDateTimeISO("UTC").microsecond ?? 0)
+        .toString()
+        .padStart(3, "0");
 }

package/dist/utc/get/getUtcMillisecond.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 millisecond string (zero-padded to 3 digits) or "" on failure
+ * @returns current millisecond string (zero-padded to 3 digits)
  *
  * @example getUtcMillisecond() // "123"
- * @example getUtcMillisecond() // "" (on failure)
  */
 export declare function getUtcMillisecond(): string;

package/dist/utc/get/getUtcMillisecond.js

@@ -1,24 +1,17 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current millisecond from UTC as a zero-padded string.
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 3 digits.
- * - Returns "" on failure.
  *
- * @returns current millisecond string (zero-padded to 3 digits) or "" on failure
+ * @returns current millisecond string (zero-padded to 3 digits)
  *
  * @example getUtcMillisecond() // "123"
- * @example getUtcMillisecond() // "" (on failure)
  */
 export function getUtcMillisecond() {
-    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/utc/get/getUtcMinute.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 getUtcMinute() // "30"
- * @example getUtcMinute() // "" (on failure)
  */
 export declare function getUtcMinute(): string;

package/dist/utc/get/getUtcMinute.js

@@ -1,24 +1,17 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current minute from UTC as a zero-padded string.
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 2 digits.
- * - Returns "" on failure.
  *
- * @returns current minute string (zero-padded to 2 digits) or "" on failure
+ * @returns current minute string (zero-padded to 2 digits)
  *
  * @example getUtcMinute() // "30"
- * @example getUtcMinute() // "" (on failure)
  */
 export function getUtcMinute() {
-    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/utc/get/getUtcMonth.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 getUtcMonth() // "02"
- * @example getUtcMonth() // "" (on failure)
  */
 export declare function getUtcMonth(): string;

package/dist/utc/get/getUtcMonth.js

@@ -1,24 +1,17 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current month from UTC as a zero-padded string.
  *
  * - Uses Temporal.Now.instant() converted to UTC zoned date time.
  * - Returns zero-padded string to 2 digits.
- * - Returns "" on failure.
  *
- * @returns current month string (zero-padded to 2 digits) or "" on failure
+ * @returns current month string (zero-padded to 2 digits)
  *
  * @example getUtcMonth() // "02"
- * @example getUtcMonth() // "" (on failure)
  */
 export function getUtcMonth() {
-    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/utc/get/getUtcNanosecond.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 getUtcNanosecond() // "789"
- * @example getUtcNanosecond() // "" (on failure)
  */
 export declare function getUtcNanosecond(): string;