weekOfYearForDateTime

Signature

weekOfYearForDateTime(value: string): number

import { weekOfYearForDateTime } from "@northguild/gmt/plain/calculate";

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.

Parameters

Parameter	Type	Description
value	string	ISO 8601 datetime string

Returns

Week number (1-53) or null on invalid input

Examples

weekOfYearForDateTime("2024-01-01T12:00:00") // 1
weekOfYearForDateTime("2024-01-08T00:00:00") // 2
weekOfYearForDateTime("invalid") // null

Source

plain/calculate/weekOfYearForDateTime.ts