Introduction to Holy Time
Holy Time is a type-safe date and time manipulation library that provides an intuitive, chainable API for working with dates, times, and durations in JavaScript and TypeScript.Why Holy Time?
Holy Time offers a modern approach to date manipulation with several key advantages:Type-Safe
Built with TypeScript from the ground up, providing full type safety and excellent autocomplete support
Chainable API
Fluent interface allows you to chain operations for clean, readable code
Lightweight
Zero dependencies and small bundle size
Intuitive
Simple, consistent API that feels natural to use
Key Features
Time Manipulation
Holy Time provides both static and instance methods for adding, subtracting, and manipulating dates:Comparisons & Queries
Check relationships between dates and query properties:Duration Calculations
Calculate and format time differences:Formatting
Format dates with custom patterns and timezone support:Comparison to Alternatives
Holy Time is designed as a modern alternative to libraries like Moment.js, Day.js, and date-fns, with a focus on type safety and chainable operations.
| Feature | Holy Time | Moment.js | Day.js | date-fns |
|---|---|---|---|---|
| Type-safe | Yes | No | Partial | Yes |
| Chainable API | Yes | Yes | Yes | No |
| Dependencies | 0 | Multiple | 0 | 0 |
| Bundle Size | Small | Large | Small | Medium |
| Mutable/Immutable | Mutable | Mutable | Immutable | Immutable |
Next Steps
Installation
Get started by installing Holy Time in your project
Quickstart
Learn the basics with a hands-on example