BStoAD()

The BStoAD function converts a Bikram Sambat date string into its equivalent Gregorian calendar date string. It validates the input Nepali date against verified historical calendar maps and returns a formatted Gregorian date string suitable for storage in standard SQL databases or transmission over web APIs.

ImportCopy Anchor Link

import { BStoAD } from "nepali-date-library";

const { BStoAD } = require("nepali-date-library");

SignatureCopy Anchor Link

function BStoAD(bsDate: string): string;

ParametersCopy Anchor Link

Return ValueCopy Anchor Link

• Type: string
• Format: YYYY-MM-DD representing the corresponding Gregorian date in UTC.

ExceptionsCopy Anchor Link

ExamplesCopy Anchor Link

Basic ConversionCopy Anchor Link

import { BStoAD } from "nepali-date-library";

const adDate = BStoAD("2081-07-15");
console.log(adDate); // "2024-10-31"

Converting Month with 32 DaysCopy Anchor Link

Bikram Sambat summer months can contain 32 days. BStoAD validates the exact ephemeris for that year:

import { BStoAD } from "nepali-date-library";

// Jestha 32, 2081
const adDate = BStoAD("2081-02-32");
console.log(adDate); // "2024-06-14"

Database Persistence PatternCopy Anchor Link

Convert user-entered Bikram Sambat dates to standard ISO-8601 strings prior to storing in SQL or NoSQL databases:

import { BStoAD } from "nepali-date-library";

interface UserRegistrationInput {
  fullName: string;
  birthDateBS: string; // e.g. "2055-04-12"
}

function prepareUserForStorage(input: UserRegistrationInput) {
  return {
    fullName: input.fullName,
    birthDateBS: input.birthDateBS,
    birthDateAD: BStoAD(input.birthDateBS), // "1998-07-27"
  };
}

RelatedCopy Anchor Link

• ADtoBS(): Reciprocal conversion from AD to BS.
• date.getEnglishDate(): Method on NepaliDate instance returning a JavaScript Date.