@burglekitt/gmt/dist/plain/get/getMicrosecond.js

Temporal-based date and time utilities with timezone support and polyfill integration

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 "";
    }
}