cron 해석기
cron 표현식을 읽고 실행 주기를 한글로 풀어줘요.
이럴 때 쓰세요
이렇게 사용하세요
결과가 예상과 다를 때
결과가 예상과 달라요
단위와 기준을 먼저 확인해 주세요. 값을 바꾸면 결과가 바로 갱신돼요.
처음 값으로 되돌리고 싶어요
초기화를 누르면 처음 상태로 돌아가요.
자주 하는 실수
- 요일 숫자를 헷갈리기 쉽습니다. 0과 7은 모두 일요일이고 6은 토요일입니다. 1부터 5까지는 월요일부터 금요일까지고 6까지 넣으면 토요일도 포함됩니다. 요일에 2 간격을 주면 일·화·목·토가 됩니다.
- 일 칸과 요일 칸을 함께 좁히면 둘 중 하나만 맞아도 실행됩니다. 0 0 13 * 5는 매달 13일이거나 매주 금요일인 날에 실행된다는 뜻이지, 둘 다 맞는 날에만 실행된다는 뜻이 아닙니다.
- 별칭과 월·요일 이름은 다섯 칸 형식에 없습니다. @daily, @monthly 같은 축약형과 JAN, MON 같은 이름은 해석되지 않으므로 숫자로 바꿔서 적어야 합니다.
- 간격은 건너뛰기 값입니다. */15는 0·15·30·45분에 돈다는 뜻이지 매 15분이 정확히 한 번이라는 뜻이 아닙니다. 다섯 칸에는 초가 없으므로 1초마다 같은 작업을 돌리는 설정은 만들 수 없습니다.
계산 근거
crontab 형식은 분(0–59) 시(0–23) 일(1–31) 월(1–12) 요일(0–7)의 다섯 칸이며, 각 칸은 *, 리스트(,), 범위(-), 간격(/N)을 조합해 표현합니다. 일과 요일 칸을 모두 좁히면 둘 중 하나라도 일치할 때 실행됩니다.
실제로 계산해 보면
30 4 * * 1-5는 언제 실행되나요?
평일 새벽 4시 30분입니다. 첫 두 칸이 30과 4고, 나머지 셋이 모두 별표라 요일이 지정된 요일에만 돕니다. 범위 표기로 평일을 짧게 적는 가장 흔한 형태입니다.
*/15 * * * *의 실행 간격은?
0·15·30·45분으로 한 시간에 네 번입니다. 첫 칸만 바뀌고 나머지 칸이 전부 별표라 날짜와 요일에 상관없이 매일 같은 간격을 유지합니다. 다른 칸에 시간을 함께 넣으면 조건이 좁혀집니다.
0 12 1 */3 *은 몇 달에 한 번인가요?
3개월마다 1일 정오입니다. */3은 1일부터 3 간격으로 올라가 1·4·7·10월이 됩니다. 2를 쓰면 짝수 달만, 1을 쓰면 매달이 되므로 값에 따라 의미가 확 달라집니다.
더 궁금한 것
서버 시간대가 로컬과 다르면 어떻게 되나요?
작업은 서버의 로컬 시간으로 실행됩니다. 서버가 UTC로 맞춰져 있으면 새벽 9시로 적은 작업이 한국 시간 오전 6시에 돕니다. 배포 환경의 시간대 설정부터 확인한 뒤 칸을 정하세요.
서버를 껐다 켜면 놓친 실행이 몰아서 처리되나요?
표준 동작 방식으로는 몰아서 하지 않습니다. 서버가 꺼져 있던 시간의 작업은 그냥 사라지고 다음 주기로 넘어갑니다. 눈에 띄는 영향이 큰 작업은 실행 시각을 남기고 알림을 따로 붙이세요.
지정한 시간이 실제로 실행됐는지 어떻게 아나요?
스케줄 자체에는 실행 이력이 없습니다. 지정한 명령이 시작할 때 시각을 파일에 남기게 하거나, 별도 스케줄러의 기록을 확인하는 방법이 정확합니다. 자주 놓치는 작업일수록 이 기록부터 붙여 두면 원인 파악이 빨라집니다.
알아둘 경계값
- 6개 필드 입력은 필드 수 안내만 나오고 해석되지 않아요. 초를 빼고 5개로 줄이세요.
- 특수 문자는 해석 규칙이 없어 숫자 그대로 읽혀요. 네 기호만으로 표현하세요.
- 범위 끝이 시작보다 작으면 실행기가 거부하거나 무시해요. 오름차순으로 적으세요.
- 한글 풀이는 설명용이라 복사해 크론탭에 붙이면 실행되지 않아요. 배포에는 원본 영숫자 표현식을 보관하세요.
- 일 칸 31일은 2월과 30일까지인 달에 건너뛰어져 그 달 실행이 통째로 빠져요. 말일 실행이면 달별 일수를 함께 고려하세요.
- 분 칸에 60 이상을 적으면 무효라 실행되지 않아요. 0부터 59 안에서만 적으세요.
결과를 믿기 전 확인 목록
- 필드가 정확히 5개인지 공백 기준으로 세어 보세요.
- 맨 앞에 초 필드가 붙지 않았는지 확인하세요.
- 특수 문자가 필드 안에 숨어 있지 않은지 검색하세요.
- 범위가 오름차순인지 시작과 끝 값을 읽어보세요.
- 분 칸과 시 칸이 바뀌지 않았는지 소리 내어 읽어보세요.
- 존재하지 않는 날짜가 없는지 달력으로 대조하세요.
- 한글 풀이가 아닌 원본 표현식을 배포 파일에 넣었는지 확인하세요.
- 축소판 분 간격으로 먼저 시험 실행해 로그를 확인하세요.
- 일 31일 지정 시 짧은 달 대책을 세웠는지 확인하세요.
자주 묻는 질문
초 단위도 되나요?
표준 5필드(분 시 일 월 요일) 기준입니다.
초 단위는 지원하나요?
표준 5필드(분 시 일 월 요일)만 지원해요. 초 단위는 6필드라 이 도구로는 해석되지 않아요.