Nepali Date Conversion API

The Nepali Date Conversion API provides functionality to convert dates between the Bikram Sambat (BS) and Gregorian (AD) calendars. The API is built using Flask and supports Cross-Origin Resource Sharing (CORS).

BS to AD Conversion

Request URL: https://sudhang.pythonanywhere.com/BStoAD/2005/05/11

AD to BS Conversion

Request URL: https://sudhang.pythonanywhere.com/ADtoBS/2005/05/11

Endpoint: /

Description: Renders the documentation page for the API.

Response: Returns the documentation.html file.

Endpoint: /dateconvert

Description: Renders the date conversion page for users.

Response: Returns the dateconvert.html file.

Endpoint: /BStoAD/<int:year>/<int:month>/<int:day>

Path Parameters:

• year (int): The year in Bikram Sambat (BS).
• month (int): The month in Bikram Sambat (BS).
• day (int): The day in Bikram Sambat (BS).

Description: Converts a given BS date to its corresponding AD date.

Response: Returns a JSON object containing the AD date or an error message.

Response Format:

Success:

{
  "ad_date": {
    "day": <day>,
    "month": <month>,
    "year": <year>
  }
}

Error:

{
  "error": "Error message"
}

Successful Response:

{
  "ad_date": {
    "day": 14,
    "month": 4,
    "year": 2023
  }
}

Endpoint: /ADtoBS/<int:year>/<int:month>/<int:day>

Path Parameters:

• year (int): The year in Gregorian (AD).
• month (int): The month in Gregorian (AD).
• day (int): The day in Gregorian (AD).

Description: Converts a given AD date to its corresponding BS date.

Response: Returns a JSON object containing the BS date or an error message.

Response Format:

Success:

{
  "bs_date": {
    "day": <day>,
    "month": <month>,
    "year": <year>
  }
}

Error:

{
  "error": "Error message"
}

Successful Response:

{
  "bs_date": {
    "day": 1,
    "month": 10,
    "year": 2079
  }
}

If an error occurs during the conversion, the API will return a JSON object with an error message. Common errors may include:

• Invalid date format or out-of-range dates.
• Issues with the date conversion functions.

Example Error Response:

{
  "error": "Invalid date format returned from conversion function."
}

To embed the Date Conversion page in your own application, use the following iframe code:

This API is developed by Sudhan Parajuli.

Handle potential exceptions in client-side code to manage errors gracefully.