@burglekitt/gmt/dist/unix/convert/convertUnixToPlainDateTime.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 { getSystemTimeZone } from "../../zoned/get/index.js";
import { isValidUnixMilliseconds, isValidUnixSeconds, isValidUnixUnit, } from "../validate/index.js";
/**
 * Convert a Unix timestamp to a plain datetime string in the format "YYYY-MM-DDTHH:mm:ss".
 *
 * - Converts to PlainDateTime using the specified or system timezone.
 * - Validates epoch unit ("seconds" | "milliseconds").
 * - Returns "" for invalid input.
 *
 * @param unix Unix timestamp (number)
 * @param options optional: epochUnit ("seconds" | "milliseconds"), timeZone (IANA)
 * @returns plain datetime string in "YYYY-MM-DDTHH:mm:ss" format or "" on invalid input
 *
 * @example convertUnixToPlainDateTime(1709164800000) // "2024-02-29T00:00:00"
 * @example convertUnixToPlainDateTime(1709164800, { epochUnit: "seconds" }) // "2024-02-29T00:00:00"
 * @example convertUnixToPlainDateTime(-1) // "1969-12-31T23:59:59.999"
 */
export function convertUnixToPlainDateTime(unix, options) {
    const { epochUnit = "milliseconds", timeZone = getSystemTimeZone() } = options ?? {};
    if (!isValidUnixUnit(epochUnit))
        return "";
    if (!isValidTimeZone(timeZone))
        return "";
    try {
        if ((epochUnit === "milliseconds" && !isValidUnixMilliseconds(unix)) ||
            (epochUnit === "seconds" && !isValidUnixSeconds(unix))) {
            return "";
        }
        const instant = Temporal.Instant.fromEpochMilliseconds(epochUnit === "seconds" ? unix * 1000 : unix);
        const zonedDateTime = instant.toZonedDateTimeISO(timeZone);
        return zonedDateTime.toPlainDateTime().toString();
    }
    catch {
        return "";
    }
}