계산 방법과 정확도
Qelunai의 음력 계산 코드는 오픈 소스 라이브러리 qelunai-lunar로 분리되었습니다. 이 페이지는 라이브러리의 계산 방법과 공개된 베트남 달력과 대조한 항목, 아직 대조하지 않은 항목을 정리합니다.
음력은 어떻게 계산하나요
베트남 달력은 태음태양력입니다. 음력 한 달은 현지 시간 기준 삭일(새달)에 시작하며, 음력 날짜는 해당 날짜보다 늦지 않은 가장 최근 삭일부터 센 일수에 1을 더한 값입니다.
- 양력 날짜는 Fliegel과 Van Flandern(1968)의 공식으로 율리우스일(JDN)로 바꿉니다. Meeus의 《Astronomical Algorithms》(제2판, 1998)에 실린 공식입니다.
- 삭: 평균 삭망월 29.530588853일에 간략화한 주기 보정항을 더하고, 다항식 형태의 ΔT 근사값을 뺍니다.
- 태양 황경: 간략화한 3항 급수이며, 장동과 광행차 보정은 하지 않습니다.
- 변환 구조(삭, 11월, 윤달)는 Ho Ngoc Duc이 공개하고 여러 라이브러리가 사용하는 베트남 음력 알고리즘입니다.
- 기본 시간대는 UTC+7(베트남 시간)이며 기기의 시간대와 상관없습니다. 삭이나 중기가 자정 무렵이면 중국(UTC+8)이나 한국(UTC+9) 음력과 하루, 나아가 한 달이나 한 해가 차이 날 수 있습니다.
- 그레고리력만 씁니다. 1582-10-15 이전 날짜는 그레고리력을 거슬러 적용해 계산합니다.
윤달
- 11월은 동지가 든 음력 달입니다.
- 전년 11월 초부터 다음 11월 초까지가 365일보다 길면 그해는 음력 달이 13개입니다.
- 이때 윤달은 11월 뒤에 오는 첫 번째, 중기가 없는 달입니다. 윤달은 바로 앞 달의 숫자를 씁니다. 예를 들어 음력 2025년에는 윤6월이 있습니다.
- 음력 해는 정월 초하루에 바뀝니다.
그해에 없는 윤달(예: 2026년 윤6월)을 양력으로 바꾸려 하면 라이브러리는 해당 날짜가 없다고 알려 줍니다.
절기
- 24절기는 태양 황경을 15°씩 24구간으로 나눕니다. 춘분이 0°, 동지가 270°입니다.
- 하루의 절기는 현지 시간 자정에 유효한 절기로 정하므로, 절기가 바뀌는 날은 앞 절기의 마지막 날이 됩니다. 달력 행사 목록에는 인쇄된 달력처럼 새 절기 이름을 바뀌는 당일에 적습니다.
간지
- 일: 천간 = (JDN + 9) mod 10, 지지 = (JDN + 1) mod 12. 기준: 2024-02-10은 갑진일입니다.
- 음력 연도: 1984년이 갑자년이며, 천간과 지지는 1984년부터의 햇수로 정합니다.
- 음력 월: 오호둔 규칙에 따라 정월의 천간은 연간에서 정해지고 달마다 천간이 하나씩 나아갑니다. 지지는 고정되어 정월이 인, 섣달이 축입니다. 윤달은 같은 숫자 달의 간지를 씁니다.
황도일과 황도시
- 12신의 고정 순서: 청룡, 명당, 천형, 주작, 금궤, 보광, 백호, 옥당, 천뢰, 현무, 사명, 구진. 황도신 여섯: 청룡, 명당, 금궤, 보광, 옥당, 사명.
- 베트남 만세력이 날마다 싣는 황도·흑도 표를 따릅니다: 인/신 → 청룡이 자에; 묘/유 → 인; 진/술 → 진; 사/해 → 오; 오/자 → 신; 미/축 → 술; 나머지 신은 지지 순서대로 이어집니다.
- 황도일은 음력 월의 지지를 따르며, 윤달은 같은 숫자 달의 지지를 씁니다. 음력 월과 절기 월의 결과가 다른 9일 동안, 확인한 베트남 만세력은 모두 음력 월을 따랐습니다.
- 황도시는 일지를 따르며 12시진은 시계 시각입니다: 자시 23–1시, 축시 1–3시, …, 해시 21–23시. 23:00–24:00이 그날의 자시인지 다음 날의 자시인지는 학파마다 다르며, 라이브러리는 그날의 자시로 봅니다.
- 십이직(건, 제, 만, 평, 정, 집, 파, 위, 성, 수, 개, 폐)은 절기 월을 따릅니다. 삭일이 아니라 절기마다 바뀝니다(입춘 → 인, 경칩 → 묘, …).
검증: 변환과 간지
라이브러리의 테스트(75개)는 아래 값을 대조합니다. 출처 열은 테스트 코드에 적힌 내용 그대로입니다.
| 항목 | 대조한 값 | 테스트에 적힌 출처 |
|---|---|---|
| 뗏(음력 1월 1일) | 2023-01-22, 2024-02-10, 2025-01-29, 2026-02-17, 2027-02-06 | 독립된 여러 베트남 언론(주소 없음) |
| 훙왕 기일(음력 3월 10일) | 2024-04-18, 2025-04-07 | 주소 없음 |
| 윤달 유무 | 음력 2023년 윤2월, 2025년 윤6월(존재 여부만 확인, 시작일은 미확인) | 공개 자료(주소 없음) |
| 연간지 | 2023 계묘, 2024 갑진, 2025 을사, 2026 병오, 2027 정미 | 위 뗏의 해 이름 |
| 일간지 | 2024-02-10 = 갑진 | 여러 베트남 만세력(주소 없음) |
| 월간지 | 2024년 정월 = 병인 | 별도 출처 없음 |
| 내부 일관성 | 1900–2100년의 모든 날짜에서 양력 → 음력 → 양력 변환 결과가 원래 날짜와 같음 | 외부 출처 없음 |
검증: 황도일, 십이직, 절기
일신은 달력 웹사이트와 대조했으며 접속일은 2026-10-28입니다. 9일 모두 음력 월과 절기 월의 결과가 다른 날입니다.
| 날짜 | 간지 | 일신 | 출처 |
|---|---|---|---|
| 2025-02-01 | 신축 | 명당 | baoquocte.vn |
| 2025-05-01 | 경오 | 청룡 | vtcnews.vn |
| 2025-08-14(음력 윤6월 21일) | 을묘 | 보광 | ngaydep.com |
| 2026-02-10 | 을묘 | 보광 | ngaydep.com |
| 2026-06-10 | 을묘 | 현무 | ngaydep.com |
| 2026-08-09 | 을묘 | 보광 | ngaydep.com |
| 2026-10-09 | 병진 | 천형 | ngaydep.com · xemlicham.com |
| 2026-11-08 | 병술 | 백호 | ngaydep.com · xemlicham.com |
| 2026-12-08 | 병진 | 사명 | ngaydep.com |
황도시 대조: 2025-02-01(12시진 전부, baoquocte.vn), 2025-05-01(vtcnews.vn · baolamdong.vn), 2026-02-10(xemlicham.com · baohatinh.vn · ngaydep.com), 2026-10-09(xemlicham.com · ngaydep.com), 2026-10-28(xemlicham.com). 2025–2026년의 모든 날짜에 대해 황도시가 정확히 6개인지 테스트합니다.
십이직: 2026-10-28과 2026-02-10은 제(除)입니다(xemlicham.com · ngaydep.com). 2026-02-10은 음력 섣달 23일이지만 입춘이 지났으므로 절기 월로는 제, 음력 월로는 만이 됩니다.
절기: 2026–2027년의 모든 날짜에서 절기 구간은 14–16일이고 경계는 실제로 절기가 바뀌는 곳입니다. 이는 내부 일관성 검사입니다. 라이브러리에서는 절기 날짜를 공식 천문 자료와 아직 대조하지 않았습니다. Qelunai 앱은 미국 해군 천문대의 2024년 춘분·하지·추분·동지 시각으로 태양 황경 함수를 검사합니다.
테스트의 다른 예시 날짜(초하루, 보름, 기일 예시, 2025년 윤6월 시작일)는 알고리즘이 계산한 값이며 외부 출처와 아직 대조하지 않았습니다.
한계
- 공개된 달력과 대조한 범위: 위의 날짜들, 2023–2027년 안. 이 범위 밖의 결과는 같은 방법으로 계산하지만 대조하지 않았습니다.
- "대략 1200–3000년에 신뢰할 수 있다"는 수치는 같은 계열 알고리즘을 쓰는 다른 라이브러리가 밝힌 것이며, qelunai-lunar가 직접 확인하지 않았습니다.
- 간략화한 급수와 ΔT 근사 때문에 드물게 삭이나 절기가 자정을 넘어가 달의 경계가 하루 어긋날 수 있습니다.
- 베트남 음력과 중국·한국 음력을 비교하는 테스트는 아직 없습니다.
- 고정밀 천문 계산에는 적합하지 않습니다.
문화 콘텐츠는 참고용입니다
황도일, 황도시, 십이직, 기일은 전통 관습입니다. 라이브러리는 테스트에서 확인한 베트남 달력을 따르며, 다른 전통은 다를 수 있습니다.
기일 규칙은 라이브러리가 정한 것으로 외부 출처와 대조하지 않았습니다: 윤달에 돌아가신 분은 같은 숫자의 평달에 기일을 지내고, 30일에 돌아가신 분은 큰달이면 30일, 작은달이면 29일에 지냅니다.
이 내용은 문화적 참고 자료이며 전문적인 조언이 아닙니다.
오픈 소스 라이브러리
qelunai-lunar는 순수 Dart로 작성되었고 Qelunai 앱에서 분리되었으며 MIT 라이선스로 공개됩니다. 소스 코드, 테스트, 전체 방법 문서: https://github.com/qelunai/qelunai-lunar