{"repo":"kahyou22/kor-lunar-js","free":true,"listed":false,"github":"https://github.com/kahyou22/kor-lunar-js","clone":"git clone https://github.com/kahyou22/kor-lunar-js.git","description":"한국 음력 변환 유틸 / Korean lunar calendar converter","language":"TypeScript","stars":41,"topics":["calendar","korean","lunar"],"license":"MIT","category":"productivity","readme_excerpt":"kor-lunar 한국천문연구원(KASI) 데이터 기반의 음력 ↔ 양력 변환 과 음력 날짜 연산 (가감·비교·간지) 라이브러리입니다. 1890 2050년 · 오프라인 동작 · 경량 번들 · Zero Dependencies · TypeScript 타입 내장 변환 데이터는 한국천문연구원(KASI) 공개 데이터를 기반으로 하며, 기준일은 2025년 5월 20일 입니다. 기준일 이후의 데이터 개정은 반영되지 않았을 수 있습니다 — 최신 데이터는 KASI 공식 API에서 확인할 수 있습니다. 예제 사이트에서 바로 사용해볼 수 있습니다. 설치 브라우저 CDN CDN 사용 시 전역 변수 korLunar 로 접근할 수 있습니다. 예기치 않은 변경을 방지하기 위해 메이저 버전을 고정 하는 것을 권장합니다. 사용법 모듈 불러오기 Named export도 지원합니다: 양력 → 음력 음력 → 양력 음력 날짜 연산 — LunarCalendar 불변(immutable) 클래스입니다. 모든 연산은 원본을 바꾸지 않고 새 객체를 반환합니다. 명절 날짜 구하기 알아둘 것 - 지원 범위 : 양력 1890-01-21 2050-12-31, 음력 1890-01-01 2050-11-18. 벗어나면 RangeError 가 발생합니다. - toLunar / toSolar 는 날짜의 실존 여부를 검증하지 않습니다 (예: 없는 윤달, 30일이 없는 달의 30일). 검증이 필요하면 LunarCalendar.isValid (boolean) 또는 LunarCalendar.of (RangeError)를 사용하세요. - 윤달에는 공식 월건이 없어 wolgeon / wolgeonHanja 가 빈 문자열입니다. 앞 달의 월건을 따르는 관례가 필요하면 LunarTable.getWolgeon(year, month) 를 직접 호출하세요. - LunarCalendar.today() 는 실행 환경의 로컬 시간 기준 입니다. UTC 서버에서 한국 기준 '오늘'이 필요하면 KST로 변환한 날짜를 fromSolar 에 넘기세요. - 저수준 유틸 (월별 일수, 윤달 위치, 간지 계산 등)은 LunarTable / SolarTable 네임스페이스로 직접 접근할 수 있습니다 — 예제: 윤달이 있는 해 기여 · 라이선스 버그 제보, 기능 제안, 질문 모두 환영합니다 — Issues · Discussions MIT · 출처: 한국천문연구원 · 공공데이터포털 음양력 API","default_branch":null,"files":null,"tree":[],"storefront":"/r/kahyou22","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/kahyou22/kor-lunar-js/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}