@spoot/day
v1.0.1
Published
Date utilities: type-safe Day, Week, Month, and CalendarWeek abstractions
Readme
@spoot/day
Type-safe date abstractions: Day, Week, Month, CalendarWeek, and DaySelector. All values are plain-object serializable and free of timezone surprises.
Install
npm install @spoot/dayUsage
import { Day, Week, Month, DaySelector } from "@spoot/day";
const today = Day.today();
const week = Week.containing(today);
const month = Month.containing(today);Day– calendar date (YYYY-MM-DD), no time componentWeek– ISO week with start/end daysMonth– calendar month with helpers for iterating daysCalendarWeek– a week as displayed in a calendar grid (may span two months)DaySelector– predicate for matching days (e.g. every Monday, last day of month)
Development
pnpm typecheck # type-check
pnpm test # run Jest tests
pnpm build:lib # compile to dist/