Cron 표현식 파서

각 필드가 펼쳐지는 값

필드는 값 하나가 아니라 값의 집합입니다. 그 집합이 얼마나 큰지 알면 여기까지 찾아온 궁금증이 대개 그 자리에서 풀립니다.

필드 안에서 쓰는 연산자는 다음과 같습니다. *는 모든 값, 1,5,10은 목록, 1-5는 범위, */15는 범위의 시작점부터 세는 스텝, 0-45/15는 범위 안에서 세는 스텝입니다.

이름과 단축 표기도 인식합니다

월 이름과 요일 이름도 그대로 해석해 일치하는 숫자로 펼칩니다. 그래서 30 3 * JAN,JUL 1은 월이 1, 7, 요일이 1로 표시됩니다. 단축 표기는 다른 처리에 앞서 5필드 형태로 먼저 펼쳐집니다.

@reboot도 인식하지만 펼칠 일정이 없습니다. 시스템이 시작될 때 한 번 실행되므로 미리 보여 줄 실행 시각이 없습니다.

꼭 읽어야 할 경고

• 일 필드와 요일 필드를 모두 지정한 경우. 0 0 1 * MON은 “1일이면서 월요일인 날”이라는 뜻이 아닙니다. 표준 cron은 일 필드와 요일 필드가 모두 지정되어 있으면 두 필드를 OR로 처리합니다. 따라서 이 줄은 매월 1일에도 실행되고 매주 월요일에도 실행됩니다. 파서는 이 경고를 띄우고, 다음 실행 미리보기도 OR 규칙을 그대로 따릅니다.
• 절대 오지 않는 날짜. 0 0 30 2 *는 2월 30일을 요구합니다. 문법상으로는 올바르고 cron도 이 줄을 받아들이지만, 실제로는 한 번도 실행되지 않습니다. 파서는 아무 설명 없이 빈 목록만 보여 주는 대신 그 사실을 알려 줍니다.
• Quartz 연산자. L(마지막), W(가장 가까운 평일), #(그 달의 N번째 요일), ?는 Quartz 확장이며 표준 crontab에는 없습니다. 5필드 한 줄 안에 들어 있으면 인식해서 표시해 주고, 해당 필드에는 값 목록 대신 Quartz 연산자라는 안내가 나옵니다. 표준 cron이라면 이 줄을 아예 실행하지 않으므로 실행 시각은 계산하지 않습니다.

아예 거부되는 입력

• 필드 개수가 맞지 않는 경우. 초가 붙은 6필드 Quartz 줄이나 연도까지 붙은 7필드 줄은 필드 개수 단계에서 거부됩니다.
• 범위를 벗어난 값. 예를 들어 분 75나 월 13이 그렇습니다.
• 거꾸로 지정한 범위. 5-1 같은 경우입니다.
• 0으로 지정한 스텝. */0이 그렇습니다.

거부될 때마다 원인이 된 필드와 값을 함께 알려 주므로, 줄 전체를 다시 쓰지 않고 한 군데만 고치면 됩니다.

시간대

다음 실행 미리보기는 사용자 브라우저에서, 기기에 설정된 시간대로 계산합니다. 반면 crontab은 그것이 올라가 있는 머신의 시간대로 동작합니다. 그러니 서버는 UTC로 돌아가는데 기기의 시간대는 다르다면, 두 시각을 견주기 전에 시차만큼 옮겨서 따져 보세요.