Convert a date to or from another calendar: Hebrew, Islamic, Persian, Chinese, Japanese eras, Julian and more

GET/v1/date/calendar

Convert a date to or from another calendar: Hebrew, Islamic, Persian, Chinese, Japanese eras, Julian and more

calendarquery · enumREQUIRED

Target or source calendar

one of: hebrew, islamic-umalqura, islamic-civil, persian, chinese, japanese, buddhist, indian, coptic, ethiopic, roc, julian

datequery · string

Gregorian date to convert (default: today)

e.g. 2026-10-09

yearquery · integer

Year in `calendar` (reverse conversion)

e.g. 1

monthquery · string

Month name or number in `calendar` (reverse conversion)

e.g. string

dayquery · integer

Day in `calendar` (reverse conversion)

e.g. 1

eraquery · string

Japanese era for reverse conversion

e.g. reiwa

curl "https://api.apialmanac.com/v1/date/calendar?calendar=hebrew" \
  -H "X-API-Key: YOUR_KEY"

import requests

r = requests.get("https://api.apialmanac.com/v1/date/calendar?calendar=hebrew", headers={"X-API-Key": "YOUR_KEY"})
print(r.status_code, r.headers.get("X-Gw-Remaining"))
print(r.json())

const r = await fetch("https://api.apialmanac.com/v1/date/calendar?calendar=hebrew", {
  headers: { "X-API-Key": "YOUR_KEY" }
});
console.log(r.status, r.headers.get("X-Gw-Remaining"));
console.log(await r.json());

{
  "gregorian": "2026-10-09",
  "calendar": "hebrew",
  "label": "Hebrew",
  "year": 5787,
  "month": 1,
  "month_name": "Tishri",
  "months_in_year": 12,
  "day": 28,
  "era": "AM",
  "formatted": "28 Tishri 5787 AM",
  "weekday": "Friday"
}