Try Converter API Documentation

Live Demo

See the API in action with these live examples

BS to AD Conversion

Request: GET /api/bs-to-ad/2080/1/1

AD to BS Conversion

Request: GET /api/ad-to-bs/2023/4/14

Key Features

Real-time Conversion

Instant and accurate date conversion between BS and AD calendars with millisecond response times.

Reliable & Accurate

Based on official Nepal calendar standards with extensive validation and error handling.

Developer Friendly

RESTful API with JSON responses, comprehensive documentation, and easy integration.

Mobile Responsive

Works seamlessly across all devices with responsive design and touch-friendly interface.

Conversion History

Keep track of your recent conversions with built-in history functionality.

CORS Enabled

Cross-origin requests supported for easy integration into web applications.

API Overview

Base URL

https://sudhanparajuli.com.np/api/

Main Endpoints

GET /api/bs-to-ad/{year}/{month}/{day}

Convert Bikram Sambat date to Gregorian date

GET /api/ad-to-bs/{year}/{month}/{day}

Convert Gregorian date to Bikram Sambat date

POST /api/convert

Convert dates using JSON payload

Quick Start Guide

1

Choose Your Method

Use GET requests for simple conversions or POST for batch operations

// Simple GET request
fetch('https://sudhanparajuli.com.np/api/bs-to-ad/2080/1/1')
  .then(response => response.json())
  .then(data => console.log(data));
2

Handle the Response

Parse the JSON response to get your converted date

// Response format
{
  "success": true,
  "input": {"year": 2080, "month": 1, "day": 1, "type": "BS"},
  "result": {"year": 2023, "month": 4, "day": 14, "type": "AD"}
}
3

Integrate Into Your App

Use the converted date in your application logic

// Display formatted date
const formatDate = (dateObj) => {
  return `${dateObj.day}/${dateObj.month}/${dateObj.year}`;
};

console.log(formatDate(data.result)); // 14/4/2023

Calendar Information

Bikram Sambat (BS)

🇳🇵
  • Origin: Nepal's official calendar
  • System: Lunar-solar calendar
  • New Year: Mid-April (Baishak 1)
  • Months: 12 months (29-32 days each)
  • Year Difference: ~56.7 years ahead of AD
  • Current Era: Started from 57 BCE

Gregorian Calendar (AD)

🌍
  • Origin: International standard
  • System: Solar calendar
  • New Year: January 1st
  • Months: 12 months (28-31 days each)
  • Leap Year: Every 4 years (with exceptions)
  • Current Era: Started from 1 CE
Note: Our API supports date conversion between BS years 1971-2100 (approximately AD 1914-2044). All conversions follow official Nepal calendar standards and account for the varying month lengths in the Bikram Sambat calendar.