weekOfYearForDate
Signature
Section titled “Signature”weekOfYearForDate(value: string): number | nullReturn the ISO week number for a given ISO 8601 date string.
- Uses Temporal.PlainDate.weekOfYear (Monday-based ISO weeks).
- Returns null for invalid input.
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
value | string | ISO 8601 date string |
Returns
Section titled “Returns”Week number (1-53) or null on invalid input
Examples
Section titled “Examples”import { weekOfYearForDate } from "@northguild/gmt/plain/calculate";
weekOfYearForDate("2024-01-01") // 1