{
"gregorian": {
"date": "2026-10-22",
"year": 2026,
"month": 10,
"monthName": "October",
"day": 22,
"weekday": "Thursday",
"dayOfYear": 295,
"leapYear": false,
"julianDay": 2461336
},
"hebrew": {
"year": 5787,
"month": 8,
"monthName": "Cheshvan",
"monthNameHebrew": "חשון",
"day": 11,
"text": "11 Cheshvan 5787",
"textHebrew": "י״א חשון תשפ״ז",
"monthLength": 30,
"leapYear": true,
"yearLength": 385,
"yearKind": "complete"
},
"islamic": {
"method": "umalqura",
"year": 1448,
"month": 5,
"monthName": "Jumada al-Ula",
"monthNameArabic": "جمادى الأولى",
"day": 11,
"text": "11 Jumada al-Ula 1448 AH",
"monthLength": 30,
"yearLength": 355,
"note": "Calculated date. The start of an Islamic month is set by sighting the new crescent (or by a national authority) and can differ by 1-2 days by country; days begin at sunset the evening before. Not for religious rulings."
},
"chinese": {
"year": 2026,
"month": 9,
"leapMonth": false,
"day": 13,
"monthName": "九月",
"dayName": "十三",
"text": "丙午年九月十三",
"textEnglish": "Year of the Horse (bǐngwǔ), month 9, day 13",
"cycle": {
"name": "丙午",
"pinyin": "bǐngwǔ",
"cycleYear": 43,
"stem": "丙",
"branch": "午",
"element": "Fire",
"yinYang": "yang",
"zodiac": "Horse",
"zodiacChinese": "马"
},
"monthLength": 30,
"yearLeapMonth": null,
"solarTerm": null
}
}
curl --location --request GET 'https://zylalabs.com/api/14563/world+calendars+converter+api/37316/convert+a+date+between+calendars?date=2026-10-22&leap=false&to=gregorian,hebrew,islamic,chinese&method=umalqura&afterSunset=false' --header 'Authorization: Bearer YOUR_API_KEY'
{
"timezone": "Asia/Jerusalem",
"localTime": "2026-10-28T03:51",
"gregorian": {
"date": "2026-10-28",
"year": 2026,
"month": 10,
"monthName": "October",
"day": 28,
"weekday": "Wednesday",
"dayOfYear": 301,
"leapYear": false,
"julianDay": 2461342
},
"hebrew": {
"year": 5787,
"month": 8,
"monthName": "Cheshvan",
"monthNameHebrew": "חשון",
"day": 17,
"text": "17 Cheshvan 5787",
"textHebrew": "י״ז חשון תשפ״ז",
"monthLength": 30,
"leapYear": true,
"yearLength": 385,
"yearKind": "complete"
},
"islamic": {
"method": "umalqura",
"year": 1448,
"month": 5,
"monthName": "Jumada al-Ula",
"monthNameArabic": "جمادى الأولى",
"day": 17,
"text": "17 Jumada al-Ula 1448 AH",
"monthLength": 30,
"yearLength": 355,
"note": "Calculated date. The start of an Islamic month is set by sighting the new crescent (or by a national authority) and can differ by 1-2 days by country; days begin at sunset the evening before. Not for religious rulings."
},
"chinese": {
"year": 2026,
"month": 9,
"leapMonth": false,
"day": 19,
"monthName": "九月",
"dayName": "十九",
"text": "丙午年九月十九",
"textEnglish": "Year of the Horse (bǐngwǔ), month 9, day 19",
"cycle": {
"name": "丙午",
"pinyin": "bǐngwǔ",
"cycleYear": 43,
"stem": "丙",
"branch": "午",
"element": "Fire",
"yinYang": "yang",
"zodiac": "Horse",
"zodiacChinese": "马"
},
"monthLength": 30,
"yearLeapMonth": null,
"solarTerm": null
}
}
curl --location --request GET 'https://zylalabs.com/api/14563/world+calendars+converter+api/37317/today+in+every+calendar+in+a+time+zone?timezone=Asia/Jerusalem&to=gregorian,hebrew,islamic,chinese&method=umalqura&afterSunset=false' --header 'Authorization: Bearer YOUR_API_KEY'
{
"calendar": "chinese",
"year": 2025,
"cycle": {
"name": "乙巳",
"pinyin": "yǐsì",
"cycleYear": 42,
"stem": "乙",
"branch": "巳",
"element": "Wood",
"yinYang": "yin",
"zodiac": "Snake",
"zodiacChinese": "蛇"
},
"leapMonth": 6,
"length": 384,
"start": "2025-01-29",
"end": "2026-02-16",
"months": [
{
"month": 1,
"leap": false,
"name": "正月",
"start": "2025-01-29",
"end": "2025-02-27",
"length": 30
},
{
"month": 2,
"leap": false,
"name": "二月",
"start": "2025-02-28",
"end": "2025-03-28",
"length": 29
},
{
"month": 3,
"leap": false,
"name": "三月",
"start": "2025-03-29",
"end": "2025-04-27",
"length": 30
},
{
"month": 4,
"leap": false,
"name": "四月",
"start": "2025-04-28",
"end": "2025-05-26",
"length": 29
},
{
"month": 5,
"leap": false,
"name": "五月",
"start": "2025-05-27",
"end": "2025-06-24",
"length": 29
},
{
"month": 6,
"leap": false,
"name": "六月",
"start": "2025-06-25",
"end": "2025-07-24",
"length": 30
},
{
"month": 6,
"leap": true,
"name": "闰六月",
"start": "2025-07-25",
"end": "2025-08-22",
"length": 29
},
{
"month": 7,
"leap": false,
"name": "七月",
"start": "2025-08-23",
"end": "2025-09-21",
"length": 30
},
{
"month": 8,
"leap": false,
"name": "八月",
"start": "2025-09-22",
"end": "2025-10-20",
"length": 29
},
{
"month": 9,
"leap": false,
"name": "九月",
"start": "2025-10-21",
"end": "2025-11-19",
"length": 30
},
{
"month": 10,
"leap": false,
"name": "十月",
"start": "2025-11-20",
"end": "2025-12-19",
"length": 30
},
{
"month": 11,
"leap": false,
"name": "冬月",
"start": "2025-12-20",
"end": "2026-01-18",
"length": 30
},
{
"month": 12,
"leap": false,
"name": "腊月",
"start": "2026-01-19",
"end": "2026-02-16",
"length": 29
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14563/world+calendars+converter+api/37318/a+year+s+months+with+their+gregorian+dates?calendar=chinese&year=2025' --header 'Authorization: Bearer YOUR_API_KEY'
{
"calendar": "hebrew",
"year": 2026,
"calendarYears": [
5786,
5787
],
"israel": false,
"include": [
"major",
"minor",
"fast",
"modern"
],
"count": 22,
"holidays": [
{
"id": "tu-bishvat",
"name": "Tu BiShvat",
"localName": "ט״ו בשבט",
"date": "2026-02-02",
"endDate": "2026-02-02",
"days": 1,
"weekday": "Monday",
"category": "minor",
"calendarDate": "15 Sh'vat 5786",
"beginsEvening": "2026-02-01"
},
{
"id": "taanit-esther",
"name": "Ta'anit Esther",
"localName": "תענית אסתר",
"date": "2026-03-02",
"endDate": "2026-03-02",
"days": 1,
"weekday": "Monday",
"category": "fast",
"calendarDate": "13 Adar 5786",
"notes": [
"Fast from dawn."
]
},
{
"id": "purim",
"name": "Purim",
"localName": "פורים",
"date": "2026-03-03",
"endDate": "2026-03-03",
"days": 1,
"weekday": "Tuesday",
"category": "minor",
"calendarDate": "14 Adar 5786",
"beginsEvening": "2026-03-02"
},
{
"id": "shushan-purim",
"name": "Shushan Purim",
"localName": "שושן פורים",
"date": "2026-03-04",
"endDate": "2026-03-04",
"days": 1,
"weekday": "Wednesday",
"category": "minor",
"calendarDate": "15 Adar 5786",
"beginsEvening": "2026-03-03",
"notes": [
"Kept in Jerusalem and other anciently walled cities."
]
},
{
"id": "pesach",
"name": "Pesach",
"localName": "פסח",
"date": "2026-04-02",
"endDate": "2026-04-09",
"days": 8,
"weekday": "Thursday",
"category": "major",
"calendarDate": "15 Nisan 5786",
"beginsEvening": "2026-04-01",
"notes": [
"Outside Israel 8 days: the first two and last two are full holidays."
]
},
{
"id": "yom-hashoah",
"name": "Yom HaShoah",
"localName": "יום השואה",
"date": "2026-04-14",
"endDate": "2026-04-14",
"days": 1,
"weekday": "Tuesday",
"category": "modern",
"calendarDate": "27 Nisan 5786",
"beginsEvening": "2026-04-13"
},
{
"id": "yom-hazikaron",
"name": "Yom HaZikaron",
"localName": "יום הזיכרון",
"date": "2026-04-21",
"endDate": "2026-04-21",
"days": 1,
"weekday": "Tuesday",
"category": "modern",
"calendarDate": "4 Iyyar 5786",
"beginsEvening": "2026-04-20",
"notes": [
"The day before Yom HaAtzma'ut."
]
},
{
"id": "yom-haatzmaut",
"name": "Yom HaAtzma'ut",
"localName": "יום העצמאות",
"date": "2026-04-22",
"endDate": "2026-04-22",
"days": 1,
"weekday": "Wednesday",
"category": "modern",
"calendarDate": "5 Iyyar 5786",
"beginsEvening": "2026-04-21"
},
{
"id": "lag-baomer",
"name": "Lag BaOmer",
"localName": "ל״ג בעומר",
"date": "2026-05-05",
"endDate": "2026-05-05",
"days": 1,
"weekday": "Tuesday",
"category": "minor",
"calendarDate": "18 Iyyar 5786",
"beginsEvening": "2026-05-04"
},
{
"id": "yom-yerushalayim",
"name": "Yom Yerushalayim",
"localName": "יום ירושלים",
"date": "2026-05-15",
"endDate": "2026-05-15",
"days": 1,
"weekday": "Friday",
"category": "modern",
"calendarDate": "28 Iyyar 5786",
"beginsEvening": "2026-05-14"
},
{
"id": "shavuot",
"name": "Shavuot",
"localName": "שבועות",
"date": "2026-05-22",
"endDate": "2026-05-23",
"days": 2,
"weekday": "Friday",
"category": "major",
"calendarDate": "6 Sivan 5786",
"beginsEvening": "2026-05-21"
},
{
"id": "tzom-tammuz",
"name": "Tzom Tammuz",
"localName": "שבעה עשר בתמוז",
"date": "2026-07-02",
"endDate": "2026-07-02",
"days": 1,
"weekday": "Thursday",
"category": "fast",
"calendarDate": "17 Tamuz 5786",
"notes": [
"Fast from dawn."
]
},
{
"id": "tisha-bav",
"name": "Tisha B'Av",
"localName": "תשעה באב",
"date": "2026-07-23",
"endDate": "2026-07-23",
"days": 1,
"weekday": "Thursday",
"category": "fast",
"calendarDate": "9 Av 5786",
"beginsEvening": "2026-07-22",
"notes": [
"Fast from sunset the evening before."
]
},
{
"id": "tu-bav",
"name": "Tu B'Av",
"localName": "ט״ו באב",
"date": "2026-07-29",
"endDate": "2026-07-29",
"days": 1,
"weekday": "Wednesday",
"category": "minor",
"calendarDate": "15 Av 5786",
"beginsEvening": "2026-07-28"
},
{
"id": "rosh-hashana",
"name": "Rosh Hashana",
"localName": "ראש השנה",
"date": "2026-09-12",
"endDate": "2026-09-13",
"days": 2,
"weekday": "Saturday",
"category": "major",
"calendarDate": "1 Tishrei 5787",
"beginsEvening": "2026-09-11",
"notes": [
"Hebrew new year 5787."
]
},
{
"id": "tzom-gedaliah",
"name": "Tzom Gedaliah",
"localName": "צום גדליה",
"date": "2026-09-14",
"endDate": "2026-09-14",
"days": 1,
"weekday": "Monday",
"category": "fast",
"calendarDate": "3 Tishrei 5787",
"notes": [
"Fast from dawn."
]
},
{
"id": "yom-kippur",
"name": "Yom Kippur",
"localName": "יום כיפור",
"date": "2026-09-21",
"endDate": "2026-09-21",
"days": 1,
"weekday": "Monday",
"category": "major",
"calendarDate": "10 Tishrei 5787",
"beginsEvening": "2026-09-20"
},
{
"id": "sukkot",
"name": "Sukkot",
"localName": "סוכות",
"date": "2026-09-26",
"endDate": "2026-10-02",
"days": 7,
"weekday": "Saturday",
"category": "major",
"calendarDate": "15 Tishrei 5787",
"beginsEvening": "2026-09-25",
"notes": [
"Outside Israel the first two days are full holidays; days 3-7 are Chol HaMoed (the 7th is Hoshana Raba)."
]
},
{
"id": "shmini-atzeret",
"name": "Shmini Atzeret",
"localName": "שמיני עצרת",
"date": "2026-10-03",
"endDate": "2026-10-03",
"days": 1,
"weekday": "Saturday",
"category": "major",
"calendarDate": "22 Tishrei 5787",
"beginsEvening": "2026-10-02"
},
{
"id": "simchat-torah",
"name": "Simchat Torah",
"localName": "שמחת תורה",
"date": "2026-10-04",
"endDate": "2026-10-04",
"days": 1,
"weekday": "Sunday",
"category": "major",
"calendarDate": "23 Tishrei 5787",
"beginsEvening": "2026-10-03",
"notes": [
"Outside Israel, 23 Tishrei."
]
},
{
"id": "chanukah",
"name": "Chanukah",
"localName": "חנוכה",
"date": "2026-12-05",
"endDate": "2026-12-12",
"days": 8,
"weekday": "Saturday",
"category": "minor",
"calendarDate": "25 Kislev 5787",
"beginsEvening": "2026-12-04",
"notes": [
"The first candle is lit on the evening before the first day."
]
},
{
"id": "asara-btevet",
"name": "Asara B'Tevet",
"localName": "עשרה בטבת",
"date": "2026-12-20",
"endDate": "2026-12-20",
"days": 1,
"weekday": "Sunday",
"category": "fast",
"calendarDate": "10 Tevet 5787",
"notes": [
"Fast from dawn."
]
}
],
"notes": [
"Dates are the daytime dates; each holiday begins at sunset on \"beginsEvening\" (fasts marked \"from dawn\" begin at dawn)."
]
}
curl --location --request GET 'https://zylalabs.com/api/14563/world+calendars+converter+api/37319/jewish+islamic+or+chinese+holidays+for+a+year?calendar=hebrew&year=2026&israel=false' --header 'Authorization: Bearer YOUR_API_KEY'
{
"year": 2026,
"timezone": "Asia/Shanghai (UTC+8)",
"count": 24,
"terms": [
{
"longitude": 285,
"name": "小寒",
"pinyin": "Xiǎohán",
"english": "Minor Cold",
"date": "2026-01-05",
"chineseDate": "冬月十七",
"momentUtc": "2026-01-05T08:20Z",
"nearMidnight": false
},
{
"longitude": 300,
"name": "大寒",
"pinyin": "Dàhán",
"english": "Major Cold",
"date": "2026-01-20",
"chineseDate": "腊月初二",
"momentUtc": "2026-01-20T01:43Z",
"nearMidnight": false
},
{
"longitude": 315,
"name": "立春",
"pinyin": "Lìchūn",
"english": "Start of Spring",
"date": "2026-02-04",
"chineseDate": "腊月十七",
"momentUtc": "2026-02-03T19:57Z",
"nearMidnight": false
},
{
"longitude": 330,
"name": "雨水",
"pinyin": "Yǔshuǐ",
"english": "Rain Water",
"date": "2026-02-18",
"chineseDate": "正月初二",
"momentUtc": "2026-02-18T15:48Z",
"nearMidnight": false
},
{
"longitude": 345,
"name": "惊蛰",
"pinyin": "Jīngzhé",
"english": "Awakening of Insects",
"date": "2026-03-05",
"chineseDate": "正月十七",
"momentUtc": "2026-03-05T13:52Z",
"nearMidnight": false
},
{
"longitude": 0,
"name": "春分",
"pinyin": "Chūnfēn",
"english": "Spring Equinox",
"date": "2026-03-20",
"chineseDate": "二月初二",
"momentUtc": "2026-03-20T14:46Z",
"nearMidnight": false
},
{
"longitude": 15,
"name": "清明",
"pinyin": "Qīngmíng",
"english": "Pure Brightness",
"date": "2026-04-05",
"chineseDate": "二月十八",
"momentUtc": "2026-04-04T18:36Z",
"nearMidnight": false
},
{
"longitude": 30,
"name": "谷雨",
"pinyin": "Gǔyǔ",
"english": "Grain Rain",
"date": "2026-04-20",
"chineseDate": "三月初四",
"momentUtc": "2026-04-20T01:38Z",
"nearMidnight": false
},
{
"longitude": 45,
"name": "立夏",
"pinyin": "Lìxià",
"english": "Start of Summer",
"date": "2026-05-05",
"chineseDate": "三月十九",
"momentUtc": "2026-05-05T11:44Z",
"nearMidnight": false
},
{
"longitude": 60,
"name": "小满",
"pinyin": "Xiǎomǎn",
"english": "Grain Buds",
"date": "2026-05-21",
"chineseDate": "四月初五",
"momentUtc": "2026-05-21T00:37Z",
"nearMidnight": false
},
{
"longitude": 75,
"name": "芒种",
"pinyin": "Mángzhòng",
"english": "Grain in Ear",
"date": "2026-06-05",
"chineseDate": "四月二十",
"momentUtc": "2026-06-05T15:46Z",
"nearMidnight": false
},
{
"longitude": 90,
"name": "夏至",
"pinyin": "Xiàzhì",
"english": "Summer Solstice",
"date": "2026-06-21",
"chineseDate": "五月初七",
"momentUtc": "2026-06-21T08:25Z",
"nearMidnight": false
},
{
"longitude": 105,
"name": "小暑",
"pinyin": "Xiǎoshǔ",
"english": "Minor Heat",
"date": "2026-07-07",
"chineseDate": "五月廿三",
"momentUtc": "2026-07-07T01:54Z",
"nearMidnight": false
},
{
"longitude": 120,
"name": "大暑",
"pinyin": "Dàshǔ",
"english": "Major Heat",
"date": "2026-07-23",
"chineseDate": "六月初十",
"momentUtc": "2026-07-22T19:18Z",
"nearMidnight": false
},
{
"longitude": 135,
"name": "立秋",
"pinyin": "Lìqiū",
"english": "Start of Autumn",
"date": "2026-08-07",
"chineseDate": "六月廿五",
"momentUtc": "2026-08-07T11:44Z",
"nearMidnight": false
},
{
"longitude": 150,
"name": "处暑",
"pinyin": "Chǔshǔ",
"english": "End of Heat",
"date": "2026-08-23",
"chineseDate": "七月十一",
"momentUtc": "2026-08-23T02:27Z",
"nearMidnight": false
},
{
"longitude": 165,
"name": "白露",
"pinyin": "Báilù",
"english": "White Dew",
"date": "2026-09-07",
"chineseDate": "七月廿六",
"momentUtc": "2026-09-07T14:46Z",
"nearMidnight": false
},
{
"longitude": 180,
"name": "秋分",
"pinyin": "Qiūfēn",
"english": "Autumn Equinox",
"date": "2026-09-23",
"chineseDate": "八月十三",
"momentUtc": "2026-09-23T00:05Z",
"nearMidnight": false
},
{
"longitude": 195,
"name": "寒露",
"pinyin": "Hánlù",
"english": "Cold Dew",
"date": "2026-10-08",
"chineseDate": "八月廿八",
"momentUtc": "2026-10-08T06:26Z",
"nearMidnight": false
},
{
"longitude": 210,
"name": "霜降",
"pinyin": "Shuāngjiàng",
"english": "Frost's Descent",
"date": "2026-10-23",
"chineseDate": "九月十四",
"momentUtc": "2026-10-23T09:36Z",
"nearMidnight": false
},
{
"longitude": 225,
"name": "立冬",
"pinyin": "Lìdōng",
"english": "Start of Winter",
"date": "2026-11-07",
"chineseDate": "九月廿九",
"momentUtc": "2026-11-07T09:47Z",
"nearMidnight": false
},
{
"longitude": 240,
"name": "小雪",
"pinyin": "Xiǎoxuě",
"english": "Minor Snow",
"date": "2026-11-22",
"chineseDate": "十月十四",
"momentUtc": "2026-11-22T07:19Z",
"nearMidnight": false
},
{
"longitude": 255,
"name": "大雪",
"pinyin": "Dàxuě",
"english": "Major Snow",
"date": "2026-12-07",
"chineseDate": "十月廿九",
"momentUtc": "2026-12-07T02:46Z",
"nearMidnight": false
},
{
"longitude": 270,
"name": "冬至",
"pinyin": "Dōngzhì",
"english": "Winter Solstice",
"date": "2026-12-22",
"chineseDate": "冬月十四",
"momentUtc": "2026-12-21T20:50Z",
"nearMidnight": false
}
],
"notes": [
"Dates are China's calendar days (UTC+8; Beijing local mean time before 1929). momentUtc is calculated (Meeus) and good to a few minutes, so where nearMidnight is true another almanac may give the next or previous day. Checked against the Hong Kong Observatory: 4,789 of 4,800 dates in 1901-2100 agree, and every one that differs is marked nearMidnight."
]
}
curl --location --request GET 'https://zylalabs.com/api/14563/world+calendars+converter+api/37320/the+24+chinese+solar+terms+of+a+year?year=2026' --header 'Authorization: Bearer YOUR_API_KEY'
{
"calendars": [
{
"id": "gregorian",
"name": "Gregorian (proleptic)",
"range": {
"from": "0001-01-01",
"to": "9999-12-31"
}
},
{
"id": "hebrew",
"name": "Hebrew (fixed arithmetic calendar of Hillel II)",
"range": {
"from": "0001-01-01",
"to": "9999-12-31"
},
"months": [
{
"month": 1,
"name": "Nisan",
"nameHebrew": "ניסן"
},
{
"month": 2,
"name": "Iyyar",
"nameHebrew": "אייר"
},
{
"month": 3,
"name": "Sivan",
"nameHebrew": "סיון"
},
{
"month": 4,
"name": "Tamuz",
"nameHebrew": "תמוז"
},
{
"month": 5,
"name": "Av",
"nameHebrew": "אב"
},
{
"month": 6,
"name": "Elul",
"nameHebrew": "אלול"
},
{
"month": 7,
"name": "Tishrei",
"nameHebrew": "תשרי"
},
{
"month": 8,
"name": "Cheshvan",
"nameHebrew": "חשון"
},
{
"month": 9,
"name": "Kislev",
"nameHebrew": "כסלו"
},
{
"month": 10,
"name": "Tevet",
"nameHebrew": "טבת"
},
{
"month": 11,
"name": "Sh'vat",
"nameHebrew": "שבט"
},
{
"month": 12,
"name": "Adar (Adar I in leap years)",
"nameHebrew": "אדר"
},
{
"month": 13,
"name": "Adar II",
"nameHebrew": "אדר ב׳"
}
],
"notes": [
"Months are counted from Nisan (Tishrei = 7); leap years add Adar II (13). The day begins at sunset."
]
},
{
"id": "islamic",
"name": "Islamic (Hijri)",
"methods": [
{
"id": "umalqura",
"name": "Umm al-Qura (Saudi Arabia's official calendar; table)",
"range": {
"from": "1882-11-12",
"to": "2174-11-25",
"years": "1300-1600 AH"
},
"default": true
},
{
"id": "civil",
"name": "Tabular, civil epoch (Friday, July 16, 622)",
"range": {
"from": "0622-07-19",
"to": "9999-12-31"
}
},
{
"id": "tabular",
"name": "Tabular, astronomical epoch (Thursday, July 15, 622)",
"range": {
"from": "0622-07-18",
"to": "9999-12-31"
}
}
],
"months": [
{
"month": 1,
"name": "Muharram",
"nameArabic": "محرم"
},
{
"month": 2,
"name": "Safar",
"nameArabic": "صفر"
},
{
"month": 3,
"name": "Rabi al-Awwal",
"nameArabic": "ربيع الأول"
},
{
"month": 4,
"name": "Rabi al-Thani",
"nameArabic": "ربيع الآخر"
},
{
"month": 5,
"name": "Jumada al-Ula",
"nameArabic": "جمادى الأولى"
},
{
"month": 6,
"name": "Jumada al-Akhirah",
"nameArabic": "جمادى الآخرة"
},
{
"month": 7,
"name": "Rajab",
"nameArabic": "رجب"
},
{
"month": 8,
"name": "Sha'ban",
"nameArabic": "شعبان"
},
{
"month": 9,
"name": "Ramadan",
"nameArabic": "رمضان"
},
{
"month": 10,
"name": "Shawwal",
"nameArabic": "شوال"
},
{
"month": 11,
"name": "Dhu al-Qa'dah",
"nameArabic": "ذو القعدة"
},
{
"month": 12,
"name": "Dhu al-Hijjah",
"nameArabic": "ذو الحجة"
}
],
"note": "Calculated date. The start of an Islamic month is set by sighting the new crescent (or by a national authority) and can differ by 1-2 days by country; days begin at sunset the evening before. Not for religious rulings."
},
{
"id": "chinese",
"name": "Chinese lunisolar (农历, China Standard Time)",
"range": {
"from": "1899-02-10",
"to": "2101-01-28",
"years": "1899-2100"
},
"notes": [
"\"year\" is the Gregorian year in which the Chinese year begins; a leap month repeats the month before it (leap=true)."
]
}
],
"holidays": {
"hebrew": [
"major",
"minor",
"fast",
"modern",
"roshchodesh"
],
"islamic": [
"islamic"
],
"chinese": [
"chinese"
]
}
}
curl --location --request GET 'https://zylalabs.com/api/14563/world+calendars+converter+api/37321/supported+calendars+methods+ranges+and+month+names' --header 'Authorization: Bearer YOUR_API_KEY'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the World Calendars Converter API simply include your bearer token in the Authorization header.
| Header | Description |
|---|---|
Authorization
|
Required
Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.
|
No long-term commitment. Upgrade, downgrade, or cancel anytime.
Convert dates between Gregorian, Hebrew, Islamic and Chinese calendars; holidays by year.
Each endpoint returns structured data related to calendar conversions, including dates in various calendar systems (Gregorian, Hebrew, Islamic, Chinese), holiday information, and solar terms. The data includes details like year, month, day, and specific attributes relevant to each calendar type.
Key fields include "date," "year," "month," "monthName," "day," and "weekday" for dates; "holidays" for holiday details; and "terms" for solar terms. Each calendar type has unique fields, such as "monthLength" for Hebrew and "cycle" for Chinese.
Parameters vary by endpoint but generally include "date," "calendar," "year," "month," "day," and "afterSunset." For holidays, parameters like "calendarYear" and "include" (to filter holiday types) are also available.
The response data is organized into nested objects for each calendar type, with each object containing relevant fields. For example, the Gregorian date is under "gregorian," while Hebrew and Islamic dates are under their respective keys, allowing easy access to specific calendar information.
Typical use cases include converting dates for scheduling events across different cultures, planning holidays, and educational purposes. Users can also utilize the API to display current dates in various calendars for applications or websites.
Data accuracy is maintained through established calendar rules and algorithms for each calendar system. The API uses reliable sources, such as astronomical calculations for Islamic dates and fixed arithmetic for Hebrew dates, ensuring consistent results.
Users can customize requests by specifying parameters like the desired calendar type, date, and whether to include specific holiday categories. For example, using "israel=true" filters holidays according to Israeli observances.
Standard data patterns include consistent date formats (YYYY-MM-DD), structured responses with nested objects for each calendar type, and clear indications of leap years or special notes. Users can expect detailed information for each date conversion or holiday query.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund