@northguild/gmt 1.14.2

package/dist/plain/format/formatRelativeTime.d.ts

@@ -0,0 +1,32 @@
+import type { RelativeRoundingMethod } from "../../types/index.js";
+type RelativeUnit = "hour" | "minute" | "second";
+export interface FormatRelativeTimeOptions {
+    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;
+}
+/**
+ * Format the relative time between a plain time and a reference time.
+ *
+ * - Auto-picks the display unit (second/minute/hour) based on the distance, unless
+ *   `largestUnit` forces one.
+ * - `roundingMethod` controls how the distance rounds to the display unit.
+ *
+ * @param value ISO time string to format
+ * @param locale optional: BCP 47 locale tag
+ * @param options optional: { style, numeric, largestUnit, roundingMethod, reference }
+ * @returns the formatted relative-time string, or "" on invalid input
+ *
+ * @example formatRelativeTime("14:30:00", "en-US", { style: "short" }) // "2 hr. ago"
+ * @example formatRelativeTime(value, "en-US", { roundingMethod: "floor" }) // rounds toward the earlier boundary
+ * @example formatRelativeTime("not-a-time") // ""
+ */
+export declare function formatRelativeTime(value: string, locale?: string, options?: FormatRelativeTimeOptions): string;
+export {};

package/dist/plain/format/formatRelativeTime.js

@@ -0,0 +1,49 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { normalizeDateTime, resolveRelativeRounding } from "../../internal/index.js";
+import { isValidTime } from "../validate/index.js";
+const AUTO_UNITS = [
+    { unit: "second", maxSeconds: 60 },
+    { unit: "minute", maxSeconds: 3_600 },
+    { unit: "hour", maxSeconds: Infinity },
+];
+/**
+ * Format the relative time between a plain time and a reference time.
+ *
+ * - Auto-picks the display unit (second/minute/hour) based on the distance, unless
+ *   `largestUnit` forces one.
+ * - `roundingMethod` controls how the distance rounds to the display unit.
+ *
+ * @param value ISO time string to format
+ * @param locale optional: BCP 47 locale tag
+ * @param options optional: { style, numeric, largestUnit, roundingMethod, reference }
+ * @returns the formatted relative-time string, or "" on invalid input
+ *
+ * @example formatRelativeTime("14:30:00", "en-US", { style: "short" }) // "2 hr. ago"
+ * @example formatRelativeTime(value, "en-US", { roundingMethod: "floor" }) // rounds toward the earlier boundary
+ * @example formatRelativeTime("not-a-time") // ""
+ */
+export function formatRelativeTime(value, locale, options = {}) {
+    if (!isValidTime(value))
+        return "";
+    if (options.reference !== undefined && !isValidTime(options.reference))
+        return "";
+    try {
+        const target = Temporal.PlainTime.from(value);
+        const reference = options.reference
+            ? Temporal.PlainTime.from(options.reference)
+            : Temporal.Now.plainTimeISO();
+        const diff = target.since(reference);
+        const absSeconds = Math.abs(diff.total("second"));
+        const unit = options.largestUnit ??
+            AUTO_UNITS.find((t) => absSeconds < t.maxSeconds)?.unit ??
+            "hour";
+        const amount = resolveRelativeRounding(diff.total(unit), options.roundingMethod);
+        return normalizeDateTime(new Intl.RelativeTimeFormat(locale, {
+            numeric: options.numeric ?? "auto",
+            style: options.style ?? "long",
+        }).format(amount, unit));
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/format/formatSql.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Format a plain ISO 8601 datetime string as an ANSI SQL / ODBC datetime
+ * literal — the `YYYY-MM-DD HH:MM:SS` form MySQL, SQLite, and standard SQL
+ * `DATETIME`/`TIMESTAMP` columns (without a time zone) accept.
+ *
+ * - **Plain only.** SQL's offset-carrying `TIMESTAMPTZ` literal
+ *   (`YYYY-MM-DD HH:MM:SS±HH:MM`, e.g. PostgreSQL) is out of scope — this
+ *   targets the far more common tz-less `DATETIME` column shape. There is no
+ *   zoned counterpart in this story.
+ * - The only change from GMT's own ISO output is the separator: `T` becomes
+ *   a single space. Fractional seconds, when present, are preserved as-is.
+ *
+ * @param value plain ISO 8601 datetime string (e.g. "2024-03-15T14:30:00")
+ * @returns SQL datetime literal, or "" on invalid input
+ *
+ * @example formatSql("2024-03-15T14:30:00") // "2024-03-15 14:30:00"
+ * @example formatSql("2024-03-15T14:30:00.500") // "2024-03-15 14:30:00.5"
+ * @example formatSql("invalid") // ""
+ */
+export declare function formatSql(value: string): string;

package/dist/plain/format/formatSql.js

@@ -0,0 +1,31 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { isValidDateTime } from "../validate/index.js";
+/**
+ * Format a plain ISO 8601 datetime string as an ANSI SQL / ODBC datetime
+ * literal — the `YYYY-MM-DD HH:MM:SS` form MySQL, SQLite, and standard SQL
+ * `DATETIME`/`TIMESTAMP` columns (without a time zone) accept.
+ *
+ * - **Plain only.** SQL's offset-carrying `TIMESTAMPTZ` literal
+ *   (`YYYY-MM-DD HH:MM:SS±HH:MM`, e.g. PostgreSQL) is out of scope — this
+ *   targets the far more common tz-less `DATETIME` column shape. There is no
+ *   zoned counterpart in this story.
+ * - The only change from GMT's own ISO output is the separator: `T` becomes
+ *   a single space. Fractional seconds, when present, are preserved as-is.
+ *
+ * @param value plain ISO 8601 datetime string (e.g. "2024-03-15T14:30:00")
+ * @returns SQL datetime literal, or "" on invalid input
+ *
+ * @example formatSql("2024-03-15T14:30:00") // "2024-03-15 14:30:00"
+ * @example formatSql("2024-03-15T14:30:00.500") // "2024-03-15 14:30:00.5"
+ * @example formatSql("invalid") // ""
+ */
+export function formatSql(value) {
+    if (!isValidDateTime(value))
+        return "";
+    try {
+        return Temporal.PlainDateTime.from(value).toString().replace("T", " ");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/format/formatTime.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Return a localized string for a PlainTime ISO input using Intl options.
+ *
+ * - Uses Temporal.PlainTime.toLocaleString for formatting.
+ * - Accepts optional BCP 47 locale and Intl.DateTimeFormatOptions.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO PlainTime string
+ * @param locale optional BCP 47 locale identifier
+ * @param options optional Intl.DateTimeFormatOptions
+ * @returns localized time string or "" on invalid input
+ *
+ * @example formatTime("14:30:00", "en-US", { timeStyle: "short" }) // "2:30 PM"
+ * @example formatTime("14:30:00", "de-DE", { timeStyle: "short" }) // "14:30"
+ * @example formatTime("invalid") // ""
+ */
+export declare function formatTime(value: string, locale?: string, options?: Intl.DateTimeFormatOptions): string;

package/dist/plain/format/formatTime.js

@@ -0,0 +1,31 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { normalizeDateTime } from "../../internal/index.js";
+import { isValidTime } from "../validate/index.js";
+/**
+ * Return a localized string for a PlainTime ISO input using Intl options.
+ *
+ * - Uses Temporal.PlainTime.toLocaleString for formatting.
+ * - Accepts optional BCP 47 locale and Intl.DateTimeFormatOptions.
+ * - Returns "" for invalid input.
+ *
+ * @param value ISO PlainTime string
+ * @param locale optional BCP 47 locale identifier
+ * @param options optional Intl.DateTimeFormatOptions
+ * @returns localized time string or "" on invalid input
+ *
+ * @example formatTime("14:30:00", "en-US", { timeStyle: "short" }) // "2:30 PM"
+ * @example formatTime("14:30:00", "de-DE", { timeStyle: "short" }) // "14:30"
+ * @example formatTime("invalid") // ""
+ */
+export function formatTime(value, locale, options) {
+    if (!isValidTime(value)) {
+        return "";
+    }
+    try {
+        const out = Temporal.PlainTime.from(value).toLocaleString(locale, options);
+        return normalizeDateTime(out);
+    }
+    catch {
+        return "";
+    }
+}

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

@@ -0,0 +1,12 @@
+export * from "./formatCalendar.js";
+export * from "./formatDate.js";
+export * from "./formatDateRange.js";
+export * from "./formatDateTime.js";
+export * from "./formatDateTimeRange.js";
+export * from "./formatDateTimeToParts.js";
+export * from "./formatDateToParts.js";
+export * from "./formatRelativeDate.js";
+export * from "./formatRelativeDateTime.js";
+export * from "./formatRelativeTime.js";
+export * from "./formatSql.js";
+export * from "./formatTime.js";

package/dist/plain/format/index.js

@@ -0,0 +1,12 @@
+export * from "./formatCalendar.js";
+export * from "./formatDate.js";
+export * from "./formatDateRange.js";
+export * from "./formatDateTime.js";
+export * from "./formatDateTimeRange.js";
+export * from "./formatDateTimeToParts.js";
+export * from "./formatDateToParts.js";
+export * from "./formatRelativeDate.js";
+export * from "./formatRelativeDateTime.js";
+export * from "./formatRelativeTime.js";
+export * from "./formatSql.js";
+export * from "./formatTime.js";

package/dist/plain/get/getDay.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the current day of month using the system timeZone.
+ *
+ * - Uses Temporal.Now.zonedDateTimeISO to get current day in system timezone.
+ * - Returns zero-padded string (e.g., "29").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current day string (zero-padded) or "" on invalid
+ *
+ * @example getDay() // "29"
+ * @example getDay() // "" (when system timeZone unavailable)
+ */
+export declare function getDay(): string;

package/dist/plain/get/getDay.js

@@ -0,0 +1,27 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { getSystemTimeZone } from "../../zoned/get/getSystemTimeZone.js";
+/**
+ * Return the current day of month using the system timeZone.
+ *
+ * - Uses Temporal.Now.zonedDateTimeISO to get current day in system timezone.
+ * - Returns zero-padded string (e.g., "29").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current day string (zero-padded) or "" on invalid
+ *
+ * @example getDay() // "29"
+ * @example getDay() // "" (when system timeZone unavailable)
+ */
+export function getDay() {
+    const timeZone = getSystemTimeZone();
+    if (!timeZone)
+        return "";
+    try {
+        return Temporal.Now.zonedDateTimeISO(timeZone)
+            .day.toString()
+            .padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/get/getDayOfWeek.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the current ISO day of the week as a number in the system timeZone.
+ *
+ * - Uses Temporal.Now.zonedDateTimeISO to get current day in system timezone.
+ * - Returns ISO day of week: 1 (Monday) to 7 (Sunday).
+ * - Returns null when system timezone is unavailable.
+ *
+ * @returns current ISO day of week number (1-7) or null on invalid
+ *
+ * @example getDayOfWeek() // 4
+ * @example getDayOfWeek() // null (when system timeZone unavailable)
+ */
+export declare function getDayOfWeek(): number | null;

package/dist/plain/get/getDayOfWeek.js

@@ -0,0 +1,26 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { getSystemTimeZone } from "../../zoned/get/getSystemTimeZone.js";
+/**
+ * Return the current ISO day of the week as a number in the system timeZone.
+ *
+ * - Uses Temporal.Now.zonedDateTimeISO to get current day in system timezone.
+ * - Returns ISO day of week: 1 (Monday) to 7 (Sunday).
+ * - Returns null when system timezone is unavailable.
+ *
+ * @returns current ISO day of week number (1-7) or null on invalid
+ *
+ * @example getDayOfWeek() // 4
+ * @example getDayOfWeek() // null (when system timeZone unavailable)
+ */
+export function getDayOfWeek() {
+    const timeZone = getSystemTimeZone();
+    if (!timeZone)
+        return null;
+    try {
+        const now = Temporal.Now.zonedDateTimeISO(timeZone);
+        return now.dayOfWeek;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/plain/get/getHour.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the current hour using the system timeZone.
+ *
+ * - Uses Temporal.Now.plainDateTimeISO to get current hour in system timezone.
+ * - Returns zero-padded string (e.g., "14").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current hour string (zero-padded) or "" on invalid
+ *
+ * @example getHour() // "00"
+ * @example getHour() // "" (when system timeZone unavailable)
+ */
+export declare function getHour(): string;

package/dist/plain/get/getHour.js

@@ -0,0 +1,27 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { getSystemTimeZone } from "../../zoned/get/getSystemTimeZone.js";
+/**
+ * Return the current hour using the system timeZone.
+ *
+ * - Uses Temporal.Now.plainDateTimeISO to get current hour in system timezone.
+ * - Returns zero-padded string (e.g., "14").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current hour string (zero-padded) or "" on invalid
+ *
+ * @example getHour() // "00"
+ * @example getHour() // "" (when system timeZone unavailable)
+ */
+export function getHour() {
+    const timeZone = getSystemTimeZone();
+    if (!timeZone) {
+        return "";
+    }
+    try {
+        const now = Temporal.Now.plainDateTimeISO(timeZone);
+        return now.hour.toString().padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/get/getMicrosecond.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the current microsecond using the system timeZone.
+ *
+ * - Uses Temporal.Now.plainDateTimeISO to get current microsecond in system timezone.
+ * - Returns zero-padded string to 3 digits (e.g., "456").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current microsecond string (zero-padded to 3 digits) or "" on invalid
+ *
+ * @example getMicrosecond() // "000"
+ * @example getMicrosecond() // "" (when system timeZone unavailable)
+ */
+export declare function getMicrosecond(): string;

package/dist/plain/get/getMicrosecond.js

@@ -0,0 +1,27 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { getSystemTimeZone } from "../../zoned/get/getSystemTimeZone.js";
+/**
+ * Return the current microsecond using the system timeZone.
+ *
+ * - Uses Temporal.Now.plainDateTimeISO to get current microsecond in system timezone.
+ * - Returns zero-padded string to 3 digits (e.g., "456").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current microsecond string (zero-padded to 3 digits) or "" on invalid
+ *
+ * @example getMicrosecond() // "000"
+ * @example getMicrosecond() // "" (when system timeZone unavailable)
+ */
+export function getMicrosecond() {
+    const timeZone = getSystemTimeZone();
+    if (!timeZone) {
+        return "";
+    }
+    try {
+        const now = Temporal.Now.plainDateTimeISO(timeZone);
+        return (now.microsecond ?? 0).toString().padStart(3, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/get/getMillisecond.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the current millisecond using the system timeZone.
+ *
+ * - Uses Temporal.Now.plainDateTimeISO to get current millisecond in system timezone.
+ * - Returns zero-padded string to 3 digits (e.g., "123").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current millisecond string (zero-padded to 3 digits) or "" on invalid
+ *
+ * @example getMillisecond() // "000"
+ * @example getMillisecond() // "" (when system timeZone unavailable)
+ */
+export declare function getMillisecond(): string;

package/dist/plain/get/getMillisecond.js

@@ -0,0 +1,27 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { getSystemTimeZone } from "../../zoned/get/getSystemTimeZone.js";
+/**
+ * Return the current millisecond using the system timeZone.
+ *
+ * - Uses Temporal.Now.plainDateTimeISO to get current millisecond in system timezone.
+ * - Returns zero-padded string to 3 digits (e.g., "123").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current millisecond string (zero-padded to 3 digits) or "" on invalid
+ *
+ * @example getMillisecond() // "000"
+ * @example getMillisecond() // "" (when system timeZone unavailable)
+ */
+export function getMillisecond() {
+    const timeZone = getSystemTimeZone();
+    if (!timeZone) {
+        return "";
+    }
+    try {
+        const now = Temporal.Now.plainDateTimeISO(timeZone);
+        return (now.millisecond ?? 0).toString().padStart(3, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/get/getMinute.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the current minute using the system timeZone.
+ *
+ * - Uses Temporal.Now.plainDateTimeISO to get current minute in system timezone.
+ * - Returns zero-padded string (e.g., "30").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current minute string (zero-padded) or "" on invalid
+ *
+ * @example getMinute() // "00"
+ * @example getMinute() // "" (when system timeZone unavailable)
+ */
+export declare function getMinute(): string;

package/dist/plain/get/getMinute.js

@@ -0,0 +1,27 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { getSystemTimeZone } from "../../zoned/get/getSystemTimeZone.js";
+/**
+ * Return the current minute using the system timeZone.
+ *
+ * - Uses Temporal.Now.plainDateTimeISO to get current minute in system timezone.
+ * - Returns zero-padded string (e.g., "30").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current minute string (zero-padded) or "" on invalid
+ *
+ * @example getMinute() // "00"
+ * @example getMinute() // "" (when system timeZone unavailable)
+ */
+export function getMinute() {
+    const timeZone = getSystemTimeZone();
+    if (!timeZone) {
+        return "";
+    }
+    try {
+        const now = Temporal.Now.plainDateTimeISO(timeZone);
+        return now.minute.toString().padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/get/getMonth.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the current month using the system timeZone.
+ *
+ * - Uses Temporal.Now.zonedDateTimeISO to get current month in system timezone.
+ * - Returns zero-padded string (e.g., "02").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current month string (zero-padded) or "" on invalid
+ *
+ * @example getMonth() // "02"
+ * @example getMonth() // "" (when system timeZone unavailable)
+ */
+export declare function getMonth(): string;

package/dist/plain/get/getMonth.js

@@ -0,0 +1,27 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { getSystemTimeZone } from "../../zoned/get/getSystemTimeZone.js";
+/**
+ * Return the current month using the system timeZone.
+ *
+ * - Uses Temporal.Now.zonedDateTimeISO to get current month in system timezone.
+ * - Returns zero-padded string (e.g., "02").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current month string (zero-padded) or "" on invalid
+ *
+ * @example getMonth() // "02"
+ * @example getMonth() // "" (when system timeZone unavailable)
+ */
+export function getMonth() {
+    const timeZone = getSystemTimeZone();
+    if (!timeZone)
+        return "";
+    try {
+        return Temporal.Now.zonedDateTimeISO(timeZone)
+            .month.toString()
+            .padStart(2, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/get/getNanosecond.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Return the current nanosecond using the system timeZone.
+ *
+ * - Uses Temporal.Now.plainDateTimeISO to get current nanosecond in system timezone.
+ * - Returns zero-padded string to 3 digits (e.g., "789").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current nanosecond string (zero-padded to 3 digits) or "" on invalid
+ *
+ * @example getNanosecond() // "000"
+ * @example getNanosecond() // "" (when system timeZone unavailable)
+ */
+export declare function getNanosecond(): string;

package/dist/plain/get/getNanosecond.js

@@ -0,0 +1,27 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { getSystemTimeZone } from "../../zoned/get/getSystemTimeZone.js";
+/**
+ * Return the current nanosecond using the system timeZone.
+ *
+ * - Uses Temporal.Now.plainDateTimeISO to get current nanosecond in system timezone.
+ * - Returns zero-padded string to 3 digits (e.g., "789").
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns current nanosecond string (zero-padded to 3 digits) or "" on invalid
+ *
+ * @example getNanosecond() // "000"
+ * @example getNanosecond() // "" (when system timeZone unavailable)
+ */
+export function getNanosecond() {
+    const timeZone = getSystemTimeZone();
+    if (!timeZone) {
+        return "";
+    }
+    try {
+        const now = Temporal.Now.plainDateTimeISO(timeZone);
+        return (now.nanosecond ?? 0).toString().padStart(3, "0");
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/get/getNow.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Return the current local PlainDateTime as an ISO string using the system timeZone.
+ *
+ * - Uses Temporal.Now.zonedDateTimeISO to get current time in system timezone.
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns ISO 8601 PlainDateTime string or "" on error
+ *
+ * @example getNow() // "2024-03-15T14:30:45" (current time)
+ */
+export declare function getNow(): string;

package/dist/plain/get/getNow.js

@@ -0,0 +1,24 @@
+import { Temporal } from "@js-temporal/polyfill";
+import { getSystemTimeZone } from "../../zoned/get/getSystemTimeZone.js";
+/**
+ * Return the current local PlainDateTime as an ISO string using the system timeZone.
+ *
+ * - Uses Temporal.Now.zonedDateTimeISO to get current time in system timezone.
+ * - Returns "" when system timezone is unavailable.
+ *
+ * @returns ISO 8601 PlainDateTime string or "" on error
+ *
+ * @example getNow() // "2024-03-15T14:30:45" (current time)
+ */
+export function getNow() {
+    const timeZone = getSystemTimeZone();
+    if (!timeZone) {
+        return "";
+    }
+    try {
+        return Temporal.Now.zonedDateTimeISO(timeZone).toPlainDateTime().toString();
+    }
+    catch {
+        return "";
+    }
+}

package/dist/plain/get/getNowUnit.d.ts

@@ -0,0 +1,27 @@
+import type { DateTimeUnit } from "../../types/index.js";
+type NowUnit = DateTimeUnit | "dayOfWeek";
+/**
+ * Return the requested current unit value using the system timeZone.
+ *
+ * - Valid units: "year", "month", "week", "day", "dayOfWeek", "hour", "minute", "second", "millisecond", "microsecond", "nanosecond".
+ * - Uses Temporal.Now.zonedDateTimeISO to get current time in system timezone.
+ * - Returns "" when unit is invalid or system timezone is unavailable.
+ *
+ * @param unit unit to extract from current local time
+ * @returns string representation of the requested unit or "" on invalid
+ *
+ * @example getNowUnit("year") // "2024"
+ * @example getNowUnit("month") // "03"
+ * @example getNowUnit("week") // "11"
+ * @example getNowUnit("day") // "15"
+ * @example getNowUnit("dayOfWeek") // "5"
+ * @example getNowUnit("hour") // "14"
+ * @example getNowUnit("minute") // "30"
+ * @example getNowUnit("second") // "45"
+ * @example getNowUnit("millisecond") // "000"
+ * @example getNowUnit("microsecond") // "000"
+ * @example getNowUnit("nanosecond") // "000"
+ * @example getNowUnit("invalid") // ""
+ */
+export declare function getNowUnit(unit: NowUnit): string;
+export {};