⏱️ chronoflex-formatter

A lightweight and flexible date utility library that returns Date objects with powerful formatting helpers.

Supports:

✅ ESM & CommonJS ✅ Multiple date variants (startOfDay, endOfMonth, etc.) ✅ Custom formatting tokens ✅ Zero dependencies ✅ TypeScript support

📦 Installation

npm install chronoflex-formatter

🚀 Usage

✅ ESM (Modern)

import { now, iso, variants } from "chronoflex-formatter";

const date = now();

console.log(date);                 // Date object
console.log(iso(date));            // ISO string
console.log(variants(date).startOfDay);

✅ CommonJS

const chrono = require("chronoflex-formatter");

const date = chrono.now();

console.log(date);
console.log(chrono.iso(date));

📅 Core Functions

Get Current Date

import { now } from "chronoflex-formatter";

const date = now(); // Date object

Clone Date

import { clone } from "chronoflex-formatter";

const copy = clone(date);

🧠 Date Variants (Return Date Objects)

import { variants } from "chronoflex-formatter";

const v = variants();

console.log(v.original);
console.log(v.startOfDay);
console.log(v.endOfDay);
console.log(v.startOfMonth);
console.log(v.endOfMonth);
console.log(v.startOfYear);
console.log(v.endOfYear);

All values returned are Date objects, not strings.

🧩 Date Parts

import { parts } from "chronoflex-formatter";

const p = parts();

console.log(p.year);
console.log(p.month);
console.log(p.day);
console.log(p.hours);

🎨 Formatting Functions

ISO Format

import { iso } from "chronoflex-formatter";

iso(); 
// 2026-02-17T10:20:30.000Z

Local Format

import { local } from "chronoflex-formatter";

local();
// 17/02/2026, 3:50:30 pm

12 Hour Time

import { time12 } from "chronoflex-formatter";

time12();
// 03:50:30 PM

24 Hour Time

import { time24 } from "chronoflex-formatter";

time24();
// 15:50:30

Custom Format

Supported tokens:

| Token | Meaning | | ----- | ---------- | | YYYY | Year | | MM | Month | | DD | Day | | HH | Hours (24) | | mm | Minutes | | ss | Seconds |

Example:

import { custom } from "chronoflex-formatter";

custom("YYYY-MM-DD HH:mm:ss");
// 2026-02-17 15:50:30

💡 Why chronoflex-formatter?

Unlike many libraries that return only strings, this package:

✅ Keeps Date object integrity ✅ Gives multiple derived dates instantly ✅ Simple API ✅ No heavy dependencies

Perfect for:

• Backend services
• Logging systems
• Scheduling apps
• Microservices timestamps
• Angular / React / Node projects

⚡ TypeScript Support

Types are included automatically.

import { now } from "chronoflex-formatter";

const date: Date = now();

🔮 Roadmap

Planned features:

• Timezone support
• Relative time (5 minutes ago)
• Immutable date wrapper
• Duration utilities
• Angular Pipe support

🤝 Contributing

Contributions are welcome!

1. Fork repo
2. Create feature branch
3. Commit changes
4. Open PR

📄 License

MIT License © 2026

⭐ Support

If you like this project, please give it a ⭐ on GitHub.