@burglekitt/gmt/dist/plain/calculate/weekOfYear.js

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

import { Temporal } from "@js-temporal/polyfill";
import { isValidDate, isValidDateTime } from "../validate/index.js";
/**
 * Return the ISO week number for a given ISO 8601 date string.
 *
 * - Uses Temporal.PlainDate.weekOfYear (Monday-based ISO weeks).
 * - Returns null for invalid input.
 *
 * @param value ISO 8601 date string
 * @returns Week number (1-53) or null on invalid input
 *
 * @example weekOfYearForDate("2024-01-01") // 1
 * @example weekOfYearForDate("2024-01-07") // 1
 * @example weekOfYearForDate("2024-01-08") // 2
 * @example weekOfYearForDate("2024-12-31") // 1
 * @example weekOfYearForDate("invalid") // null
 */
export function weekOfYearForDate(value) {
    if (!isValidDate(value))
        return null;
    try {
        const date = Temporal.PlainDate.from(value);
        return date.weekOfYear ?? null;
    }
    catch {
        return null;
    }
}
/**
 * Return the ISO week number for a given ISO 8601 datetime string.
 *
 * - Uses Temporal.PlainDate.weekOfYear (Monday-based ISO weeks).
 * - Returns null for invalid input.
 *
 * @param value ISO 8601 datetime string
 * @returns Week number (1-53) or null on invalid input
 *
 * @example weekOfYearForDateTime("2024-01-01T12:00:00") // 1
 * @example weekOfYearForDateTime("2024-01-08T00:00:00") // 2
 * @example weekOfYearForDateTime("invalid") // null
 */
export function weekOfYearForDateTime(value) {
    if (!isValidDateTime(value))
        return null;
    try {
        const dateTime = Temporal.PlainDateTime.from(value);
        const date = Temporal.PlainDate.from({
            year: dateTime.year,
            month: dateTime.month,
            day: dateTime.day,
        });
        return date.weekOfYear ?? null;
    }
    catch {
        return null;
    }
}