WebGroundwebground.app
정보 & 가이드 · 개발자 레퍼런스

크론(Cron) 표현식 가이드 & 스케줄 해석기

자주 쓰는 예시로 크론 스케줄 문법을 익히고, 다섯 필드짜리 표현식을 붙여 넣어 올바른지 검사하고 다음 실행 시각을 확인하세요.

크론 표현식 확인

공백으로 구분된 다섯 개의 필드: 분, 시, 일, 월, 요일.

올바른 크론 표현식

필드별 해석

  • 분

    허용 범위: 0~59

    값
    */15
    일치하는 값
    • 0
    • 15
    • 30
    • 45
  • 시

    허용 범위: 0~23

    값
    9-17
    일치하는 값
    • 9~17
  • 일

    허용 범위: 1~31

    값
    *
    일치하는 값
    모든 날짜
  • 월

    허용 범위: 1~12

    값
    *
    일치하는 값
    매월
  • 요일

    허용 범위: 0~7

    값
    MON-FRI
    일치하는 값
    • 월요일~금요일

다음 실행 시각

자주 쓰는 스케줄

  • * * * * *
    실행 시점
    매분
    단축 표현
  • */5 * * * *
    실행 시점
    5분마다
    단축 표현
  • */30 * * * *
    실행 시점
    30분마다
    단축 표현
  • 0 * * * *
    실행 시점
    매시 정각
    단축 표현
    @hourly
  • 0 */6 * * *
    실행 시점
    자정부터 6시간마다
    단축 표현
  • 0 0 * * *
    실행 시점
    매일 자정
    단축 표현
    @daily
  • 30 8 * * *
    실행 시점
    매일 오전 8:30
    단축 표현
  • 0 9 * * 1-5
    실행 시점
    월요일~금요일 오전 9:00
    단축 표현
  • 0 0 * * 0
    실행 시점
    매주 일요일 자정
    단축 표현
    @weekly
  • 0 0 1 * *
    실행 시점
    매월 1일 자정
    단축 표현
    @monthly
  • 0 0 1 */3 *
    실행 시점
    1월, 4월, 7월, 10월 1일 자정
    단축 표현
  • 0 0 1 1 *
    실행 시점
    매년 1월 1일 자정
    단축 표현
    @yearly

특수 문자

  • *
    의미
    필드의 모든 값.
    예시
    * * * * *
  • ,
    의미
    개별 값의 목록.
    예시
    0 9,18 * * *
  • -
    의미
    양 끝 값을 포함하는 값의 범위.
    예시
    0 9-17 * * *
  • /
    의미
    간격: 범위의 처음부터 세어 n번째 값마다.
    예시
    */10 * * * *

크론 표현식의 구조

크론 표현식은 공백으로 구분된 다섯 개의 필드, 즉 분, 시, 일, 월, 요일로 이루어집니다. 각 필드는 작업이 실행될 수 있는 때를 나타내며, 작업은 모든 필드의 조건이 맞는 분마다 실행됩니다.

필드에는 숫자 하나, 모든 값을 뜻하는 별표, 쉼표로 나열한 목록, 하이픈으로 나타낸 범위, 슬래시로 나타낸 간격을 쓸 수 있습니다. 월과 요일은 JAN이나 MON 같은 세 글자 영어 이름으로도 쓸 수 있습니다.

자주 틀리는 부분

맞아 보이는 스케줄도 예상하지 못한 시각에 실행될 수 있습니다.

  • 크론은 서버의 시간대를 사용하며, 이는 내 시간대와 다를 수 있습니다. 위의 실행 시각은 내 기기의 시간대를 기준으로 합니다.
  • 일과 요일을 모두 지정하면 둘 중 하나만 일치해도 작업이 실행됩니다.
  • 요일 필드에서는 0과 7이 모두 일요일을 뜻합니다.
  • */7 같은 간격은 시, 일, 월이 새로 바뀔 때마다 처음부터 다시 세므로 간격이 항상 일정하지는 않습니다.

자주 묻는 질문 (FAQ)

여섯 필드짜리 표현식은 왜 거부되나요?+

Linux와 macOS의 표준 크론은 다섯 필드를 사용합니다. 필드가 여섯 개나 일곱 개인 표현식은 Quartz, Spring 같은 스케줄러에서 쓰는 형식으로, 초 필드와 경우에 따라 연도 필드를 추가하고 ?나 L 같은 추가 기호를 사용합니다.

@daily 같은 단축 표현은 무엇을 뜻하나요?+

자주 쓰는 스케줄에 붙인 짧은 이름입니다. @hourly, @daily, @weekly, @monthly, @yearly는 각각 매시간, 매일, 매주, 매월, 매년이 시작될 때 실행됩니다. @reboot는 시스템이 시작될 때 한 번 실행되므로 표시할 실행 시각이 없습니다.

입력한 표현식이 어딘가로 전송되나요?+

아니요. 표현식 검사와 실행 시각 계산은 모두 브라우저에서 이루어집니다.

WebGround의 다른 도구 더 보기

전체 보기