Chinese Lunar Calendar

FREEMIUM
By copy2sim | Updated a month ago | Data
Popularity

8.7 / 10

Latency

459ms

Service Level

100%

Health Check

N/A

README

Get the Chinese lunar calendar date for any solar calendar dates from 1900-01-01 to 2100-12-31, with its sexagenary cycle, solar term, zodiac sign, and Chinese zodiac sign.

Sample requests:
url: https://chinese-lunar-calendar.p.rapidapi.com
params: {date: ‘20230124’, timezone: ‘480’, simplified: ‘1’}
params: {date: ‘20230124’}
params: {date: ‘20230124’, simplified: ‘0’}

Response in json:
status:

  • 0 if there’s an error, “msg” will be the error message.
  • 1 if successfully gets the relevant Chinese calendar information of the input date, “result” will contain all information about the date.

msg:

  • The error message if status is 0.

result:

  • It contains all relevant information about the date in Chinese lunar calendar.

solarDate:

  • The input solar date, which consists of 3 subcomponents: solarYear, solarMonth, solarDay.

lunarDate:

  • Its corresponding Chinese lunar calendar date, which has 4 subcomponents: lunarYear, lunarMonth, lunarDay, and isleap which indicates if it is a leap month. Examples: isleap = 1 stands for a leap month, otherwise isleap is 0.

lunarDateinChinese:

  • Combined month and day in Chinese calendar. Examples: “正月十五”, “闰二月廿一”

lunarYearinChinese:

  • Represents the translated lunarYear value in Chinese characters. For instance, if the lunarYear is 2023, lunarYearinChinese would be 二零二三. Please note that when obtaining a complete lunar date in Chinese for a given solar calendar date, it would be a combination of lunarYearinChinese, “年” (meaning “year” in Chinese), and lunarDate. This is due to the conventional date format in Chinese, which follows the pattern YYYYMMDD. For example, the full lunar date in Chinese would be 二零二三年六月十七 for a solar date of August 3, 2023.

sexagenaryCycle(a.k.a. Gan Zi):

solarTerm(a.k.a. Jie Qi):

solarTerminEnglish:

  • The English translation of the solar term. Return an empty string if it has no solar terms.

westernZodiacSign:

westernZodiacSigninEnglish:

  • The English translation of the zodiac sign.

chineseZodiacSign:

chineseZodiacSigninEnglish:

  • The English translation of the Chinese zodiac sign.

festival(in beta):

  • There were more than 100 festivals in Chinese history, many of them are no longer being celebrated, so it’s hard to identify all festivals. We picked 13 of them from China standard GB/T 33661-2017. They are: 春节, 元宵节, 龙头节, 上巳节, 清明节, 端午节, 七夕节, 中元节, 中秋节, 重阳节, 腊八节, 冬至节, 除夕. They are not necessarily the most popular ones. Make your own choice when appropriate. Return an empty string if it is not a festival.
Followers: 2
API Creator:
Rapid account: Copy 2 Sim
copy2sim
copy2sim
Log In to Rate API
Rating: 4.5 - Votes: 2