@burglekitt/gmt/dist/utc/convert/convertUtcToPlainDateTime.js

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

import { Temporal } from "@js-temporal/polyfill";
import { isValidTimeZone } from "../../zoned/index.js";
import { isValidUtc } from "../validate/index.js";
/**
 * Convert a UTC datetime string to a plain datetime string in the format "YYYY-MM-DDTHH:mm:ss".
 *
 * - Converts to specified timezone before extracting datetime.
 * - Defaults to UTC if no timezone specified.
 * - Returns "" for invalid input.
 *
 * @param value UTC datetime string (e.g., "2024-02-29T00:00:00Z")
 * @param options optional: timeZone (IANA)
 * @returns plain datetime string in "YYYY-MM-DDTHH:mm:ss" format or "" on invalid input
 *
 * @example convertUtcToPlainDateTime("2024-02-29T00:00:00Z") // "2024-02-29T00:00:00"
 * @example convertUtcToPlainDateTime("2024-02-29T00:00:00Z", { timeZone: "America/New_York" }) // "2024-02-28T19:00:00"
 * @example convertUtcToPlainDateTime("invalid") // ""
 */
export function convertUtcToPlainDateTime(value, options) {
    const { timeZone = "UTC" } = options ?? {};
    if (!isValidTimeZone(timeZone))
        return "";
    if (!isValidUtc(value))
        return "";
    try {
        const instant = Temporal.Instant.from(value);
        const zonedDateTime = instant.toZonedDateTimeISO(timeZone);
        return `${zonedDateTime.year.toString().padStart(4, "0")}-${zonedDateTime.month
            .toString()
            .padStart(2, "0")}-${zonedDateTime.day
            .toString()
            .padStart(2, "0")}T${zonedDateTime.hour
            .toString()
            .padStart(2, "0")}:${zonedDateTime.minute
            .toString()
            .padStart(2, "0")}:${zonedDateTime.second.toString().padStart(2, "0")}`;
    }
    catch {
        return "";
    }
}