"다음주 화요일 오후 3시", "낼 저녁 7시에 보자", "이번 달 안에" 같은 한국어 문장에서 날짜를 뽑아 Date로 바꿔주는 TypeScript 라이브러리 ko-chrono를 만들어 npm에 올렸습니다.
영어는 chrono-node를 쓰면 되는데 한국어 로케일이 없길래 직접 만들기 시작했습니다. 개발하면서 chrono-node 메인 레포에도 한국어 기본 로케일 PR을 보내 얼마 전에 병합되었습니다 (https://github.com/wanasit/chrono/pull/685). 오늘·내일·요일·시각 같은 기본 표현은 다음 chrono-node 버전부터 chrono.ko로 사용하실 수 있고, 반복 일정이나 명절, 음력, 마감 표현 등 한국어 특화 파싱은 ko-chrono에만 포함되어 있습니다.
Playground (웹에서 바로 테스트): https://jwn7.github.io/ko-chrono/
주요 기능
상대 날짜·요일: 내일, 모레, 다음주 수요일, 지난 금요일, 담주 월욜
시각: 오후 3시, 3시 반, 세 시, 저녁, 자정
기간 및 마감: 3일 뒤, 이번 달 안에, 11월 1일부터 3일까지 ("까지" 표현은 end로 별도 추출)
반복 일정: 매주 월수금, 다음달까지 매주 화요일 (RRULE 문자열로 나와서 캘린더에 바로 넣을 수 있음)
명절·음력: 추석, 설 연휴, 음력 3월 3일 (한국천문연구원 데이터 기반, 현재 2025~2028년 지원)
비즈니스 표현: 금일, 익일, 차주 중
텍스트 분리 (parseEvent): "내일 저녁 7시 강남역에서 친구 만나기" → 제목과 시간 분리
.ics 파일 내보내기 지원
애매한 기준 처리 방식
한국어는 같은 말도 맥락이나 사람마다 다르게 해석되어, 기본 규칙을 정하고 테스트로 고정해두었습니다.
AM/PM 미지정 1~6시: "3시에 보자"처럼 오전/오후가 없으면 기본 15시로 간주하되, 결과값에 "애매함" 플래그와 새벽 3시 후보를 함께 반환합니다.
다음주 요일: "다음주 월요일"은 이번 주 기준 다음 주의 월요일을 의미합니다. (예: 금요일에 말하면 3일 뒤)
오탐 방지: "내가 낼게"의 '낼', "다음주 일정"의 '일'처럼 문맥상 날짜가 아닌 글자는 잡지 않도록 했습니다. (개발 중 가장 이슈가 많았던 부분입니다.)
기타 특징
런타임 의존성 0개, ESM/CJS 및 TypeScript 타입 지원
Timezone 옵션 지원 (UTC 서버 환경에서도 KST 기준 계산)
메신저 말투 문장과 무작위 패턴 포함 700여 개 테스트 케이스 패스
LLM과의 비교 및 활용안
Gemini Flash-Lite(무료 티어)에 메신저 문장 112개를 돌려봤을 때 문장당 평균 1초가 걸린 반면, ko-chrono는 0.02ms가 소요되었습니다. (물론 Gemini의 느린 응답은 무료 티어 대기열 영향일 수 있고, 테스트 문장 자체가 라이브러리를 만들며 개선해온 문장들이라 ko-chrono에 유리한 비교입니다. Gemini가 틀린 것 중 절반 정도는 "저녁"을 18시로 보는 식의 관례 차이였고, "새벽 3시에 깨서 못 잤어" 같은 과거형 문장은 ko-chrono가 시제를 몰라서 LLM이 더 잘 맞췄습니다.) 따라서 LLM을 전면 대체하기보다는, 확실한 날짜 표현은 ko-chrono로 먼저 처리하고 null이 나오거나 애매함 플래그가 붙은 것만 LLM으로 넘기는 식으로 쓰면 LLM 호출 횟수와 토큰이 꽤 줄 것 같습니다. (자세한 벤치마크는 레포의 bench/RESULTS.md에 정리해 두었습니다.)
피드백 요청
실제 메신저나 서비스 문장 중 못 잡거나 엉뚱하게 파싱되는 문장이 있다면 알려주세요. (Playground에서 테스트 후 알려주시면 테스트 케이스에 추가하겠습니다.)
"3시"를 오후 3시로 보는 디폴트 기준 등 해석 방식에 대한 의견도 환영합니다.
댓글 남겨주시면 답변드리겠습니다.