The 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).
https://sudhang.pythonanywhere.com/
Request URL: https://sudhang.pythonanywhere.com/BStoAD/2005/05/11
Request URL: https://sudhang.pythonanywhere.com/ADtoBS/2005/05/11
Endpoint: /
Method: GET
Description: Renders the documentation page for the API.
Response: Returns the documentation.html
file.
GET / HTTP/1.1
Host: sudhang.pythonanywhere.com
Endpoint: /dateconvert
Method: GET
Description: Renders the date conversion page for users.
Response: Returns the dateconvert.html
file.
GET /dateconvert HTTP/1.1
Host: sudhang.pythonanywhere.com
Endpoint: /BStoAD/<int:year>/<int:month>/<int:day>
Method: GET
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.
Success:
{
"ad_date": {
"day": <day>,
"month": <month>,
"year": <year>
}
}
Error:
{
"error": "Error message"
}
GET /BStoAD/2080/1/1 HTTP/1.1
Host: sudhang.pythonanywhere.com
{
"ad_date": {
"day": 14,
"month": 4,
"year": 2023
}
}
Endpoint: /ADtoBS/<int:year>/<int:month>/<int:day>
Method: GET
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.
Success:
{
"bs_date": {
"day": <day>,
"month": <month>,
"year": <year>
}
}
Error:
{
"error": "Error message"
}
GET /ADtoBS/2023/1/15 HTTP/1.1
Host: sudhang.pythonanywhere.com
{
"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:
{
"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.