getDayOfYear

Signature

getDayOfYear(value: string): number

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

Return the ordinal day-of-year (1-based) for value.

• Jan 1 is 1; Dec 31 is 365 (common year) or 366 (leap year).
• Returns null on invalid input.

Parameters

Parameter	Type	Description
value	string	ISO PlainDate string

Returns

1-366, or null on invalid input

Examples

getDayOfYear("2024-01-01") // 1
getDayOfYear("2024-12-31") // 366 (leap year)
getDayOfYear("2023-12-31") // 365
getDayOfYear("2024-03-01") // 61 (after the Feb 29 leap day)
getDayOfYear("invalid") // null

Source

plain/calculate/getDayOfYear.ts