@burglekitt/gmt/dist/zoned/get/getZonedWeekOfYear.js

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

import { Temporal } from "@js-temporal/polyfill";
import { isValidTimeZone } from "../validate/index.js";
/**
 * Return the current week of year for the specified IANA timeZone.
 *
 * - Uses Temporal.Now.zonedDateTimeISO to get the current time.
 * - Uses Temporal.PlainDate.weekOfYear for ISO week number.
 * - Validation is performed on the timezone.
 *
 * @param ianaTimezone IANA timeZone identifier
 * @returns current week number (1-53) or null on invalid input
 *
 * @example getZonedWeekOfYear("America/New_York") // 9
 * @example getZonedWeekOfYear("invalid") // null
 */
export function getZonedWeekOfYear(ianaTimezone) {
    if (!isValidTimeZone(ianaTimezone))
        return null;
    try {
        const now = Temporal.Now.zonedDateTimeISO(ianaTimezone);
        return now.toPlainDate().weekOfYear ?? null;
    }
    catch {
        return null;
    }
}