Miti Pariwartan — Bikram Sambat ↔ Gregorian Date Converter

Convert Nepali Bikram Sambat (BS) to Gregorian (AD) dates and vice versa, fully offline, no API calls, data powered by local JSON,

---

✨ Features

• 🔁 Convert BS → AD and AD → BS
• 🧮 Calculate Age from a given birth date
• ➖ Calculate Age Difference between two dates
• ⏳ Human-readable time ago / in future with fromNow()
• 🌐 Works in Node.js, React, Next.js, and Vanilla JS
• 📦 Dual builds: CommonJS (CJS) + ES Module (ESM)
• 📅 Supports Nepali date range 2057 BS to 2099 BS

---

📦 Installation

Using npm:

npm install miti-pariwartan

Using yarn:

yarn add miti-pariwartan

Using CDN:

<script src="https://cdn.jsdelivr.net/npm/miti-pariwartan/lib/index.umd.js"></script>

---

🚀 Usage Examples

🗓️ Convert BS → AD

import { convertBsToAd } from "miti-pariwartan";

const ad = convertBsToAd("2082-07-26");
console.log(ad.formatted.standard);
// → "2025-11-12"

🗓️ Convert AD → BS

import { convertAdToBs } from "miti-pariwartan";

const bs = convertAdToBs("2025-11-12");
console.log(bs.formatted.standard);
// → "2082-07-26"

🧮 Calculate Age (AD)

import { calculateAge } from "miti-pariwartan";

const age = calculateAge("1990-05-15"); // today = now
console.log(age);
// → { years: 35, months: 5, days: 28 }

➖ Age Difference (AD)

import { calculateAgeDifference } from "miti-pariwartan";

const diff = calculateAgeDifference("1990-05-15", "2025-11-12");
console.log(diff);
// → { years: 35, months: 5, days: 28 }

⏳ fromNow() – Human Readable "Time Ago" / "In Future"

import { fromNow } from "miti-pariwartan";

// Accepts string or Date object (AD only)
console.log(fromNow("2025-11-12"));
// → "10 days ago" (assuming today is 2025-11-22)

console.log(fromNow(new Date()));
// → "a few seconds ago"

console.log(fromNow("2025-12-25"));
// → "in 1 month"

console.log(fromNow("2026-05-20"));
// → "in 6 months"

console.log(fromNow("2030-01-01"));
// → "in 4 years"

fromNow Function Output Examples

Input	Output
less than 20 seconds ago	just now
20–59 seconds ago	a few seconds ago
1 minute ago	a minute ago
3 minutes ago	3 minutes ago
1 hour ago	an hour ago
5 hours ago	5 hours ago
1 day ago	yesterday
12 days ago	12 days ago
1 month ago	a month ago
2 months ago	2 months ago
1 year ago	a year ago
Next year	in 1 year
1 day in the future	tomorrow
30 seconds in the future	in a few seconds

🧩 Supported Input Formats

Type	Example	Works With
String (dash)	"2025-10-17"	All functions
String (slash)	"2025/10/17"	All functions
String (dot)	"2025.11.12" / "2082.07.26"	All functions
String (space)	"2025 11 12" / "2082 07 26"	All functions
Full date string	"Fri Nov 07 2025 08:19:22 GMT+0545"	AD → BS, calculateAge, fromNow
ISO string	"2025-11-07T00:00:00Z"	AD → BS, calculateAge, fromNow
Object (1-based month)	{ year: 2082, month: 6, day: 31 }	BS ↔ AD conversion only
Date object	new Date("2025-10-17")	AD → BS, calculateAge, fromNow

Invalid or out-of-range dates throw clear errors.

---

Made with ❤️ for the Nepali developer community.