periods

Periods is a lightweight JavaScript library that offers predefined time-period constants in milliseconds. It helps developers avoid common pitfalls when working with time calculations by providing a reliable and error-resistant API.

Key Features

• Function-based API — Exposes time periods as functions (e.g., day(), week()) to catch typos early and prevent silent NaN errors in data.
• Plural methods — Includes both singular and plural method variants (e.g., second() and seconds()) for intuitive usage.
• Rough approximations — Provides monthRough() and yearRough() methods using approximate multipliers (4.3 weeks per month, 365.25 days per year) for flexible time calculations.
• Browser and Node.js support — Works seamlessly in both browser and Node.js environments.
• Chainable calculations — Allows easy multiplication of time periods (e.g., day(2) for two days) and integration with array methods like map().

Philosophy

Periods prioritizes developer experience by reducing errors in time-based calculations through a simple, function-driven design that fails loudly instead of silently.