Conversor de Calendários do Mundo API

API ID 14563

Converter datas entre os calendários gregoriano, hebraico, islâmico e chinês feriados por ano

Documentação da API

Endpoints

Requisição
Forneça uma "data" gregoriana (AAAA-MM-DD), ou um "calendário" com "ano", "mês" e "dia". Os meses hebraicos são nomes (Tishrei, Cheshvan, Kislev, Tevet, Shvat, Adar, Adar I, Adar II, Nisan, Iyyar, Sivan, Tamuz, Av, Elul; grafias comuns funcionam) ou números contados a partir de Nisan (Nisan = 1, Tishrei = 7, Adar = 12, Adar II = 13). Os meses islâmicos são nomes (Ramadã, Shawwal, Dhu al-Hijjah...) ou números de 1 a 12. Os meses chineses são de 1 a 12 com leap=true para um mês bissexto; "ano" é o ano gregoriano em que o ano chinês começa. Um calendário fora de seu alcance responde { disponível: false, motivo } em vez de um palpite
Endpoint ID: 37316
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37316/convert+a+date+between+calendars
PARÂMETROS DE ENTRADA

Converter uma data entre calendários — Recursos do endpoint

Objeto Descrição
date Opcional A Gregorian date, YYYY-MM-DD (years 0001-9999).
calendar Opcional The calendar of year/month/day.
year Opcional Year in that calendar.
month Opcional Month: a number or a name.
day Opcional Day of the month.
leap Opcional Chinese only: the leap month.
to Opcional Calendars to return, comma-separated (default all four): gregorian, hebrew, islamic, chinese.
method Opcional Islamic method: umalqura (default; Saudi Arabia's official calendar, 1300-1600 AH), civil (tabular, Friday epoch) or tabular (Thursday epoch).
afterSunset Opcional 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.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

date
calendar
year
month
day
leap
to
method
afterSunset
RESPOSTA DE EXEMPLO DA 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
    }
}
Converter uma data entre calendários — TRECHOS DE CÓDIGO

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' 


    
Requisição
Data de hoje onde o chamador está (um fuso horário IANA, padrão UTC) convertido como /convert Dias hebraicos e islâmicos começam ao pôr do sol; passe afterSunset=true à noite
Endpoint ID: 37317
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37317/today+in+every+calendar+in+a+time+zone
PARÂMETROS DE ENTRADA

Hoje em cada calendário em um fuso horário — Recursos do endpoint

Objeto Descrição
timezone Opcional IANA time zone, e.g. America/New_York, Asia/Jerusalem, Asia/Riyadh, Asia/Shanghai (default UTC).
to Opcional Calendars to return, comma-separated (default all four): gregorian, hebrew, islamic, chinese.
method Opcional Islamic method: umalqura (default; Saudi Arabia's official calendar, 1300-1600 AH), civil (tabular, Friday epoch) or tabular (Thursday epoch).
afterSunset Opcional 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.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

timezone
to
method
afterSunset
RESPOSTA DE EXEMPLO DA 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
    }
}
Hoje em cada calendário em um fuso horário — TRECHOS DE CÓDIGO

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' 


    
Requisição
Todo mês de um ano em seu próprio calendário: número, nome (escrita hebraica, árabe ou chinesa também), primeiro e último dia gregoriano e duração; com a duração do ano, tipo de ano hebraico e status de bissexto, o método islâmico, ou o mês bissexto chinês e ano sexagenário
Endpoint ID: 37318
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37318/a+year+s+months+with+their+gregorian+dates
PARÂMETROS DE ENTRADA

Um ano de meses com suas datas gregorianas — Recursos do endpoint

Objeto Descrição
calendar Obrigatório gregorian, hebrew, islamic or chinese.
year Obrigatório The year in that calendar (Hebrew 5787, Islamic 1448, Chinese 2026).
method Opcional Islamic only: umalqura (default), civil or tabular.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

calendar
year
method
RESPOSTA DE EXEMPLO DA 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
        }
    ]
}
Um ano de meses com suas datas gregorianas — TRECHOS DE CÓDIGO

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' 


    
Requisição
Feriados computados a partir das regras de cada calendário, para um "ano" gregoriano (padrão deste ano; um feriado é listado se algum de seus dias cair no ano) ou para o próprio ano do calendário ("calendarYear": hebraico 5787, hijri 1448, chinês 2026). Cada um tem id, nome, nome local, primeiro e último dia, número de dias, dia da semana, a data em seu próprio calendário, a noite em que começa (hebraico e islâmico) e notas sobre as regras aplicadas. Hebraico: israel=true para o cronograma de Israel (festivais de um dia, Simchat Torá com Shmini Atzeret); include= seleciona categorias (maior, menor, jejum, moderno, roshchodesh; padrão todos, exceto roshchodesh). Islâmico: método como em /convert. Chinês: festivais tradicionais (não dias úteis compensatórios do governo)
Endpoint ID: 37319
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37319/jewish+islamic+or+chinese+holidays+for+a+year
PARÂMETROS DE ENTRADA

feriados judaicos islâmicos ou chineses por um ano — Recursos do endpoint

Objeto Descrição
calendar Obrigatório hebrew, islamic or chinese.
year Opcional Gregorian year (default: this year).
calendarYear Opcional The calendar's own year instead of a Gregorian one.
israel Opcional Hebrew only: Israel's schedule (default false = diaspora).
include Opcional Hebrew only: categories, comma-separated: major, minor, fast, modern, roshchodesh.
method Opcional Islamic only: umalqura (default), civil or tabular.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

calendar
year
calendarYear
israel
include
method
RESPOSTA DE EXEMPLO DA 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)."
    ]
}
Feriados judaicos islâmicos ou chineses por um ano — TRECHOS DE CÓDIGO

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' 


    
Requisição
A data de cada termo no calendário da China (UTC+8) seu momento em UTC (preciso para alguns minutos) nome chinês pinyin nome em inglês longitude solar e a data lunar chinesa 4.789 das 4.800 datas em 1901-2100 equivalem ao do Observatório de Hong Kong 11 das outras estão a poucos minutos da meia-noite e marcadas perto da meia-noite (outro almanaque pode dar o dia seguinte ou anterior)
Endpoint ID: 37320
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37320/the+24+chinese+solar+terms+of+a+year
PARÂMETROS DE ENTRADA

Os 24 termos solares chineses de um ano — Recursos do endpoint

Objeto Descrição
year Opcional Gregorian year 1900-2100 (default: this year).

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

year
RESPOSTA DE EXEMPLO DA 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."
    ]
}
Os 24 termos solares chineses de um ano — TRECHOS DE CÓDIGO

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' 


    
Requisição
Calendários suportados métodos intervalos e nomes de meses
Endpoint ID: 37321
GET https://zylalabs.com/api/14563/world+calendars+converter+api/37321/supported+calendars+methods+ranges+and+month+names
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA 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"
        ]
    }
}
Métodos de calendário suportados intervalos e nomes dos meses — TRECHOS DE CÓDIGO

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' 


    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Conversor de Calendários do Mundo API basta incluir seu token Bearer no cabeçalho Authorization.

Cabeçalhos
Cabeçalho Descrição
Authorization Obrigatório Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.

A partir de
$10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Visão Geral

Converta datas entre os calendários gregoriano, hebraico, islâmico e chinês; feriados por ano

Conversor de Calendários do Mundo API FAQs

Cada ponto final retorna dados estruturados relacionados a conversões de calendário, incluindo datas em vários sistemas de calendário (gregoriano, hebraico, islâmico, chinês), informações sobre feriados e termos solares. Os dados incluem detalhes como ano, mês, dia e atributos específicos relevantes para cada tipo de calendário

Os campos principais incluem "data" "ano" "mês" "nomeDoMês" "dia" e "diaDaSemana" para datas "feriados" para detalhes de feriados e "termos" para termos solares. Cada tipo de calendário tem campos únicos como "comprimentoDoMês" para hebraico e "ciclo" para chinês

Os parâmetros variam por endpoint, mas geralmente incluem "data", "calendário", "ano", "mês", "dia" e "após o pôr do sol". Para feriados, parâmetros como "anoCalendário" e "incluir" (para filtrar tipos de feriados) também estão disponíveis

Os dados de resposta estão organizados em objetos aninhados para cada tipo de calendário, com cada objeto contendo campos relevantes. Por exemplo, a data gregoriana está sob "gregoriano", enquanto as datas hebraicas e islâmicas estão sob suas chaves respectivas, permitindo fácil acesso a informações específicas do calendário

Casos de uso típicos incluem a conversão de datas para agendar eventos em diferentes culturas, planejar feriados e propósitos educacionais. Os usuários também podem utilizar a API para exibir datas atuais em vários calendários para aplicações ou sites

A precisão dos dados é mantida através de regras e algoritmos de calendário estabelecidos para cada sistema de calendário A API utiliza fontes confiáveis como cálculos astronômicos para datas islâmicas e aritmética fixa para datas hebraicas garantindo resultados consistentes

Os usuários podem personalizar pedidos especificando parâmetros como o tipo de calendário desejado, data e se devem incluir categorias específicas de feriados. Por exemplo, usar "israel=true" filtra os feriados de acordo com as observâncias israelenses

Padrões de dados padrão incluem formatos de data consistentes (YYYY-MM-DD) respostas estruturadas com objetos aninhados para cada tipo de calendário e indicações claras de anos bissextos ou notas especiais Os usuários podem esperar informações detalhadas para cada conversão de data ou consulta de feriados

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas