get

/api/v1/chinese-calendar/date/{date}

Convert Gregorian date to Chinese lunar date

Overview

Converts a Gregorian date to its Chinese lunar calendar equivalent, including the lunar month, day, zodiac animal, and element.

Parameters

Name	Type	In	Required	Description
`date`	string	path	Yes	Gregorian date in YYYY-MM-DD format

Response

200 — Chinese date information

gregorian string required

lunar object required

year integer required

month integer required

day integer required

isLeapMonth boolean required

monthName object required

chinese string required
pinyin string required
meaning string

dayName string required

zodiacAnimal object required

english string required: Enum:
RatOxTigerRabbitDragonSnakeHorseGoatMonkeyRoosterDogPig
chinese string required

element object required

english string required: Enum:
WoodFireEarthMetalWater
chinese string required

stemBranch object required

combined string required
combinedPinyin string required

Example Request

cURL

curl "https://api.almuten.io/api/v1/chinese-calendar/date/{date}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "gregorian": "",
  "lunar": {
    "year": 0,
    "month": 1,
    "day": 1,
    "isLeapMonth": true,
    "monthName": {
      "chinese": "",
      "pinyin": "",
      "meaning": ""
    },
    "dayName": ""
  },
  "zodiacAnimal": {
    "english": "Rat",
    "chinese": ""
  },
  "element": {
    "english": "Wood",
    "chinese": ""
  },
  "stemBranch": {
    "combined": "",
    "combinedPinyin": ""
  }
}