Cron 표현식 파서

네이버 클라우드 Cron 트리거 예제로 확인하기

네이버 클라우드 플랫폼 Cloud Functions의 Cron 타입 트리거 가이드는 실행 옵션이 UNIX crontab 문법을 따르며 5개 필드를 공백으로 나눈다고 설명합니다. 가이드에 실린 예제를 이 도구에 넣으면 영어 설명과 다음 실행 시각을 바로 볼 수 있습니다. 아래는 브라우저 시간대가 Asia/Seoul이고 2026-10-08(목) 08:00부터 센 결과입니다. 설명문은 모든 언어 버전에서 영어로 나오므로 원문 그대로 옮겼습니다.

가이드의 “매월 5일 10:00 AM마다 실행” 예제 0 10 5 * *는 이달 5일이 이미 지났기 때문에 11월부터 나옵니다.

At 10:00, on day 5 of the month
2026-11-05 10:00
2026-12-05 10:00
2027-01-05 10:00

“월요일 10:00 AM마다 실행” 예제 0 10 * * 1은 숫자 대신 mon으로 써도 같습니다.

At 10:00, on mon
2026-10-12 10:00
2026-10-19 10:00
2026-10-26 10:00

페이지의 실행 시각은 브라우저 언어 설정에 맞는 날짜 형식으로 표시됩니다. 여기서는 “연-월-일 시:분”으로 맞췄습니다. 가이드에는 트리거가 어느 시간대 기준으로 실행되는지 적혀 있지 않으므로, 실제 시간대는 콘솔에서 확인하세요. 이 도구에는 시간대 선택이 없고 항상 브라우저의 시간대로 계산합니다.

두 예제를 합치면 생기는 일

“매월 5일이면서 월요일”을 노리고 두 예제를 0 10 5 * 1로 합치면 결과가 달라집니다. 일과 요일에 모두 구체적인 값을 쓰면 둘 중 하나만 맞아도 실행되기 때문입니다(cronie crontab(5), POSIX crontab). 설명문에도 or가 들어가고, 매주 월요일과 11월 5일(목)이 모두 목록에 나옵니다.

At 10:00, on day 5 of the month or on mon
2026-10-12 10:00
2026-10-19 10:00
2026-10-26 10:00
2026-11-02 10:00
2026-11-05 10:00
2026-11-09 10:00

어느 한 필드가 *로 시작하면(*/2 포함) cronie와 같이 둘 다 맞아야 하므로, 0 0 */2 * 1은 날짜가 홀수인 월요일에만 실행됩니다. 월 필드는 항상 맞아야 합니다. “5일이 월요일인 날만” 같은 조건은 표준 cron으로 쓸 수 없으니, 0 10 5 * *로 실행한 뒤 스크립트에서 요일을 확인하는 방법을 씁니다.

지원하지 않는 문법

가이드가 밝힌 대로 월과 요일 이름은 영문만 됩니다. 한글 요일 이름을 쓰면 이 도구에서도 다음 오류가 납니다.

잘못된 표현식 — 각 필드 범위를 확인하세요.

#(n번째 요일, 1#2는 둘째 월요일), L(마지막), W(가장 가까운 평일), ?는 Quartz 등 스케줄러의 확장이며 표준 cron에서는 쓸 수 없습니다. 이 도구는 이들을 추측해서 해석하지 않고 필드와 해당 부분을 짚어 오류로 표시합니다. 1.5나 monday처럼 정수도 영문 약어도 아닌 값도 오류입니다. 스텝은 *나 범위 뒤에만 쓸 수 있습니다. cronie는 5/10을 받지 않으며 이 도구도 오류로 처리합니다. 5-59/10이나 */10으로 쓰세요.

다음 실행 시각은 몇 년 뒤라도 계산합니다. 0 0 29 2 *는 윤년의 2월 29일을 보여 주고, 0 0 30 2 *처럼 존재하지 않는 날짜는 실행 시각을 찾을 수 없다고 표시합니다.

제한 사항

• 실행 시각은 브라우저의 현지 시간대로만 계산합니다. 시간대 선택이 없고 CRON_TZ= 줄도 읽지 않습니다. 서버가 UTC로 동작한다면 한국 시간에서 9시간을 빼서 쓰세요.
• 서머타임 전환으로 존재하지 않는 시각은 일치하지 않습니다(crontab(5) 규정). 시계를 되돌릴 때 두 번 나오는 시각은 한 번만 표시하지만 cronie는 두 번 실행합니다.
• 설명문은 모든 언어 버전에서 영어입니다. 필드 이름과 메시지는 한국어로 표시합니다.
• @daily 같은 단축 표기는 필드 개수 오류가 됩니다. @daily는 0 0 * * *로 쓰세요.
• 실행 시각은 10번까지만 보여 주며 더 보기나 날짜 지정은 없습니다.