📅 bs-ad-converter

A simple TypeScript/JavaScript library to convert dates between Bikram Sambat (BS) and Gregorian (AD) calendars.
It also supports Nepali numerals conversion.

🚀 Installation (for standard modern project)

yarn add bs-ad-converter
# or
npm install bs-ad-converter

Usage

import { adToBS, bsToAD, convertToNepaliNumber } from "bs-ad-converter";
# or
const { adToBS, bsToAD, convertToNepaliNumber } = require("bs-ad-converter");

English To Nepali (AD to BS)

const nepDate = adToBS(2024, 8, 15); // yyyy, mm, dd

console.log(nepDate);
/*
{
  year: 2081,
  month: 5,
  date: 30,
  day: 'गुरुवार',
  nmonth: 'भदौ',
  num_day: 5
}
*/

Nepali to English (BS to AD)

const engDate = bsToAD(2081, 5, 30); // yyyy, mm, dd

console.log(engDate);
/*
{
  year: 2024,
  month: 8,
  date: 15,
  day: 'Thursday',
  emonth: 'August',
  num_day: 5
}
*/

Convert Number → Nepali Numerals

console.log(convertToNepaliNumber(2081)); 
// "२०८१"

console.log(convertToNepaliNumber("12345")); 
// "१२३४५"

📌 API Reference

| Function | Example | Output | | ----------------------- | -------------------------------- | ----------------------------------------------------------------------------------- | | adToBS | adToBS(2024, 8, 15) | { year: 2081, month: 5, date: 30, day: 'बिहिबार', nmonth: 'भदौ', num_day: 5 } | | bsToAD | bsToAD(2081, 5, 30) | { year: 2024, month: 8, date: 15, day: 'Thursday', emonth: 'August', num_day: 5 } | | convertToNepaliNumber | convertToNepaliNumber(2025) | "२०२५" | | convertToNepaliNumber | convertToNepaliNumber("12345") | "१२३४५" |

⚠️ Notes

• Supported English years: 1944–2099

• Supported Nepali years: 2000–2099

• Throws errors for invalid dates or out-of-range values.