ts-time-utils
A comprehensive TypeScript utility library for time, dates, durations, and calendar operations, with examples aligned to the current public API surface.
npm install ts-time-utils
Lightweight
Zero dependencies, pure TypeScript
Tree-shakable
Import only what you need
430+ Functions
32 public modules and interactive guides
TypeScript
Full type safety & IntelliSense
Try it Live
Explore Categories
Browse 32 focused guides, then open any example in StackBlitz with the v4.4.0 package pinned.
Format
Format durations, time ago strings, and custom date formats
Calculate
Date arithmetic, differences, and business day calculations
Validate
Validate dates, check conditions, and compare dates
Constants
Time conversion constants and shared utility types
Duration
Immutable Duration class with arithmetic operations
Timezone
Timezone conversions, DST handling, and zone comparisons
Calendar
ISO weeks, quarters, holidays, and calendar grids
DateRange
Date range operations: overlap, gaps, merge, split
Recurrence
RRULE-inspired recurring event patterns
Cron
Parse and match cron expressions
Fiscal
Fiscal year utilities with configurable start month
Compare
Sort, group, and analyze date arrays
Iterate
Iterate through date sequences and count dates
Parse
Parse dates from various formats and strings
NaturalLanguage
Parse human-friendly date strings
Chain
Fluent chainable API for date operations
Holidays
Public holidays for 20+ countries
Locale
Multi-language formatting with 40+ locales
Working Hours
Business hours calculations with break support
Serialize
Safe JSON date serialization and deserialization
Performance
Async utilities, benchmarking, and timing
Age
Age calculations and birthday utilities
Countdown
Timer and countdown utilities
Interval
Time interval operations
Range Presets
Common date range presets
Calendars
Non-Gregorian calendars (Hebrew, Islamic, Japanese, etc.)
Temporal
Temporal API compatibility layer
Finance
Market hours, trading days, settlement dates, and options expiration
Healthcare
Medication schedules, shift patterns, on-call rotations, and compliance
Scheduling
Slot generation, availability checking, and conflict detection
Precision
Nanoseconds, BigInt, DST detection, and leap seconds