Cron 표현식 해석기란?
크론(cron)은 리눅스 서버에서 정해진 시각에 작업을 자동 실행하는 스케줄러이고, 30 9 * * 1 같은 다섯 칸짜리 문자열이 크론 표현식입니다. crontab뿐 아니라 GitHub Actions, AWS EventBridge, Kubernetes CronJob, 스프링 @Scheduled 등 많은 서비스가 비슷한 문법을 씁니다.
이 도구는 표현식을 입력하는 즉시 사람이 읽기 쉬운 한국어 설명과 다음 실행 시각을 보여 주고, 잘못된 값이 있으면 어느 필드가 왜 틀렸는지 알려 줍니다.
사용 방법
- 입력칸에 크론 표현식을 입력하거나 자주 쓰는 일정에서 고르세요.
- 위쪽 결과에서 한국어 설명과 바로 다음 실행 시각을 확인하세요.
- 빌더에서 분·시·일·월·요일을 하나씩 고르면 표현식이 자동으로 바뀝니다.
- 맨 아래에서 앞으로 실행될 시각 10개를 한국 시간(KST) 기준으로 확인하세요.
예시로 살펴보기
평일 업무 시간 15분마다
- 입력
*/15 9-18 * * 1-5- 결과
- 평일(월~금) 9시~18시 사이 15분마다
다음 실행: 9:00, 9:15, 9:30 … 마지막은 18:45
시 필드 9-18은 18시대 전체를 포함하므로 18:45에도 실행됩니다. 18시 정각에 끝내려면 */15 9-17 * * 1-5와 0 18 * * 1-5 두 줄로 나누세요.
일과 요일을 함께 쓰면 '또는'
- 입력
30 2 13 * 5- 결과
- 매월 13일 또는 매주 금요일 오전 2시 30분
다음 실행 목록에 금요일들 사이로 12월 13일(일)이 섞여 나옵니다.
"13일의 금요일에만"을 기대하기 쉽지만, 표준 크론은 일과 요일이 둘 다 지정되면 둘 중 하나만 맞아도 실행합니다. 정말 13일의 금요일만 원하면 스크립트 안에서 요일을 한 번 더 확인해야 합니다.
스프링 @Scheduled 표현식 붙여 넣기
- 입력
0 0 12 * * ?(6개 필드)- 결과
- 매일 정오(12시)
6개 필드는 맨 앞을 초로 읽고 ?는 '지정 안 함'으로 처리합니다. 연도까지 붙은 7개 필드는 "7개 필드(연도 포함)는 Quartz 형식이에요"라는 안내가 나오고, 0 25 * * *처럼 범위를 벗어나면 "시(0~23) 범위를 벗어난 값 25"를 알려 줍니다.
크론 표현식 구조
| 순서 | 필드 | 값 |
|---|---|---|
| 1 | 분 | 0~59 |
| 2 | 시 | 0~23 |
| 3 | 일 | 1~31 |
| 4 | 월 | 1~12 또는 JAN~DEC |
| 5 | 요일 | 0~7 (0과 7은 일요일) 또는 SUN~SAT |
6개 필드를 입력하면 맨 앞을 초(0~59)로 해석합니다(스프링, Quartz 방식). @daily, @hourly 같은 매크로도 지원합니다.
특수 문자 의미
| 기호 | 의미 | 예 | 결과 |
|---|---|---|---|
| * | 모든 값 | * * * * * | 매분 |
| , | 여러 값 나열 | 0 9,18 * * * | 오전 9시, 오후 6시 |
| - | 범위 | 0 9 * * 1-5 | 평일 오전 9시 |
| / | 간격 | */10 * * * * | 10분마다 |
일과 요일을 둘 다 지정하면(예: 0 0 13 * 5) 표준 크론은 둘 중 하나만 맞아도 실행합니다. 13일의 금요일만 실행되는 것이 아니라 매월 13일과 매주 금요일에 모두 실행되니 주의하세요.
자주 묻는 질문
서버에서 실행 시각이 9시간 차이 나요.
서버의 시간대가 UTC로 설정되어 있으면 크론도 UTC 기준으로 실행됩니다. 한국 시간 오전 9시에 실행하려면 UTC 0시(0 0 * * *)로 쓰거나 서버의 TZ를 Asia/Seoul로 바꾸세요. GitHub Actions와 AWS EventBridge는 항상 UTC 기준입니다.
L, W, # 같은 문법도 되나요?
매월 마지막 날(L), 가장 가까운 평일(W), n번째 요일(#)은 Quartz 스케줄러 등 일부 시스템 전용 문법이라 지원하지 않습니다. 일반 crontab에서는 쓸 수 없습니다.
다음 실행 시각은 어떤 시간대 기준인가요?
한국 표준시(KST, UTC+9) 기준입니다. 한국은 서머타임이 없어 1년 내내 같은 기준으로 계산됩니다.
2월 30일처럼 없는 날짜를 넣으면 어떻게 되나요?
문법상으로는 맞지만 실제로 실행되는 날이 없으므로, 앞으로 8년 안에 실행 시각이 없다고 안내합니다.
요일 0과 7은 둘 다 일요일인가요?
네. 0 0 * * 0과 0 0 * * 7은 모두 매주 일요일 자정이며, @weekly도 같은 뜻입니다. SUN~SAT, JAN~DEC 같은 영문 약어도 대소문자 상관없이 쓸 수 있습니다.