世界日历转换器 API

API ID 14563

在公历、犹太历、伊斯兰历和中国历之间转换日期;按年计算节假日

API 文档

端点

请求
给出一个公历“日期”(YYYY-MM-DD),或者一个包含“年”、“月”和“日”的“日历”。希伯来月份是名称(提斯利,哈希万,基斯勒夫,特维特,施法特,亚达,亚达 I,亚达 II,尼萨,伊亚尔,西万,塔木兹,亚夫,埃卢尔;常见拼写有效)或从尼萨开始的数字(尼萨 = 1,提斯利 = 7,亚达 = 12,亚达 II = 13)。伊斯兰月份是名称(拉马丹,沙瓦尔,杜尔希贾……)或1-12。中国月份为1-12,闰月标记为 leap=true;“年”为中国年开始的公历年份。不在其范围内的日历返回 { available: false, reason } 而不是猜测
Endpoint ID: 37316
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37316/convert+a+date+between+calendars
输入参数

在日历之间转换日期 — 端点功能

对象 描述
date 可选 A Gregorian date, YYYY-MM-DD (years 0001-9999).
calendar 可选 The calendar of year/month/day.
year 可选 Year in that calendar.
month 可选 Month: a number or a name.
day 可选 Day of the month.
leap 可选 Chinese only: the leap month.
to 可选 Calendars to return, comma-separated (default all four): gregorian, hebrew, islamic, chinese.
method 可选 Islamic method: umalqura (default; Saudi Arabia's official calendar, 1300-1600 AH), civil (tabular, Friday epoch) or tabular (Thursday epoch).
afterSunset 可选 true: the time is after sunset, so the Hebrew and Islamic dates are the next day's (their days begin at sunset). Gregorian and Chinese stay on the civil day.

剩余免费测试请求:3 / 3。


输入参数

date
calendar
year
month
day
leap
to
method
afterSunset
API 示例响应
JSON
{
    "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' 


    
请求
今天的日期是呼叫者所在的地方(IANA时区,默认为UTC),像/convert那样转换 希伯来和伊斯兰日从日落时开始 晚上传递afterSunset=true
Endpoint ID: 37317
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37317/today+in+every+calendar+in+a+time+zone
输入参数

今天在每个时区的日历中 — 端点功能

对象 描述
timezone 可选 IANA time zone, e.g. America/New_York, Asia/Jerusalem, Asia/Riyadh, Asia/Shanghai (default UTC).
to 可选 Calendars to return, comma-separated (default all four): gregorian, hebrew, islamic, chinese.
method 可选 Islamic method: umalqura (default; Saudi Arabia's official calendar, 1300-1600 AH), civil (tabular, Friday epoch) or tabular (Thursday epoch).
afterSunset 可选 true: the time is after sunset, so the Hebrew and Islamic dates are the next day's (their days begin at sunset). Gregorian and Chinese stay on the civil day.

剩余免费测试请求:3 / 3。


输入参数

timezone
to
method
afterSunset
API 示例响应
JSON
{
    "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' 


    
请求
每年每个月在其自身日历中的信息:编号,名称(希伯来文,阿拉伯文或中文书写),首日和末日的公历日期以及月份长度;包括年份长度,希伯来年份类型和闰年状态,伊斯兰方法,或者中国的闰月和干支年
Endpoint ID: 37318
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37318/a+year+s+months+with+their+gregorian+dates
输入参数

一年的月份及其公历日期 — 端点功能

对象 描述
calendar 必需 gregorian, hebrew, islamic or chinese.
year 必需 The year in that calendar (Hebrew 5787, Islamic 1448, Chinese 2026).
method 可选 Islamic only: umalqura (default), civil or tabular.

剩余免费测试请求:3 / 3。


输入参数

calendar
year
method
API 示例响应
JSON
{
    "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' 


    
请求
假期根据每个日历的规则计算,适用于公历“年份”(默认是今年;如果任何假期的日期落在这一年,则列出该假期)或该日历的自有年份(“calendarYear”:希伯来5787,伊斯兰1448,中文2026)。每个假期都有ID、名称、当地名称、开始和结束日期、天数、星期几、在其日历中的日期、开始的晚上(希伯来和伊斯兰)以及适用规则的备注。希伯来:israel=true 表示以色列的日程(为期一天的节日,西米哈托拉和喜悦节);include=选择类别(主要、次要、禁食、现代、农历新月;默认为所有除农历新月以外)。伊斯兰:方法如在 /convert 中所示。中文:传统节日(不包括政府安排的补班工作日)
Endpoint ID: 37319
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37319/jewish+islamic+or+chinese+holidays+for+a+year
输入参数

一年中的犹太教、伊斯兰教或中国节日 — 端点功能

对象 描述
calendar 必需 hebrew, islamic or chinese.
year 可选 Gregorian year (default: this year).
calendarYear 可选 The calendar's own year instead of a Gregorian one.
israel 可选 Hebrew only: Israel's schedule (default false = diaspora).
include 可选 Hebrew only: categories, comma-separated: major, minor, fast, modern, roshchodesh.
method 可选 Islamic only: umalqura (default), civil or tabular.

剩余免费测试请求:3 / 3。


输入参数

calendar
year
calendarYear
israel
include
method
API 示例响应
JSON
{
    "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' 


    
请求
每个术语在中国日历上的日期(UTC+8),在UTC中的时刻(准确到几分钟),中文名称,拼音,英文名称,太阳经度和中国农历日期 1901-2100年中的4789个日期与香港天文台的相等;其余11个日期在午夜附近并标记为近午夜(另一个年鉴可能给出前一天或后一天)
Endpoint ID: 37320
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37320/the+24+chinese+solar+terms+of+a+year
输入参数

一年中的24个节气 — 端点功能

对象 描述
year 可选 Gregorian year 1900-2100 (default: this year).

剩余免费测试请求:3 / 3。


输入参数

year
API 示例响应
JSON
{
    "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."
    ]
}
一年中的24个节气 — 代码片段

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' 


    
请求
支持的日历 方法 范围 和月份名称
Endpoint ID: 37321
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37321/supported+calendars+methods+ranges+and+month+names
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
{
    "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' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 世界日历转换器 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

在公历、希伯来历、伊斯兰历和农历之间转换日期;按年份列出假期

世界日历转换器 API FAQs

每个端点返回与日历转换相关的结构化数据,包括各种日历系统(公历、希伯来历、伊斯兰历、中国历)中的日期、节假日信息和节气数据。数据包括年份、月份、日期以及与每种日历类型相关的特定属性

关键字段包括“日期”、“年份”、“月份”、“月份名称”、“日”和“星期几”用于日期、“节假日”用于假期详情,以及“节气”用于太阳节气。每种日历类型都有独特的字段,例如希伯来语的“月份长度”和中文的“周期”

参数因端点而异,但通常包括“日期”、“日历”、“年”、“月”、“日”和“日落后”。对于节假日,还提供“日历年”和“包含”(以过滤假日类型)等参数

响应数据被组织成针对每种日历类型的嵌套对象,每个对象包含相关字段。例如,公历日期位于“gregorian”下,而希伯来和伊斯兰日期则位于各自的键下,便于访问特定的日历信息

典型的用例包括为跨不同文化的事件安排转换日期、规划假期和教育目的 用户还可以利用API在应用程序或网站上显示各种日历中的当前日期

数据准确性通过为每个日历系统建立的日历规则和算法得以保持 API使用可靠来源,例如伊斯兰日期的天文计算和希伯来日期的固定算术,确保结果一致

用户可以通过指定参数来自定义请求,如所需的日历类型、日期,以及是否包括特定的假日类别。例如,使用"israel=true"可以根据以色列的节日进行过滤

标准数据模式包括一致的日期格式(YYYY-MM-DD)、每种日历类型的嵌套对象结构化响应,以及对闰年或特殊备注的清晰指示。用户可以期望每个日期转换或假日查询的详细信息

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API