CRON 표현식 빌더/해석기
Unix·Quartz·AWS·Kubernetes CRON 문법을 빌드·해석하고 다음 실행 시각(3/5/10)을 미리 검증해 스케줄 오동작을 줄이는 개발자 도구입니다.
CRON 표현식 빌더/해석기
Unix, Quartz, AWS EventBridge, Kubernetes(CronJob) 다이얼렉트를 기준으로 CRON 표현식을 조합·해석하고 다음 실행 시각을 미리 확인할 수 있는 개발자 도구입니다.
기본 설정
Unix는 분 시 일(일자) 월 요일 5필드를 사용합니다.
작업 모드
각 필드를 입력해 다이얼렉트에 맞는 표현식을 생성합니다.
생성 미리보기: -
표현식을 붙여 넣어 유효성, 해석 요약, 다음 실행 시간을 확인합니다.
Kubernetes 매크로(@yearly, @daily 등)는 Kubernetes 다이얼렉트에서만 허용됩니다.
표현식을 처리하고 있습니다.
검증 상태
아직 계산하지 않았습니다. Build 또는 Calculate/Interpret 버튼을 클릭하세요.
- 결과 스켈레톤은 항상 표시되며, 오류가 있어도 검증 메시지와 표는 유지됩니다.
해석 요약
표현식 해석 결과가 이 영역에 표시됩니다.
필드 분해
| 필드 | 입력값 | 해석 | 상태 |
|---|---|---|---|
| 아직 해석 데이터가 없습니다. | |||
다음 실행 미리보기
표시 시간대: –
| # | 실행 시각 | 현재로부터 |
|---|---|---|
| 1 | Build/Interpret 실행 후 채워집니다. | – |
실행 간격 표
표시 기준: 현재→1회차, 이후는 연속 실행 간격(n→n+1)입니다.
차트는 비활성화되어 실행 간격 표로 제공합니다.
| 구간 | 간격(분) |
|---|---|
| 현재→1회차 | 데이터 없음 |
모델링 제약 안내
- 이 도구는 실무 점검을 위한 경량 해석기이며, 모든 벤더 확장 문법을 100% 실행 보장하는 엔터프라이즈 파서를 대체하지 않습니다.
- Quartz/AWS의
?,L,W,#토큰은 설명형/부분 지원으로 처리되며, 복합 규칙은 공식 문서 재확인이 필요합니다. - 다음 실행 계산은 분 단위 전진 탐색(max iteration guard)으로 계산되며, 브라우저 로컬 시간 기준으로 표시합니다.
CRON 표현식 빌더/해석기란?
CRON 표현식은 스케줄 자동화의 핵심이지만, 플랫폼마다 필드 수와 문법이 달라 실수하기 쉽습니다. 이 도구는 자주 사용하는 4개 다이얼렉트(Unix, Quartz, AWS EventBridge, Kubernetes)를 한 화면에서 다루도록 설계되어 표현식 작성과 해석 검증을 동시에 진행할 수 있습니다.
특히 운영 중인 배치 작업에서 “문법은 맞는데 의도한 시각에 실행되지 않는” 문제를 줄이기 위해, 필드 단위 해석표와 다음 실행 미리보기를 같이 제공합니다. 따라서 단순 문법 체크를 넘어 스케줄 의미를 빠르게 검토하는 데 도움이 됩니다.
이런 상황에서 활용해 보세요
신규 배치 작업을 등록할 때 Builder 모드에서 필드를 조합해 표현식을 만들고 바로 해석 결과를 검증할 수 있습니다. 팀 코드리뷰에서는 Interpreter 모드에 실제 표현식을 붙여넣어 다음 실행 시각이 기대와 맞는지 빠르게 확인하는 흐름이 유용합니다.
또한 기존 시스템을 다른 플랫폼으로 마이그레이션할 때 다이얼렉트를 바꿔 비교하면, ? 필수 여부나 요일 숫자 기준 차이처럼 놓치기 쉬운 포인트를 사전에 점검할 수 있습니다.
주요 기능
다이얼렉트 전환: Unix(5), Quartz(6/7), AWS EventBridge(6), Kubernetes(5+매크로) 규칙을 선택해 같은 UI에서 비교할 수 있습니다.
Builder + Interpreter 탭: 필드 기반 생성과 텍스트 기반 해석을 분리해 작업 목적에 맞는 흐름을 제공합니다.
검증 + 해석 요약: 유효성 결과, 필드 분해표, 경고 메시지를 한 번에 보여 주어 빠른 코드리뷰가 가능합니다.
다음 실행 미리보기: 기본 5개(3/10 선택 가능) 실행 시각을 분 단위 탐색으로 계산해 일정이 실제로 어떻게 전개되는지 확인할 수 있습니다.
차트 fallback: Chart.js를 사용할 수 없는 환경에서도 텍스트+표로 동일 정보를 확인할 수 있습니다.
사용 방법
1) 먼저 다이얼렉트와 미리보기 개수를 선택합니다. 2) Builder 탭에서는 각 필드를 입력하고 Build 버튼을 누르거나, Interpreter 탭에서는 표현식을 입력한 뒤 Calculate/Interpret 버튼을 클릭합니다.
버튼을 누르면 결과 영역으로 자동 스크롤되며 검증 상태·해석 요약·다음 실행 시각이 갱신됩니다. 오류가 있으면 결과 영역 자체는 유지된 채 검증 패널에 오류가 표시되므로, 어떤 부분을 수정해야 하는지 즉시 확인할 수 있습니다.
CRON 다이얼렉트 상세 설명
다이얼렉트마다 필드 개수와 토큰 해석이 다릅니다. 예를 들어 Quartz/AWS는 일(DOM)과 요일(DOW) 중 하나에 ?를 요구하는 경우가 많고, Kubernetes는 5필드 + 매크로를 사용합니다. 본 도구는 이 차이를 반영해 검증 메시지를 분기합니다.
다만 이 도구는 “실무 검토용 경량 파서”를 목표로 하며, 복합 벤더 확장 문법을 완전하게 실행 보장하는 엔진은 아닙니다. 따라서 경고(부분 지원)가 표시되면 실제 배포 전에 사용 중인 런타임 문서를 반드시 재확인하세요.
기준 문서 확인일: 2026-02-28
공식 참고 문서: crontab(5) – Linux man-pages, Quartz CronTrigger Tutorial, AWS EventBridge cron expressions, Kubernetes CronJob.
자주 묻는 질문
이 도구가 모든 CRON 문법을 완전히 지원하나요?
아닙니다. 핵심 문법과 자주 쓰는 특수 토큰 중심으로 검증하며, 일부 복합 규칙은 부분 지원 경고를 표시합니다. 운영 반영 전에는 해당 플랫폼 공식 문서를 함께 확인하는 것을 권장합니다.
왜 Quartz/AWS에서 DOM과 DOW에 동시에 값을 넣으면 오류가 나나요?
Quartz/AWS 계열에서는 일(DOM)과 요일(DOW) 규칙에 ? 사용 제약이 있어 둘을 동시에 구체 지정하면 의도 해석이 충돌할 수 있습니다. 이 도구는 그 충돌 가능성을 검증 오류로 안내합니다.
다음 실행 시각 계산은 어떤 방식인가요?
브라우저 로컬 시간 기준으로 분 단위 전진 탐색을 수행하고, 무한 루프를 막기 위한 최대 반복 횟수(max iteration guard)를 적용합니다. 제한에 걸리면 경고 메시지를 보여 줍니다.
Chart.js가 차단된 환경에서는 결과를 볼 수 없나요?
볼 수 있습니다. 차트가 로드되지 않으면 자동으로 fallback 안내 문구와 표 데이터를 유지해, 동일한 실행 간격 정보를 텍스트 기반으로 확인할 수 있습니다.
Kubernetes 매크로(@daily 등)도 해석되나요?
예. Kubernetes 다이얼렉트에서는 대표 매크로를 지원하며 내부적으로 5필드 규칙으로 확장해 검증·미리보기 결과를 제공합니다. 단, @reboot처럼 시간 기반이 아닌 매크로는 다음 실행 계산 대상에서 제외됩니다.