@burglekitt/gmt/dist/utc/parse/parseNanosecondFromUtc.js

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

import { Temporal } from "@js-temporal/polyfill";
import { isValidUtc } from "../validate/index.js";
/**
 * Return the nanosecond (0-999) from a UTC datetime string.
 *
 * - Returns zero-padded string for nanosecond.
 * - Returns "" for invalid input.
 *
 * @param value ISO UTC datetime string (e.g., "2024-03-17T14:30:45.123Z")
 * @returns Nanosecond (000-999) or "" on invalid input
 *
 * @example parseNanosecondFromUtc("2024-03-17T14:30:45.123Z") // "123000000"
 * @example parseNanosecondFromUtc("invalid") // ""
 */
export function parseNanosecondFromUtc(value) {
    if (!isValidUtc(value))
        return "";
    try {
        const instant = Temporal.Instant.from(value);
        const dateTime = instant.toZonedDateTimeISO("UTC");
        return (dateTime.nanosecond ?? 0).toString().padStart(3, "0");
    }
    catch {
        return "";
    }
}