중국 점성술과 달력

띠 동물은 전통에서 가장 잘 알려진 부분이며 가장 자주 잘못 계산됩니다. BaZi에서 한 해는 1월 1일이나 중국 설날에 시작하는 것이 아니라, 태양의 겉보기 황경이 315°에 도달하는 순간인 입춘(立春) Lichun에 시작합니다. 2026년에는 2026-02-03T20:02:08Z이며, 이는 베이징 시간으로 2월 4일 04:02입니다. 2월 2일에 태어난 사람은 벽에 걸린 달력이 이미 새해를 가리키고 있더라도 이전 띠 동물에 속합니다.

엔드포인트

엔드포인트	크레딧	반환 값
POST /v1/chinese/zodiac/animal	10	띠 동물, 기둥, 지지와 천간의 오행
POST /v1/chinese/zodiac/element	10	지지의 고정 오행과 천간의 순환 오행
POST /v1/chinese/zodiac/inner-animal	10	내면의 동물: 월지
POST /v1/chinese/zodiac/secret-animal	10	비밀의 동물: 시지
POST /v1/chinese/zodiac/compatibility	10	삼합(三合)과 육충(六冲)에 따른 두 띠 동물의 궁합
POST /v1/chinese/lunar-date	10	음력 날짜, 윤달, 중국 설날
POST /v1/chinese/solar-terms	10	초 단위 정확도로 연간 24절기 모두

세 가지 띠 동물, 하나가 아닌

잡지에서 다루는 운세는 하나의 띠 동물만 압니다. 전통에서는 세 가지를 알며, 이들은 서로 다른 질문에 답합니다.

띠 동물	출처	의미
외면의	연지	다른 사람들이 그 사람을 보는 방식
내면의	월지	동기, 사적인 ‘나’
비밀의	시지	가장 깊은 층, 종종 본인에게도 숨겨져 있음

내면의 동물은 월의 중간이 아닌 정확한 절(節)의 순간에 의해 결정되므로, 5월 5일과 5월 6일에 태어난 사람들은 다른 띠 동물을 가질 수 있습니다.

curl -X POST https://api.astroway.info/v1/chinese/zodiac/inner-animal \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3}'

{
  "ok": true,
  "data": {
    "innerAnimal": "Snake",
    "glyph": "🐍",
    "description": "Inner animal = the BaZi month branch, bounded by the exact 節 instants. Represents internal motivations and the private self."
  }
}

연간 두 가지 오행

1990년에 태어난 사람은 “금(金) 말”이며, 이 이름에는 쉽게 혼동될 수 있는 두 가지 다른 오행이 있습니다.

• 순환 오행은 천간에서 오며 2년마다 바뀝니다: 庚은 금(金)입니다.
• 고정 오행은 지지에 영원히 속합니다: 午는 불(火)이며, 말은 항상 불의 속성을 가집니다.

/chinese/zodiac/element는 클라이언트를 대신하여 선택하는 대신, fixedElement와 cyclingElement라는 별도의 필드로 두 가지를 모두 반환합니다.

궁합

평가는 삼합(三合, 세 가지 조화)과 육충(六冲, 여섯 가지 충돌)을 기반으로 하며, 이는 의견 목록이 아닌 지지 원의 기하학에 기반합니다.

curl -X POST https://api.astroway.info/v1/chinese/zodiac/compatibility \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"date":"1990-05-15"},"person2":{"date":"1988-02-20"}}'

{
  "person1": { "solarYear": 1990, "animal": "Horse" },
  "person2": { "solarYear": 1988, "animal": "Dragon" },
  "compatibility": {
    "score": 65,
    "category": "good",
    "notes": ["Compatible enough; complementary differences."]
  }
}

띠 동물의 궁합은 하나의 층일 뿐, 전체 차트가 아닙니다

띠 동물을 비교하는 것은 가장 거친 단면입니다. 이는 사람에 대해 여덟 글자 중 단 한 글자만 아는 것입니다. 실제 풀이를 위해서는 두 사람의 /v1/bazi/chart를 가져와 네 기둥의 모든 상호작용을 살펴보세요.

음력 날짜

curl -X POST https://api.astroway.info/v1/chinese/lunar-date \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-02-17"}'

{
  "gregorianDate": "2026-02-17",
  "lunar": { "month": 1, "isLeapMonth": false, "day": 1, "monthStart": "2026-02-17", "label": "month 1, day 1" },
  "chineseNewYear": "2026-02-17"
}

월은 베이징 시간으로 초승달이 포함된 날에 시작합니다. 윤달은 이전 달의 번호를 반복하며 중기(中氣)를 포함하지 않습니다. 이것이 윤달이 존재하는 이유이지 부작용이 아닙니다.

1929년 이전

1929년 이전의 달력은 베이징 현지 평균 시간(UTC+7:45:40)으로 계산되며, 이는 우리의 관례가 아닌 역사적 기반입니다. 현지 자정 근처에 초승달이 뜨는 경우, 그 당시의 인쇄된 책력은 날짜 단위로 계산되었기 때문에 책력보다 하루 늦게 월이 시작될 수 있습니다.

24절기

절기는 표에 있는 날짜가 아니라 태양의 겉보기 황경이 15°의 배수가 되는 순간입니다. 우리는 이를 천문력에서 가져오므로, 도메인 내의 어떤 해에도 동일한 응답을 제공하며, 누군가가 표를 업데이트했는지 여부에 영향을 받지 않습니다.

curl -X POST https://api.astroway.info/v1/chinese/solar-terms \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

terms 배열에는 24절기 모두가 포함되어 있으며, 여기서는 첫 번째가 표시됩니다:

{
  "year": 2026,
  "terms": [
    {
      "index": 0,
      "chinese": "立春",
      "pinyin": "Lichun",
      "english": "Start of Spring",
      "sunLongitude": 315,
      "utc": "2026-02-03T20:02:08Z",
      "beijing": "2026-02-04T04:02:08+08:00",
      "opensPillarMonth": true
    }
  ]
}

24절기 중 12개는 opensPillarMonth: true를 가집니다. 이들은 기둥 월을 시작하는 절(節)입니다. 나머지 12개는 중기(中氣)이며, 이들은 월을 반으로 나누고 어떤 월이 윤달이 될지 결정합니다.

절기는 날이 아닌 순간이며, 그 날은 다릅니다

사용자가 중국에 있지 않다면 beijing 대신 utc를 읽으세요. 중국과 홍콩은 UTC+8, 일본과 한국은 UTC+9, 베트남은 UTC+7을 사용하므로, 24시간 중 한 시간은 국가별 책력에서 다른 달력 날짜를 인쇄하는 창이 됩니다. 평균적으로 연간 하나의 절기가 그렇습니다. 2026년에는 두 개가 있습니다: 우수(雨水)는 베이징에서 2월 18일, 도쿄에서 2월 19일이며, 망종(芒種)은 6월 5일과 6일입니다. 우리의 순간은 두 가지 출판물 모두를 분 단위 정확도로 재현합니다.

언어

띠 동물과 오행은 21개 언어로 번역되었습니다. ?lang= 또는 본문에 "language"를 추가하면 영어 토큰 옆에 *Name 필드가 나타납니다:

curl -X POST "https://api.astroway.info/v1/chinese/zodiac/animal?lang=es" \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15"}'

{ "animal": "Horse", "animalName": "Caballo", "element": { "fixed": "Fire", "fixedName": "Fuego" } }

영어 필드는 영구적으로 유지됩니다. 현지화는 추가하는 것이지 대체하는 것이 아닙니다.