Introduction

What is Chronos?

Chronos is a lightweight, immutable, and fully tree-shakable date-time library designed for any JavaScript and TypeScript environment. It provides a rich API for date manipulation, formatting, comparison, and more — with a powerful plugin system for extending functionality.

Key Features

• 🕐 Immutable — Every Chronos operation returns a new instance
• 🔌 Plugin System — Extend with timezone, zodiac, seasons, business days, and more
• 🌳 Tree-Shakable — Zero runtime dependencies, only ship what you use
• 🛡️ Type-Safe — Full TypeScript support with precise types and rich IntelliSense
• ⚡ Lightweight — Small bundle size with modular exports
• 🌍 Timezone Support — UTC, local, and named timezone handling via timeZonePlugin
• 🔧 Date Utilities: Extra utilities, type guards, types and constants for light weight date operations without the need of core Chronos class

Quick Example

What's Next?