Cron 파서

Cron 표현식을 해석하고 유효성을 검사하며 다음 실행 시각을 확인합니다.

자주 쓰는 패턴

사용 예시

배치 작업이 언제 실행될지 미리 확인하기

cron 표현식을 설정 파일에 쓰기 전에, 실제로 의도한 시간에 실행되는지 다음 실행 시각 목록으로 미리 확인할 수 있습니다.

복잡한 표현식을 사람 말로 풀어서 이해하기

*/15 8-20 * * 1-5 같은 표현식이 정확히 무슨 뜻인지 헷갈린다면, 자연어 풀이를 통해 바로 이해할 수 있습니다.

오타 때문에 안 돌아가던 cron 작업 디버깅하기

예약 작업이 실행되지 않는다면, 표현식을 붙여넣어 문법 오류가 있는지 바로 확인할 수 있습니다.

요일 스케줄에서 쉼표 목록과 범위 중 어느 쪽을 쓸지 고민될 때

요일 필드에서 1,3,5와 1-5가 같은 뜻인지 헷갈린다면? 둘 다 입력해보고 자연어 설명과 다음 실행 시각을 나란히 비교해 정확히 어떻게 다른지 확인해보세요.

막연한 요구사항을 실제 동작하는 표현식으로 바꾸기

"평일 업무 시간에 15분마다 실행"처럼 애매하게 전달받았다면? 프리셋에서 시작해 */15 9-17 * * 1-5 형태로 다듬은 뒤, 다음 실행 시각이 요청받은 내용과 일치하는지 확인하세요.

한 작업 실행기에서 다른 작업 실행기로 스케줄 옮기기

레거시 시스템의 예약 작업을 Kubernetes CronJob이나 GitHub Actions 워크플로 같은 곳으로 옮기는 중이라면? 기존 표현식을 붙여넣어 자연어 설명을 얻고, 새 플랫폼 문서와 대조해본 뒤 옮기세요.

초 단위 표현식이 의도대로 해석되는지 확인하기

0 */30 * * * *처럼 선택적인 초 필드를 지원하는 스케줄러 라이브러리를 쓰고 있다면? 붙여넣어서 표준 5개 필드 형식으로 잘못 해석되지 않고 6개 필드 표현식으로 제대로 읽히는지 확인하세요.

빠른 참고표

Cron 표현식풀이
* * * * *1분마다
*/2 * * * *2분마다
*/5 * * * *5분마다
*/10 * * * *10분마다
*/15 * * * *15분마다
*/30 * * * *30분마다
0 * * * *1시간마다
0 */2 * * *정각, 2시간마다
0 */3 * * *정각, 3시간마다
0 */6 * * *정각, 6시간마다
0 */12 * * *정각, 12시간마다
0 0 * * *오전 12:00
30 2 * * *오전 02:30
0 9 * * *오전 09:00
0 9,17 * * *오전 09:00, 오후 05:00
0 9 * * 1-5오전 09:00, 월요일부터 금요일까지
*/15 9-17 * * 1-515분마다, 오전 09:00부터 오후 05:59까지, 월요일부터 금요일까지
0 9 * * 1오전 09:00, 월요일에만
0 0 * * 0오전 12:00, 일요일에만
0 10 * * 6,0오전 10:00, 일요일, 토요일에만
0 0 1 * *오전 12:00, 매월 1일
0 0 15 * *오전 12:00, 매월 15일
0 0 1,15 * *오전 12:00, 매월 1, 15일
0 0 1 */3 *오전 12:00, 매월 1일, 3개월마다
0 0 1 1 *오전 12:00, 매월 1일, 1월에만

자주 묻는 질문

내가 입력한 표현식이 서버로 전송되나요?

아니요. 해석과 계산은 브라우저 안에서만 이뤄지며 입력한 내용이 서버로 전송되지 않습니다.

초 단위(6개 필드) 표현식도 지원하나요?

네. 분·시·일·월·요일 5개 필드로 된 표준 cron 표현식과, 맨 앞에 초가 추가된 6개 필드 표현식을 모두 자동으로 인식합니다.

다음 실행 시각은 어느 시간대 기준인가요?

별도 설정 없이 현재 사용 중인 기기(브라우저)의 시간대를 기준으로 계산합니다. 실제 서버의 시간대가 다르다면 그만큼 시간이 다르게 표시될 수 있습니다.

@daily, @hourly 같은 별칭도 쓸 수 있나요?

네. @yearly, @monthly, @weekly, @daily, @hourly 같은 자주 쓰이는 별칭 표현도 지원합니다.

다음 실행 시각이 이상해 보이면 표현식이 잘못된 건가요?

꼭 그렇지는 않습니다 — 표현식 자체보다 시간대 불일치가 가장 흔한 원인입니다. 다음 실행 시각은 브라우저의 로컬 시간대 기준으로 계산되므로, UTC(또는 다른 시간대)에서 돌아가는 서버에는 완벽히 맞는 표현식이어도 여기서는 다른 시각으로 표시됩니다. 표현식 자체가 잘못됐다고 단정하기 전에, 실제 스케줄러가 어느 시간대에서 동작하는지 확인하고 그만큼 머릿속으로(또는 직접) 보정해보세요.

필드에서 *, ,, -, /는 각각 무슨 의미인가요?

*는 해당 필드의 '모든 값'을 뜻합니다. 1,15,30처럼 쉼표로 구분된 목록은 정확히 그 값들만 매칭합니다. 9-17처럼 하이픈으로 된 범위는 그 사이 모든 값을 포함해서 매칭합니다. */15나 9-17/2 같은 슬래시는 필드의 시작(또는 범위의 시작)부터 'N번째 값마다'를 의미하므로, 분 필드의 */15는 :00, :15, :30, :45에 실행됩니다. 이런 표기는 0,30 9-17 * * 1-5처럼 조합할 수도 있습니다.

일(day-of-month)과 요일(day-of-week)은 뭐가 다르고, 둘 다 설정하면 어떻게 되나요?

5번째 필드는 요일(0-6 또는 이름, 보통 0과 7 모두 일요일)이고 3번째 필드는 일(1-31)입니다. 두 필드를 동시에 *가 아닌 값으로 제한하면, 이 도구를 포함한 대부분의 cron 구현은 둘을 OR로 처리합니다 — 즉 둘 다 만족할 때가 아니라 둘 중 하나라도 만족하면 실행됩니다. 많은 사람이 여기서 헷갈리므로, 둘 중 하나만 의도했다면 나머지는 *로 남겨두세요.

year 필드나 L/W 같은 비표준 문자도 지원하나요?

표준 5개 필드와 초가 추가된 6개 필드 cron은 *, 범위, 목록, 스텝까지 완전히 지원합니다. 다만 끝에 붙는 year 필드나, Quartz 같은 도구가 쓰는 '해당 월의 마지막 날'을 뜻하는 L, '가장 가까운 평일'을 뜻하는 W 같은 일부 벤더 전용 확장 문법은 인식되지 않을 수 있습니다. 예상치 못한 파싱 오류가 난다면, 대상 스케줄러가 정말 그 확장 기능이 필요한지, 아니면 표준 문법으로 대체할 수 있는지 확인해보는 것이 좋습니다.