ad-bs-calendar-node

Backend-friendly AD/BS date conversion utilities for Node.js.

This package exposes the non-React calendar logic from ad-bs-calendar-react for backend services, APIs, scripts, and jobs. It has no React dependency and ships CommonJS, ESM, and TypeScript declarations.

Install

npm install ad-bs-calendar-node

Usage

const { CalendarType, convertDate, convertBsToAd, convertAdToBs } = require('ad-bs-calendar-node')

convertDate('2024-04-13', CalendarType.BS)
convertAdToBs('2024-04-13')
convertBsToAd('2081-01-01')

import {
  CalendarType,
  Language,
  convertDate,
  formatDateToReadable,
  getStartAndEndDate,
  getDaysByMonthAndYear,
} from 'ad-bs-calendar-node'

const bsDate = convertDate('2024-04-13', CalendarType.BS)
const readable = formatDateToReadable(bsDate, CalendarType.BS, Language.EN)
const monthBounds = getStartAndEndDate(CalendarType.BS, '2024-04-13')
const grid = getDaysByMonthAndYear('2024-04-13', CalendarType.BS)

Exports

• convertDate(date, toType, format?, lang?)
• convertAdToBs(date, format?, lang?)
• convertBsToAd(date, format?, lang?)
• formatDateToReadable(date, type, lang?)
• getStartAndEndDate(type, date?)
• getDaysByMonthAndYear(activeDate, type)
• getDateParts(date, type)
• convertToNepaliNumerals(value)
• getDayNames(locale?)
• date utilities: formatDate, parseDate, addDays, startOfWeek, endOfWeek, startOfMonth, endOfMonth, isSameDay, isBetweenDates
• constants: CalendarType, Language, CalendarConfig, Days, adMonths, bsMonths, adMonthsNe, bsMonthsNe, nepaliNumerals

Dates use YYYY-MM-DD. Backend date calculations are performed in UTC to avoid server timezone drift.