@northguild/gmt 1.14.2

package/dist/utc/convert/convertUtcToUnix.d.ts

@@ -0,0 +1,17 @@
+import { type UnixUnit } from "../../unix/validate/isValidUnixUnit.js";
+/**
+ * Convert a UTC Instant string to a unix epoch value in milliseconds or seconds.
+ *
+ * - Uses Temporal.Instant.from to parse.
+ * - Validates unit ("seconds" | "milliseconds").
+ * - Returns null for invalid input.
+ *
+ * @param value UTC Instant string
+ * @param unit optional unit, "seconds" or "milliseconds"
+ * @returns epoch number or null on invalid
+ *
+ * @example convertUtcToUnix("2024-02-29T00:00:00Z") // 1709164800000
+ * @example convertUtcToUnix("2024-02-29T00:00:00Z", "seconds") // 1709164800
+ * @example convertUtcToUnix("invalid") // null
+ */
+export declare function convertUtcToUnix(value: string, ...unitInput: [unit?: UnixUnit]): number | null;

package/dist/utc/convert/convertUtcToUnix.js

@@ -0,0 +1,33 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidUnixUnit, } from "../../unix/validate/isValidUnixUnit.js";
+import { isValidUtc } from "../validate/index.js";
+/**
+ * Convert a UTC Instant string to a unix epoch value in milliseconds or seconds.
+ *
+ * - Uses Temporal.Instant.from to parse.
+ * - Validates unit ("seconds" | "milliseconds").
+ * - Returns null for invalid input.
+ *
+ * @param value UTC Instant string
+ * @param unit optional unit, "seconds" or "milliseconds"
+ * @returns epoch number or null on invalid
+ *
+ * @example convertUtcToUnix("2024-02-29T00:00:00Z") // 1709164800000
+ * @example convertUtcToUnix("2024-02-29T00:00:00Z", "seconds") // 1709164800
+ * @example convertUtcToUnix("invalid") // null
+ */
+export function convertUtcToUnix(value, ...unitInput) {
+    const resolvedUnit = unitInput.length === 0 ? "milliseconds" : unitInput[0];
+    if (!isValidUtc(value) || !isValidUnixUnit(resolvedUnit ?? "")) {
+        return null;
+    }
+    try {
+        const milliseconds = Number(Temporal.Instant.from(value).epochMilliseconds);
+        return resolvedUnit === "seconds"
+            ? Math.floor(milliseconds / 1000)
+            : milliseconds;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/utc/convert/convertUtcToZoned.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Convert a UTC Instant string to a zoned ISO 8601 datetime string.
+ *
+ * - Uses Temporal.Instant.from to parse, converts to specified timezone.
+ * - Validates both UTC input and timezone.
+ * - Returns "" for invalid input.
+ *
+ * @param value UTC Instant string
+ * @param timeZone IANA timeZone identifier
+ * @returns zoned ISO 8601 string or "" on invalid
+ *
+ * @example convertUtcToZoned("2024-02-29T00:00:00Z", "America/New_York") // "2024-02-28T19:00:00-05:00[America/New_York]"
+ * @example convertUtcToZoned("invalid", "UTC") // ""
+ */
+export declare function convertUtcToZoned(value: string, timeZone: string): string;

package/dist/utc/convert/convertUtcToZoned.js

@@ -0,0 +1,28 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidTimeZone } from "../../zoned/validate/index.js";
+import { isValidUtc } from "../validate/index.js";
+/**
+ * Convert a UTC Instant string to a zoned ISO 8601 datetime string.
+ *
+ * - Uses Temporal.Instant.from to parse, converts to specified timezone.
+ * - Validates both UTC input and timezone.
+ * - Returns "" for invalid input.
+ *
+ * @param value UTC Instant string
+ * @param timeZone IANA timeZone identifier
+ * @returns zoned ISO 8601 string or "" on invalid
+ *
+ * @example convertUtcToZoned("2024-02-29T00:00:00Z", "America/New_York") // "2024-02-28T19:00:00-05:00[America/New_York]"
+ * @example convertUtcToZoned("invalid", "UTC") // ""
+ */
+export function convertUtcToZoned(value, timeZone) {
+    if (!isValidUtc(value) || !isValidTimeZone(timeZone)) {
+        return "";
+    }
+    try {
+        return Temporal.Instant.from(value).toZonedDateTimeISO(timeZone).toString();
+    }
+    catch {
+        return "";
+    }
+}

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

@@ -0,0 +1,5 @@
+export * from "./convertUtcToPlainDate.js";
+export * from "./convertUtcToPlainDateTime.js";
+export * from "./convertUtcToPlainTime.js";
+export * from "./convertUtcToUnix.js";
+export * from "./convertUtcToZoned.js";

package/dist/utc/convert/index.js

@@ -0,0 +1,5 @@
+export * from "./convertUtcToPlainDate.js";
+export * from "./convertUtcToPlainDateTime.js";
+export * from "./convertUtcToPlainTime.js";
+export * from "./convertUtcToUnix.js";
+export * from "./convertUtcToZoned.js";

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

@@ -0,0 +1,28 @@
+export interface FormatCalendarUtcOptions {
+    reference?: string;
+    /**
+     * IANA timezone used for both the calendar-day comparison and the
+     * rendered clock time. Resolved via `normalizeTimeZone` — `"local"` for
+     * the system zone, an invalid/omitted value falls back to `"UTC"`.
+     */
+    timeZone?: string;
+    /** `Intl.DateTimeFormatOptions` `timeStyle` for the time-of-day half. */
+    timeStyle?: "short" | "medium" | "full";
+}
+/**
+ * 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
+ * function's JSDoc for the day-label/threshold/connector design; this
+ * variant compares calendar days and renders the clock time in `timeZone`
+ * (default `"UTC"`).
+ *
+ * @param value UTC ISO string to format
+ * @param locale optional: BCP 47 locale tag
+ * @param options optional: { reference, timeZone, timeStyle }
+ * @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(value, "fr-FR", { timeZone: "Europe/Paris" }) // "demain à 14:30"
+ * @example formatCalendarUtc("not-a-date") // ""
+ */
+export declare function formatCalendarUtc(value: string, locale?: string, options?: FormatCalendarUtcOptions): string;

package/dist/utc/format/formatCalendarUtc.js

@@ -0,0 +1,68 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { joinDateTimeConnector, normalizeDateTime } from "../../internal/index.js";
+import { normalizeTimeZone } from "../../internal/normalizeTimeZone.js";
+import { toInstantFromUtc } from "../../internal/toInstantFromUtc.js";
+import { isValidUtc } from "../validate/index.js";
+const ABS_DAY_THRESHOLD = 6;
+/**
+ * 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
+ * function's JSDoc for the day-label/threshold/connector design; this
+ * variant compares calendar days and renders the clock time in `timeZone`
+ * (default `"UTC"`).
+ *
+ * @param value UTC ISO string to format
+ * @param locale optional: BCP 47 locale tag
+ * @param options optional: { reference, timeZone, timeStyle }
+ * @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(value, "fr-FR", { timeZone: "Europe/Paris" }) // "demain à 14:30"
+ * @example formatCalendarUtc("not-a-date") // ""
+ */
+export function formatCalendarUtc(value, locale, options = {}) {
+    if (!isValidUtc(value))
+        return "";
+    if (options.reference !== undefined && !isValidUtc(options.reference))
+        return "";
+    const target = toInstantFromUtc(value);
+    if (target === null)
+        return "";
+    let reference;
+    if (options.reference) {
+        const ref = toInstantFromUtc(options.reference);
+        if (ref === null)
+            return "";
+        reference = ref;
+    }
+    else {
+        try {
+            reference = Temporal.Now.instant();
+        }
+        catch {
+            return "";
+        }
+    }
+    try {
+        const timeZone = normalizeTimeZone(options.timeZone);
+        const timeStyle = options.timeStyle ?? "short";
+        const targetDate = target.toZonedDateTimeISO(timeZone).toPlainDate();
+        const referenceDate = reference.toZonedDateTimeISO(timeZone).toPlainDate();
+        const diffDays = targetDate.since(referenceDate).days;
+        const epochMilliseconds = Number(target.epochMilliseconds);
+        if (Math.abs(diffDays) > ABS_DAY_THRESHOLD) {
+            return normalizeDateTime(new Intl.DateTimeFormat(locale, {
+                dateStyle: "long",
+                timeStyle,
+                timeZone,
+            }).format(epochMilliseconds));
+        }
+        const dayLabel = new Intl.RelativeTimeFormat(locale, {
+            numeric: "auto",
+        }).format(diffDays, "day");
+        return normalizeDateTime(joinDateTimeConnector(epochMilliseconds, timeZone, locale, dayLabel, timeStyle));
+    }
+    catch {
+        return "";
+    }
+}

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

@@ -0,0 +1,22 @@
+/**
+ * Format a UTC ISO 8601 datetime string as an RFC 7231 IMF-fixdate — the
+ * fixed grammar HTTP headers like `Last-Modified`/`Date`/`Expires` require.
+ *
+ * - **Fixed grammar, not a display format.** RFC 7231 mandates English
+ *   weekday/month abbreviations and a literal `GMT` suffix regardless of
+ *   caller locale — there is no locale-appropriate alternative ordering to
+ *   lose (see roadmap `issues/J.md` Decision 1 / J13).
+ * - Always `GMT`; HTTP-date carries no offset variation to preserve.
+ * - Fractional seconds in `value` are truncated — IMF-fixdate has no
+ *   sub-second field.
+ * - Day, hour, minute, and second are always zero-padded to 2 digits; year
+ *   is zero-padded to 4 digits.
+ *
+ * @param value UTC ISO 8601 datetime string (e.g. "2024-03-15T14:30:00Z")
+ * @returns RFC 7231 IMF-fixdate string, or "" on invalid input
+ *
+ * @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("invalid") // ""
+ */
+export declare function formatHttp(value: string): string;

package/dist/utc/format/formatHttp.js

@@ -0,0 +1,42 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { ENGLISH_MONTH_NAMES, ENGLISH_WEEKDAY_NAMES } from "../../internal/index.js";
+import { isValidUtc } from "../validate/index.js";
+/**
+ * Format a UTC ISO 8601 datetime string as an RFC 7231 IMF-fixdate — the
+ * fixed grammar HTTP headers like `Last-Modified`/`Date`/`Expires` require.
+ *
+ * - **Fixed grammar, not a display format.** RFC 7231 mandates English
+ *   weekday/month abbreviations and a literal `GMT` suffix regardless of
+ *   caller locale — there is no locale-appropriate alternative ordering to
+ *   lose (see roadmap `issues/J.md` Decision 1 / J13).
+ * - Always `GMT`; HTTP-date carries no offset variation to preserve.
+ * - Fractional seconds in `value` are truncated — IMF-fixdate has no
+ *   sub-second field.
+ * - Day, hour, minute, and second are always zero-padded to 2 digits; year
+ *   is zero-padded to 4 digits.
+ *
+ * @param value UTC ISO 8601 datetime string (e.g. "2024-03-15T14:30:00Z")
+ * @returns RFC 7231 IMF-fixdate string, or "" on invalid input
+ *
+ * @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("invalid") // ""
+ */
+export function formatHttp(value) {
+    if (!isValidUtc(value))
+        return "";
+    try {
+        const zdt = Temporal.Instant.from(value).toZonedDateTimeISO("UTC");
+        const weekday = ENGLISH_WEEKDAY_NAMES[zdt.dayOfWeek - 1];
+        const day = String(zdt.day).padStart(2, "0");
+        const month = ENGLISH_MONTH_NAMES[zdt.month - 1];
+        const year = String(zdt.year).padStart(4, "0");
+        const hour = String(zdt.hour).padStart(2, "0");
+        const minute = String(zdt.minute).padStart(2, "0");
+        const second = String(zdt.second).padStart(2, "0");
+        return `${weekday}, ${day} ${month} ${year} ${hour}:${minute}:${second} GMT`;
+    }
+    catch {
+        return "";
+    }
+}

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

@@ -0,0 +1,33 @@
+import type { RelativeRoundingMethod } from "../../types/index.js";
+type RelativeUnit = "year" | "month" | "week" | "day" | "hour" | "minute" | "second";
+export interface FormatRelativeUtcOptions {
+    style?: "long" | "short" | "narrow";
+    numeric?: "always" | "auto";
+    largestUnit?: RelativeUnit;
+    /**
+     * How the computed distance rounds to the display unit: "floor" rounds toward the
+     * earlier boundary, "ceil" toward the later boundary, "round" (default) to the nearest —
+     * matches current behavior when omitted.
+     */
+    roundingMethod?: RelativeRoundingMethod;
+    reference?: string;
+    timeZone?: string;
+}
+/**
+ * Format the relative time between a UTC ISO string and a reference instant.
+ *
+ * - Auto-picks the display unit (second through year) based on the distance, unless
+ *   `largestUnit` forces one.
+ * - `roundingMethod` controls how the distance rounds to the display unit.
+ *
+ * @param value UTC ISO string to format
+ * @param locale optional: BCP 47 locale tag
+ * @param options optional: { style, numeric, largestUnit, roundingMethod, reference, timeZone }
+ * @returns the formatted relative-time string, or "" on invalid input
+ *
+ * @example formatRelativeUtc("2024-03-17T14:30:45+00:00[UTC]", "en-US") // "2 years ago"
+ * @example formatRelativeUtc(value, "en-US", { roundingMethod: "floor" }) // rounds toward the earlier boundary
+ * @example formatRelativeUtc("not-a-date") // ""
+ */
+export declare function formatRelativeUtc(value: string, locale?: string, options?: FormatRelativeUtcOptions): string;
+export {};

package/dist/utc/format/formatRelativeUtc.js

@@ -0,0 +1,76 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { normalizeDateTime } from "../../internal/normalizeDateTime.js";
+import { normalizeTimeZone } from "../../internal/normalizeTimeZone.js";
+import { resolveRelativeRounding } from "../../internal/resolveRelativeRounding.js";
+import { toInstantFromUtc } from "../../internal/toInstantFromUtc.js";
+import { isValidUtc } from "../validate/index.js";
+const AUTO_UNITS = [
+    { unit: "second", maxSeconds: 60 },
+    { unit: "minute", maxSeconds: 3_600 },
+    { unit: "hour", maxSeconds: 86_400 },
+    { unit: "day", maxSeconds: Infinity },
+];
+/**
+ * Format the relative time between a UTC ISO string and a reference instant.
+ *
+ * - Auto-picks the display unit (second through year) based on the distance, unless
+ *   `largestUnit` forces one.
+ * - `roundingMethod` controls how the distance rounds to the display unit.
+ *
+ * @param value UTC ISO string to format
+ * @param locale optional: BCP 47 locale tag
+ * @param options optional: { style, numeric, largestUnit, roundingMethod, reference, timeZone }
+ * @returns the formatted relative-time string, or "" on invalid input
+ *
+ * @example formatRelativeUtc("2024-03-17T14:30:45+00:00[UTC]", "en-US") // "2 years ago"
+ * @example formatRelativeUtc(value, "en-US", { roundingMethod: "floor" }) // rounds toward the earlier boundary
+ * @example formatRelativeUtc("not-a-date") // ""
+ */
+export function formatRelativeUtc(value, locale, options = {}) {
+    if (!isValidUtc(value))
+        return "";
+    if (options.reference !== undefined && !isValidUtc(options.reference))
+        return "";
+    const target = toInstantFromUtc(value);
+    if (target === null)
+        return "";
+    let reference;
+    if (options.reference) {
+        const ref = toInstantFromUtc(options.reference);
+        if (ref === null)
+            return "";
+        reference = ref;
+    }
+    else {
+        try {
+            reference = Temporal.Now.instant();
+        }
+        catch {
+            return "";
+        }
+    }
+    try {
+        const diff = target.since(reference);
+        const absSeconds = Math.abs(diff.total("second"));
+        const unit = options.largestUnit ??
+            AUTO_UNITS.find((t) => absSeconds < t.maxSeconds)?.unit ??
+            "day";
+        let amount;
+        try {
+            amount = resolveRelativeRounding(diff.total(unit), options.roundingMethod);
+        }
+        catch {
+            // month/year are calendrical and need a relativeTo anchor.
+            // Defer timezone normalization until we know we need it.
+            const tz = normalizeTimeZone(options.timeZone);
+            amount = resolveRelativeRounding(diff.total({ unit, relativeTo: reference.toZonedDateTimeISO(tz) }), options.roundingMethod);
+        }
+        return normalizeDateTime(new Intl.RelativeTimeFormat(locale, {
+            numeric: options.numeric ?? "auto",
+            style: options.style ?? "long",
+        }).format(amount, unit));
+    }
+    catch {
+        return "";
+    }
+}

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

@@ -0,0 +1,5 @@
+export interface FormatUtcOptions extends Intl.DateTimeFormatOptions {
+    timeZone?: string;
+    includeTimeZoneName?: boolean;
+}
+export declare function formatUtc(value: string, locale?: string, options?: FormatUtcOptions): string;

package/dist/utc/format/formatUtc.js

@@ -0,0 +1,23 @@
+import { normalizeDateTime } from "../../internal/normalizeDateTime.js";
+import { normalizeTimeZone } from "../../internal/normalizeTimeZone.js";
+import { toInstantFromUtc } from "../../internal/toInstantFromUtc.js";
+import { isValidUtc } from "../validate/index.js";
+export function formatUtc(value, locale, options) {
+    if (!isValidUtc(value))
+        return "";
+    const { timeZone, includeTimeZoneName = false, ...intlOptions } = options ?? {};
+    const instant = toInstantFromUtc(value);
+    if (instant === null)
+        return "";
+    try {
+        const tz = normalizeTimeZone(timeZone);
+        const zdt = instant.toZonedDateTimeISO(tz);
+        const out = includeTimeZoneName
+            ? zdt.toLocaleString(locale, intlOptions)
+            : zdt.toPlainDateTime().toLocaleString(locale, intlOptions);
+        return normalizeDateTime(out);
+    }
+    catch {
+        return "";
+    }
+}

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

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

package/dist/utc/format/index.js

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

package/dist/utc/get/getUtcDay.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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
+ *
+ * @example getUtcDay() // "29"
+ * @example getUtcDay() // "" (on failure)
+ */
+export declare function getUtcDay(): string;

package/dist/utc/get/getUtcDay.js

@@ -0,0 +1,24 @@
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * 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
+ *
+ * @example getUtcDay() // "29"
+ * @example getUtcDay() // "" (on failure)
+ */
+export function getUtcDay() {
+    try {
+        return Temporal.Now.instant()
+            .toZonedDateTimeISO("UTC")
+            .day.toString()
+            .padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/utc/get/getUtcHour.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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
+ *
+ * @example getUtcHour() // "00"
+ * @example getUtcHour() // "" (on failure)
+ */
+export declare function getUtcHour(): string;

package/dist/utc/get/getUtcHour.js

@@ -0,0 +1,24 @@
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * 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
+ *
+ * @example getUtcHour() // "00"
+ * @example getUtcHour() // "" (on failure)
+ */
+export function getUtcHour() {
+    try {
+        return Temporal.Now.instant()
+            .toZonedDateTimeISO("UTC")
+            .hour.toString()
+            .padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/utc/get/getUtcMicrosecond.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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
+ *
+ * @example getUtcMicrosecond() // "456"
+ * @example getUtcMicrosecond() // "" (on failure)
+ */
+export declare function getUtcMicrosecond(): string;

package/dist/utc/get/getUtcMicrosecond.js

@@ -0,0 +1,23 @@
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * 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
+ *
+ * @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 "";
+    }
+}

package/dist/utc/get/getUtcMillisecond.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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
+ *
+ * @example getUtcMillisecond() // "123"
+ * @example getUtcMillisecond() // "" (on failure)
+ */
+export declare function getUtcMillisecond(): string;

package/dist/utc/get/getUtcMillisecond.js

@@ -0,0 +1,24 @@
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * 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
+ *
+ * @example getUtcMillisecond() // "123"
+ * @example getUtcMillisecond() // "" (on failure)
+ */
+export function getUtcMillisecond() {
+    try {
+        return Temporal.Now.instant()
+            .toZonedDateTimeISO("UTC")
+            .millisecond.toString()
+            .padStart(3, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/utc/get/getUtcMinute.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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
+ *
+ * @example getUtcMinute() // "30"
+ * @example getUtcMinute() // "" (on failure)
+ */
+export declare function getUtcMinute(): string;

package/dist/utc/get/getUtcMinute.js

@@ -0,0 +1,24 @@
+import { Temporal } from "@js-temporal/polyfill";
+/**
+ * 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
+ *
+ * @example getUtcMinute() // "30"
+ * @example getUtcMinute() // "" (on failure)
+ */
+export function getUtcMinute() {
+    try {
+        return Temporal.Now.instant()
+            .toZonedDateTimeISO("UTC")
+            .minute.toString()
+            .padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/utc/get/getUtcMonth.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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
+ *
+ * @example getUtcMonth() // "02"
+ * @example getUtcMonth() // "" (on failure)
+ */
+export declare function getUtcMonth(): string;