도구 사용 가이드
사용 단계
- 형식에서 Spring @Scheduled(6필드) 또는 Unix crontab(5필드)을 고릅니다. Spring은 맨 앞에 초 필드가 하나 더 있습니다.
- Cron 표현식 칸에 공백으로 구분한 필드를 입력하거나 예시 버튼을 누릅니다. 입력하는 즉시 해석이 바뀝니다.
- 계산 시간대를 서버가 실제로 쓰는 시간대(한국 시간 또는 UTC)로 맞추고 다음 실행 시각 10개를 확인합니다.
- Spring 형식이면 zone까지 들어간 @Scheduled 예시를 복사해 스케줄 메서드에 붙여 넣습니다.
무엇을 처리하며 언제 쓰나요?
필드 구성
| 순서 | Spring 6필드 | Unix crontab 5필드 | 허용 값 |
|---|---|---|---|
| 1 | 초 | 분 | 초 0~59 / 분 0~59 |
| 2 | 분 | 시 | 분 0~59 / 시 0~23 |
| 3 | 시 | 일 | 시 0~23 / 일 1~31 |
| 4 | 일 | 월 | 일 1~31 / 월 1~12 또는 JAN~DEC |
| 5 | 월 | 요일 | 월 1~12 / 요일 0~7 |
| 6 | 요일 | 없음 | 요일 0~7 또는 MON~SUN |
요일은 두 형식 모두 0과 7이 일요일입니다. Spring은 내부적으로 java.time과 같은 1(월요일)~7(일요일)을 쓰므로 MON=1, SUN=7입니다.
공통 문법
*: 모든 값. 일·요일 필드에서는 “매일”입니다.,: 목록.0 0 6,19 * * *은 매일 6시와 19시입니다.-: 범위.9-17은 9시부터 17시까지입니다./: 간격.*/10은 0부터 10 간격,8-18/2는 8시부터 18시까지 2시간 간격입니다.
Spring은 0/30처럼 숫자 하나 뒤에 /를 쓰면 그 값부터 최댓값까지로 해석합니다. 일반 crontab에서는 이 표기를 쓰지 않으므로 이 도구는 Unix 형식에서 */30이나 0-59/30으로 고치라고 알려 줍니다.
Spring에만 있는 문법
| 문법 | 위치 | 의미 | 예 |
|---|---|---|---|
L |
일 | 그달의 마지막 날 | 0 0 0 L * * |
L-n |
일 | 마지막 날에서 n일 전 | 0 0 0 L-3 * * |
nW |
일 | n일에 가장 가까운 평일 | 0 0 0 15W * * |
LW |
일 | 그달의 마지막 평일 | 0 0 0 LW * * |
dL |
요일 | 그달의 마지막 d요일 | 0 0 0 * * FRIL |
d#n |
요일 | 그달의 n번째 d요일 | 0 0 10 ? * MON#1 |
? |
일·요일 | *와 같음 |
0 0 0 25 DEC ? |
nW는 n일이 토요일이면 전날 금요일, 일요일이면 다음 날 월요일에 실행합니다. 다만 1W인데 1일이 토요일이면 앞달로 넘어가지 않고 3일 월요일에 실행합니다. 매크로 @yearly, @monthly, @weekly, @daily, @hourly도 쓸 수 있으며, 해석 결과에 풀어 쓴 6필드를 함께 보여 줍니다.
일과 요일을 함께 지정하면
두 형식의 결과가 가장 크게 갈리는 부분입니다. crontab(5)은 일과 요일 필드를 모두 제한하면(*가 아니면) 둘 중 하나만 맞아도 실행한다고 정의합니다. 그래서 0 9 13 * 5는 매월 13일과 매주 금요일에 모두 실행됩니다. Spring CronExpression은 필드를 차례로 맞춰 가므로 0 0 9 13 * FRI는 13일이면서 금요일인 날에만 실행됩니다. 2026년 11월 13일 다음은 2027년 8월 13일입니다. crontab에서 옮긴 표현식이라면 이 도구에서 두 형식을 바꿔 가며 실행 시각을 비교해 보세요.
Spring Boot에서 쓸 때
@Scheduled(cron = "0 0 9 * * MON-FRI", zone = "Asia/Seoul")처럼 zone을 지정하면 서버 시간대와 상관없이 한국 시간으로 계산합니다. 클라우드나 컨테이너 서버는 시간대가 UTC인 경우가 많아 zone을 빼면 오전 9시 작업이 오후 6시에 도는 일이 흔합니다. 스케줄을 쓰려면 설정 클래스에 @EnableScheduling도 붙여야 합니다.
같은 메서드가 여러 서버에서 동시에 돌면 작업이 서버 수만큼 중복 실행됩니다. Spring Boot 학습: AOP와 온디맨드 배치에서 만든 배치는 호출될 때만 실행하고 cron 스케줄은 다루지 않았는데, 여기에 스케줄을 붙인다면 중복 실행 방지(분산 락 등)를 먼저 정해야 합니다.
확인하지 않는 것
Quartz 7필드 표현식은 해석하지 않습니다. Quartz는 요일 번호가 1(일요일)~7(토요일)이라 같은 숫자가 Spring과 하루씩 어긋납니다. 서머타임이 있는 시간대는 다루지 않고 한국 시간과 UTC만 계산합니다. @reboot는 시각이 아니라 부팅 시점에 실행하는 지시어라 다음 실행 시각을 구할 수 없습니다.
입력한 표현식은 브라우저 안에서만 처리되고 서버로 전송되거나 저장되지 않습니다.
처리 방식과 규격
각 필드(초·분·시·일·월·요일)가 허용하는 값을 구한 뒤, 기준 시각 이후 모든 필드가 맞는 시각을 차례로 찾습니다. 일과 요일을 함께 지정하면 Spring은 둘 다 맞는 날, Unix crontab은 둘 중 하나라도 맞는 날을 고릅니다. 개발 작업 예제
평일 오전 9시 정각
- 입력
- Spring 형식 0 0 9 * * MON-FRI, 한국 시간
- 결과
- 해석: 평일, 9시 0분 0초. 2026-11-07(토) 기준 다음 실행은 2026-11-09(월) 09:00:00, 2026-11-10(화) 09:00:00 순
- 해석
- Unix crontab으로는 초 필드를 빼고 0 9 * * 1-5로 씁니다. 요일 이름 MON-FRI는 두 형식 모두에서 쓸 수 있습니다.
매월 마지막 날 자정
- 입력
- Spring 형식 0 0 0 L * *
- 결과
- 해석: 매월 마지막 날, 0시 0분 0초. 2026-11-30, 2026-12-31, 2027-01-31, 2027-02-28 순으로 실행
- 해석
- L은 Spring(과 Quartz)에만 있는 문법입니다. 일반 crontab에는 말일을 뜻하는 기호가 없어 28~31일에 실행한 뒤 스크립트 안에서 내일이 1일인지 확인하는 방식을 씁니다.
1일·15일과 월요일을 함께 지정
- 입력
- Unix crontab 0 9 1,15 * 1
- 결과
- 해석: 매월 1일, 15일 또는 월요일, 9시 0분. 2026-11-09(월), 2026-11-15(일), 2026-11-16(월) 순으로 실행
- 해석
- crontab은 일과 요일 필드를 모두 지정하면 둘 중 하나만 맞아도 실행합니다. 같은 값을 Spring에서 0 0 9 1,15 * MON으로 쓰면 1일이나 15일이면서 월요일인 날에만 실행되어 결과가 크게 달라집니다.
자주 묻는 질문
Spring cron과 Unix crontab은 무엇이 다른가요?
Spring은 맨 앞에 초 필드가 있어 6필드이고, crontab은 분부터 시작하는 5필드입니다. Spring은 L(마지막 날), W(가장 가까운 평일),
서버에서 실행 시각이 9시간 어긋납니다.
서버 시간대가 UTC인 경우가 대부분입니다. Spring은 @Scheduled에 zone = "Asia/Seoul"을 지정하면 서버 시간대와 상관없이 한국 시간으로 계산합니다. crontab은 서버 시간대를 따르므로 서버 설정을 바꾸거나, UTC 기준으로 9시간을 뺀 시각을 적어야 합니다. 이 도구에서 계산 시간대를 UTC로 바꾸면 같은 표현식이 한국 시간으로 언제 실행되는지 함께 볼 수 있습니다.
Quartz 표현식도 해석되나요?
지원하지 않습니다. Quartz는 7번째 연도 필드를 쓸 수 있고 요일 번호가 1(일요일)~7(토요일)이라 Spring의 1(월요일)~7(일요일)과 다릅니다. 같은 숫자라도 요일이 하루씩 밀리므로 Quartz 표현식을 그대로 옮기지 마세요.
물음표(?)는 언제 쓰나요?
Spring 형식의 일 또는 요일 필드에 단독으로 쓰며 별표(*)와 같은 뜻입니다. Quartz와 달리 Spring은 ?를 꼭 쓰지 않아도 되므로, 0 0 0 25 12 ?와 0 0 0 25 12 *는 같은 일정입니다.
입력한 표현식이 저장되거나 전송되나요?
저장하지도 전송하지도 않습니다. 해석과 실행 시각 계산은 모두 이 브라우저 안에서 하고, 페이지를 닫으면 사라집니다.
검토 근거와 공식 출처
- Spring Framework Reference: Task Execution and Scheduling · Spring
- Spring Framework API: CronExpression · Spring
- crontab(5) - Linux manual page · man7.org
공식 안내는 변경될 수 있습니다. 중요한 결정 전에는 링크된 기관의 최신 정보를 다시 확인하세요.