ts-time-utils

A comprehensive TypeScript utility library for time, dates, durations, and calendar operations

npm install ts-time-utils
📦

Lightweight

Zero dependencies, pure TypeScript

🌳

Tree-shakable

Import only what you need

âš¡

320+ Functions

26 utility categories

🔧

TypeScript

Full type safety & IntelliSense

Try it Live

Explore Categories

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

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