Calendar

ISO weeks, quarters, holidays, and calendar grids

Edit and run examples against `ts-time-utils@4.4.1` in your browser.

Week & Quarter

Get week numbers, quarters, and calendar info

index.ts

import { getWeekNumber, getQuarter, getDaysInMonth, getDaysInYear } from 'ts-time-utils/calendar';

const date = new Date('2025-09-14');

// ISO week number
console.log(getWeekNumber(date)); // 37

// Quarter
console.log(getQuarter(date)); // 3

// Days in month/year
console.log(getDaysInMonth(2025, 8)); // 30 (September, zero-based month)
console.log(getDaysInMonth(2024, 1)); // 29 (February in a leap year)
console.log(getDaysInYear(2024)); // 366
console.log(getDaysInYear(2025)); // 365

Console

Press Run to execute the example.

US Holidays

Calculate US federal holidays

index.ts

import { getEaster, getUSHolidays, getThanksgivingDay, getMemorialDay } from 'ts-time-utils/calendar';

// Easter (complex calculation!)
console.log(getEaster(2025));

// Get all US holidays for a year
const holidays = getUSHolidays(2025);
holidays.forEach(h => {
  console.log(`${h.name}: ${h.date.toDateString()}`);
});

// Specific holidays
console.log('Thanksgiving 2025:', getThanksgivingDay(2025));
console.log('Memorial Day 2025:', getMemorialDay(2025));

Console

Press Run to execute the example.