ConvertBox Logo
ConvertBox

크론 표현식 완전 정리: 5개 필드, 예시, 흔한 함정

크론 표현식은 분, 시, 일, 월, 요일의 다섯 필드로 이루어지며 각 필드는 허용되는 값의 집합을 나타냅니다. 현재 시각이 모든 필드에 맞을 때 작업이 실행되지만, 일과 요일 두 필드에는 중요한 예외가 있습니다.

ConvertBox게시

왼쪽부터 순서대로 다섯 개의 필드

전통적인 크론 표현식은 공백으로 구분한 다섯 필드로 이루어집니다. 크론은 1분마다 깨어나 현재의 분, 시, 일, 월이 각 필드가 나타내는 집합에 들어 있으면 작업을 실행합니다. 표현식은 주기를 재는 타이머가 아니라 시계에 거는 필터입니다. 아래에서 다루는 의외의 동작은 대부분 이 차이로 설명됩니다.

필드허용 값예
분0-5930은 30분에 실행
시0-230은 자정, 13은 오후 1시
일1-3115는 15일
월1-12 또는 JAN-DEC7 또는 JUL
요일0-6 또는 SUN-SAT0이 일요일이며, 대부분의 구현은 7도 일요일로 받음

네 가지 특수 문자: * , - /

각 필드에는 숫자 하나를 적거나 네 가지 연산자로 만든 집합을 적습니다. 0-30/10이나 1,15,20-25처럼 조합할 수도 있습니다.

문자의미분 필드에서의 예실행되는 분
*모든 값*0, 1, 2 ... 59
,목록5,355분과 35분
-양 끝을 포함하는 범위10-1310, 11, 12, 13
/범위를 일정 간격으로 건너뜀*/150, 15, 30, 45
-와 /범위 안에서 간격 지정0-30/100, 10, 20, 30

필드별로 읽어 보는 예시

표현식은 분에서 요일 순서로 읽습니다. 처음에 흔히 하는 실수는 분 필드를 *로 두는 것입니다. * 9 * * *는 09:00부터 09:59까지 매분, 모두 60번 실행됩니다.

  • 0 9 * * 1-5: 월요일부터 금요일까지 09:00.
  • */15 9-17 * * 1-5: 평일 9시부터 17시대까지 15분마다. 시 범위는 끝 값을 포함하므로 마지막 실행은 17:00이 아니라 17:45입니다.
  • 0 */6 * * *: 매일 00:00, 06:00, 12:00, 18:00.
  • 5,35 * * * *: 매시 5분과 35분, 한 시간에 두 번.
  • 30 2 1 * *: 매월 1일 02:30.
  • 0 22 * * 0: 매주 일요일 22:00.
  • 0 0 1 1 *: 1년에 한 번, 1월 1일 자정.

*/7과 31일이 예상과 다르게 동작하는 이유

간격 지정은 경과 시간 기준으로 N 단위마다 실행한다는 뜻이 아닙니다. 필드의 범위에서 가장 작은 값부터 값을 골라내며, 필드가 한 바퀴 돌면 처음부터 다시 고릅니다. 분 필드의 */7은 0, 7, 14부터 56까지 맞고 다시 0으로 돌아가므로 매시 정각 직전에 4분 간격이 생깁니다. 시 필드의 */5는 0, 5, 10, 15, 20에 맞으므로 자정을 넘는 간격은 4시간입니다. 일 필드의 */2는 홀수 날에 맞으므로 31일에 실행되고 다음 날인 1일에 또 실행됩니다. 분에서는 5, 10, 15, 20, 30, 시에서는 2, 3, 4, 6, 8, 12처럼 범위를 나누어떨어지게 하는 간격만 균일한 주기가 됩니다.

존재하지 않는 날짜는 그냥 일치하지 않습니다. 0 0 31 * *는 31일이 있는 일곱 달에만 실행되고 나머지 다섯 달은 아무 알림 없이 건너뜁니다. 30일은 2월을 건너뛰고, 29일은 윤년의 2월에만 실행됩니다. 표준 크론에는 말일을 뜻하는 기호가 없습니다. 흔한 우회 방법은 28-31일에 작업을 걸어 두고, 명령 안에서 내일이 1일인지 확인한 뒤에만 실제 작업을 하게 하는 것입니다.

일과 요일은 OR로 결합됩니다

모든 필드가 맞아야 실행된다는 원칙에는 예외가 하나 있습니다. 일 필드와 요일 필드가 둘 다 제한되어 있을 때, 즉 둘 다 *가 아닐 때 전통적인 크론은 둘 중 하나만 맞아도 작업을 실행합니다. 0 0 13 * 5는 13일의 금요일이 아닙니다. 매월 13일에 실행되고 매주 금요일에도 실행됩니다. 마찬가지로 0 9 1-7 * 1은 첫째 월요일이 아니라 매월 1일부터 7일까지 매일, 그리고 매주 월요일에 실행됩니다.

두 필드 중 하나가 *이면 나머지 하나만 일정을 제한하며, 대부분이 기대하는 동작이 이것입니다. 두 조건을 모두 만족하는 날에만 실행하려면 한 필드는 표현식에서 제한하고 다른 하나는 명령에서 검사합니다. 0 9 1-7 * *로 걸어 두고 오늘이 월요일이 아니면 스크립트가 종료하게 하는 식입니다. 확장 문법이 있는 스케줄러는 이를 직접 표현합니다. Quartz에서는 요일 필드의 MON#1이 그 달의 첫째 월요일을 뜻합니다.

시간대와 서머타임

표현식에는 시간대가 들어 있지 않고, 실행하는 시스템이 시간대를 정합니다. 전통적인 리눅스 crontab은 서버의 현지 시간을 씁니다. GitHub Actions의 스케줄은 항상 UTC입니다. 쿠버네티스 CronJob은 spec.timeZone을 지정하지 않으면 클러스터 컨트롤러의 시간대를 따릅니다. UTC 시스템에서 서울 시간 09:00에 실행하려면 9시간을 빼서 0 0 * * *로 적어야 합니다. 한국은 서머타임이 없어 이 차이가 1년 내내 같습니다.

서머타임을 시행하는 시간대에서는 위험이 두 가지 더 있습니다. 봄에 시각을 앞당기는 날에는 한 시간이 존재하지 않으므로 그 안에 걸린 작업은 그날 실행되지 않을 수 있습니다. 가을에 되돌리는 날에는 한 시간이 두 번 지나가므로 그 안의 작업은 두 번 실행될 수 있습니다. 스케줄러가 이 경우를 어떻게 처리하는지는 구현마다 다릅니다. UTC로 스케줄을 잡거나, 현지 시간 기준으로 전환이 일어나는 시간대를 피하면 두 문제를 모두 피할 수 있습니다.

전통적인 크론, Quartz, 플랫폼별 방언

크론 문법은 하나의 표준이 아니라 여러 변종의 묶음입니다. 5필드 표현식은 Quartz에서 유효하지 않고 Quartz 표현식은 crontab에서 유효하지 않으므로, 다른 곳의 스케줄을 복사하기 전에 플랫폼이 어떤 방언을 쓰는지 확인해야 합니다.

이 사이트의 크론 도우미는 표준 5필드를 해석합니다. 표현식을 페이지 언어의 문장으로 풀어 주고, 이와 별도로 다음 실행 시각 다섯 개를 브라우저의 시간대로 보여 줍니다. 문장과 날짜가 모두 의도와 일치하면, 그 시간대에서 도는 5필드 스케줄러에 맞는 표현식입니다. L, W, #, ? 같은 확장은 표에 있는 플랫폼의 기능이므로 해당 문서를 참고하시기 바랍니다. 정규식으로는 문자열이 공백으로 구분된 다섯 필드인지 확인할 수 있어 입력 검증에 쓸모가 있고 정규식 테스터에서 쉽게 시험해 볼 수 있지만, 작업이 언제 실행되는지는 알려 주지 못합니다.

방언필드 수알아 둘 차이
Unix crontab5서버 현지 시간. 많은 구현이 @daily, @hourly 같은 단축 표기를 받음
Quartz6 또는 7초가 맨 앞, 연도는 맨 뒤에 선택 사항. 두 날짜 필드 중 하나에 ? 필수. L, W, # 추가
Spring @Scheduled6초가 맨 앞, 연도 필드 없음
AWS EventBridge6분이 맨 앞, 연도가 맨 뒤, 초 없음. 두 날짜 필드 중 하나에 ? 필수
GitHub Actions5항상 UTC. 최소 간격은 5분. 부하가 높으면 실행이 늦어질 수 있음
Kubernetes CronJob5spec.timeZone을 지정하지 않으면 컨트롤러의 시간대

이 가이드에서 다룬 도구

관련 가이드

전체 가이드