getQuarterForDate

Signature

getQuarterForDate(value: string): number

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

Return the quarter of the year (1-4) for a given ISO date.

• Returns the quarter (1-4) containing the input date.
• Q1 = months 1-3, Q2 = months 4-6, Q3 = months 7-9, Q4 = months 10-12.
• Validates input using isValidDate.

Parameters

Parameter	Type	Description
value	string	ISO PlainDate string

Returns

number (1-4) or null for invalid input

Examples

getQuarterForDate("2024-01-15") // 1
getQuarterForDate("2024-04-15") // 2
getQuarterForDate("2024-07-15") // 3
getQuarterForDate("2024-10-15") // 4
getQuarterForDate("invalid") // null

Source

plain/calculate/getQuarterForDate.ts