01
시간대보다 서비스를 먼저 고르세요
기본값은 Scheduler입니다. 기존 규칙으로 전환하면 유효 시간대는 UTC로 고정되고, 돌아오면 이전 Scheduler 시간대가 복원됩니다. 서비스나 적용 중인 값을 변경하면 이전 결과의 내보내기는 바로 잠깁니다.
- 브라우저 시간대를 자동으로 적용하지 않습니다.
Cron & Scheduling
EventBridge cron 표현식서비스에 맞게 실행 조건 확인
기존 표현식을 검사하거나 필드로 초안을 만든 뒤 미리 보고 적용하세요.
EventBridge cron 표현식
표현식
입력은 이 브라우저에서 처리되며 서버로 전송되지 않습니다.
일정 설정 조각
일정 속성만 출력합니다. AWS에서 이름, 대상, 권한을 추가해야 하며 Scheduler에는 대상 실행 역할도 필요합니다. 이 조각만으로 리소스가 생성되지는 않습니다.
옵션
필드 구성
이 필드는 초안입니다. 적용해야 위 표현식을 바꾸며, 붙여 넣은 입력이 실제 검증 대상입니다.
cron(0 9 ? * MON-FRI *)
순서: 분, 시, 날짜, 월, 요일, 연도. 일요일은 1이며 날짜와 요일 중 정확히 하나가 ?여야 합니다. L, 15W, FRIL, MON#1은 해당 날짜 필드에 단독으로 사용합니다.
표현식 한 개, 최대 256자. 연도 1970–2199. 초, at(), LW, L 오프셋은 지원하지 않습니다. 역순 범위는 시 필드만 지원하며 실제 날짜 발생 여부는 계산하지 않습니다.
입력 또는 옵션이 변경되었습니다. 결과를 갱신한 뒤 내보내세요.
매일 오전 9시로 설정했는데 예상과 다른 시각에 실행된다면 서비스의 시간 기준부터 확인하세요. EventBridge cron 표현식은 마지막 필드가 연도이고 일요일 번호가 1입니다. 날짜와 요일을 동시에 지정할 수 없다는 점도 일반적인 crontab과 다릅니다.
EventBridge 스케줄러에서 평일 아침을 지정하는 것과 rate 표현식으로 5분 간격을 지정하는 것은 다른 작업입니다. 시간대는 표현식 밖의 속성이며, 기존 예약 규칙은 UTC만 사용합니다.
EventBridge cron 표현식 생성기를 쓰는 이유
규칙과 Scheduler의 시간 기준 분리
EventBridge cron 표현식 자체에는 시간대를 넣지 않습니다. Scheduler를 선택하면 별도 속성을 생성하고 기존 규칙에서는 그 속성을 제외합니다. 같은 9시라는 필드가 UTC인지 지역 시각인지 출력에서 확인할 수 있습니다.
달력 조건과 경과 시간 구분
평일 오전에 보내는 보고서는 cron 조건에 맞고, 5분마다 반복하는 작업은 rate에 맞습니다. 필드 여섯 개와 간격 값 입력을 분리해 달력 조건을 rate() 안에 잘못 넣는 일을 줄입니다.
실행 시각을 잘못 해석하지 않으려면
02
초안과 원본 입력을 구분하세요
예시 선택은 아래 필드만 채웁니다. 미리보기에서 바뀔 표현식과 글자 수를 확인한 뒤 적용하세요. 실행 취소는 원본, 설정과 이전 결과를 함께 복구합니다.
- 초안만 편집하면 붙여 넣은 원본은 바뀌지 않습니다.
03
검증 상태를 보고 내보내세요
자동 검증은 마지막 변경 후 350ms를 기다립니다. 끄면 버튼이나 Ctrl/Cmd + Enter로 실행할 수 있습니다. 표현식만 복사하거나 JSON 일정 속성을 내려받으세요.
- 구문 통과는 대상 호출 성공을 보장하지 않습니다.
실행 조건을 구성하는 기능
AWS 필드별 범위 검사
분과 시뿐 아니라 연도, 1–7 요일 번호를 따로 확인합니다. JAN–DEC와 SUN–SAT 이름도 유지합니다. 목록, 범위, 증분은 허용하는 필드에서만 사용할 수 있고 오류에는 필드와 시작 열이 표시됩니다.
월말과 특정 주의 요일 지정
날짜의 L과 숫자W, 요일의 L·요일L·요일#횟수를 검사합니다. 날짜와 요일 중 하나만 ?여야 합니다. 여러 # 조건이나 지원하지 않는 Quartz 조합을 유효한 표현식으로 통과시키지 않습니다.
서비스에 맞는 속성 출력
Scheduler cron은 ScheduleExpressionTimezone을 포함하며 FlexibleTimeWindow는 명시적으로 OFF입니다. 기존 규칙은 ScheduleExpression만 출력합니다. Scheduler rate에는 지역 시각으로 오해하지 않도록 시간대 속성을 넣지 않습니다.
생성과 붙여넣기에 동일한 검증
포장 없는 여섯 필드에는 결과에서 cron(...)을 붙입니다. 대소문자와 공백을 정리하지만 원본을 자동으로 덮어쓰지는 않습니다. Rate 생성기는 값에 따라 단수와 복수 단위를 선택하고 입력한 표현식에도 같은 규칙을 적용합니다.
지원 구문과 배포 범위
- 명시한 구문만 지원
- 날짜는 L 또는 nW, 요일은 L, weekdayL, weekday#1–5를 지원합니다. LW, L 오프셋, C, H, 특수 선택자 혼합 목록과 요일 증분은 지원하지 않습니다. 시 이외의 역순 범위는 정순 범위나 목록으로 나누세요.
- 실제 실행 날짜는 계산하지 않음
- 2월 31일, 해당 월에 없는 다섯 번째 요일, 과거 연도도 필드 구문 검사에는 통과할 수 있습니다. 다음 실행 시각이나 횟수를 계산하지 않으며 초 단위의 정확한 호출도 보장하지 않습니다.
- Rate 단위를 표준 형태로 제한
- JavaScript가 안전하게 표현할 수 있는 양의 정수를 사용합니다. 이 도구는 rate(1 minute), rate(5 minutes)처럼 단수와 복수를 맞춥니다. 모든 비표준 형태를 Scheduler API가 거부한다고 주장하는 것은 아닙니다.
- 배포에 필요한 대상 설정은 별도
- AWS에 연결하거나 IAM을 확인하지 않습니다. 이름, 대상 ARN, 실행 역할과 권한을 직접 추가하세요. 시작·종료일, 재시도, DLQ, 유연한 시간 창 편집은 포함하지 않으며 OFF는 이 출력의 명시적인 선택입니다.
- AWS 반복 일정만 처리
- 전체 표현식은 최대 256자, 연도는 1970–2199입니다. Unix 다섯 필드, Quartz 일곱 필드, 일회성 at(), 파일 가져오기와 다른 클라우드 문법은 처리하지 않습니다. IANA 지원은 브라우저 시간대 데이터에 따라 달라집니다.
EventBridge cron 표현식 질문
cron 표현식이 잘못되었다고 나오는 이유는 무엇인가요?
분부터 연도까지 여섯 필드인지, 날짜와 요일 중 정확히 하나가 ?인지 확인하세요. 일요일은 Unix의 0 대신 1을 사용합니다. EventBridge cron 표현식 검증기는 필드 범위 오류와 지원하지 않는 문자 조합을 구분해 알려 줍니다.
UTC가 아닌 시간대는 어떻게 쓰나요?
Scheduler를 선택하고 Asia/Seoul 같은 IANA 이름을 입력하세요. 표현식의 시각은 유지하고 별도 속성으로 지역을 지정합니다. 기존 예약 규칙은 UTC 고정이므로 표시 시간대를 바꿔도 실제 시간 기준이 바뀌지 않습니다.
일광 절약 시간은 어떻게 처리하나요?
Scheduler cron은 앞으로 이동해 사라지는 시각을 건너뛰고 뒤로 이동해 반복되는 시각은 한 번만 실행합니다. Rate의 하루는 항상 24시간입니다. 지역의 매일 같은 시각이 목적이면 cron을 쓰세요.
예약 규칙과 Scheduler는 어떻게 다른가요?
예약 규칙은 UTC를 사용하는 기존 방식입니다. Scheduler는 이름이 있는 시간대와 별도의 호출 설정을 지원합니다. 여기서는 일정 속성 차이를 보여 주며, 대상 이전이나 IAM 검증은 하지 않습니다.
Terraform에서는 표현식을 어떻게 사용하나요?
달력 필드는 cron(...), 값과 간격 단위는 rate(...)를 사용합니다. 해당 리소스의 schedule_expression에 넣고 Scheduler cron이면 schedule_expression_timezone도 따로 지정하세요. 다운로드는 JSON 참고 조각이며 완성된 HCL 리소스가 아닙니다.
예상과 다른 실행 시각인가요?