크론 표현식 다섯 필드 검증과 다음 실행 시간 확인

다섯 필드 크론 표현식을 검증하고 현재 UTC 시각 이후의 다음 실행 시각 5개를 확인할 수 있습니다. 입력을 비워 두면 */5 * * * *가 기본값으로 사용됩니다.

크론 일정 확인에 필요한 기본 개념

크론 표현식은 정해진 일정에 따라 작업이 실행되는 시점을 표현하는 형식입니다. 이 도구는 다섯 필드로 구성된 크론 표현식의 입력을 확인하고, 계산에 성공하면 현재 UTC 시각을 기준으로 앞으로 발생할 실행 시각 5개를 보여 줍니다. 따라서 표현식의 형식이 맞는지 점검하거나, 등록하려는 일정이 언제 시작될지 미리 살펴보는 용도로 사용할 수 있습니다. 다만 화면에 표시되는 시각은 UTC를 기준으로 식별되므로 한국에서 사용하는 시간과 비교할 때에는 시차를 별도로 확인해야 합니다.

입력값을 생략하면 */5 * * * *가 기본 표현식으로 사용됩니다. 이 값은 다섯 필드 형식의 입력이 필요한 상황에서 별도 표현식을 넣지 않았을 때 적용되는 기본값입니다. 직접 일정을 확인하려면 원하는 표현식을 입력하고 계산 결과에 표시되는 다섯 개의 시각을 읽으면 됩니다. 표현식에 앞뒤 공백이 있거나 필드 사이에 공백이 여러 칸 있어도, 확인 전에는 앞뒤 공백이 제거되고 연속된 공백이 한 칸으로 정리됩니다.

표현식 입력부터 실패 점검까지

1. 확인할 크론 표현식을 입력합니다. 입력은 공백으로 나뉘는 필드가 정확히 5개여야 하며, 필드가 부족하거나 더 많으면 일정 계산 전에 실패합니다. 다섯 자리의 순서는 분, 시, 일, 월, 요일입니다. 첫 번째 자리는 분을, 두 번째 자리는 시를, 세 번째 자리는 일을, 네 번째 자리는 월을, 다섯 번째 자리는 요일을 나타내므로 순서를 바꾸지 마세요.

2. 필드 사이의 띄어쓰기를 살펴봅니다. 여러 칸의 연속 공백은 한 칸으로 정리되고 입력 양끝의 공백은 제거된 뒤 검증되므로, 공백의 개수만으로 필드 수를 판단하지 않는 편이 좋습니다. 대신 정리된 뒤에도 다섯 개의 값이 남는지 확인하세요. 입력을 비워 둔 경우에는 기본 표현식이 적용되므로, 빈 입력을 다른 형식의 오류와 같은 방식으로 해석하지 않아야 합니다.

3. 확인 또는 실행 기능을 선택해 계산을 시작합니다. 계산의 기준점은 현재 UTC 시각이며, 시작 시각에서 소수점 이하 초는 제외됩니다. 그러므로 같은 표현식이라도 확인한 시점에 따라 앞으로 표시될 일정의 출발점이 달라질 수 있습니다. 한국 표준시로 일정의 의미를 판단하려면 표시된 UTC 시각을 한국 시간과 대조해 읽으세요.

4. 성공 결과에서 이어지는 실행 시각 5개를 확인합니다. 다섯 값은 ISO 형식의 날짜·시간 문자열로 반환되며, 각 문자열에는 시간대가 UTC임을 식별할 수 있는 정보가 포함됩니다. 일정이 월별인지 주별인지 판단할 때에는 문자열의 날짜 부분과 표현식의 달력 조건을 함께 살펴보세요.

5. 실패 결과가 나오면 먼저 공백으로 구분된 필드 수를 세고, 각 위치에 맞는 문법과 값이 들어갔는지 차례로 점검합니다. 날짜, 값 또는 키를 해석하는 과정에서 처리되는 오류가 발생해도 성공한 일정 데이터 대신 실패가 반환됩니다. 문법이 겉보기에는 맞더라도 앞으로 일치하는 시각을 찾지 못하면 결과가 실패할 수 있으므로, 드문 날짜 조합이나 긴 반복 간격을 사용했는지도 확인하세요. 검색은 두 실행 시각 사이가 10년을 넘지 않는 범위로 설정되어 있습니다.

표시된 일정과 실패 결과 읽기

성공 결과의 다섯 항목은 입력한 일정이 앞으로 어떤 순서로 발생하는지 보여 주는 달력상의 발생 시각입니다. 이 값들은 임의의 설명문이나 상대적인 표현이 아니라 ISO 형식의 날짜·시간 문자열로 제공되며, UTC 시간대라는 점을 기준으로 읽어야 합니다. 현재 시각 이후의 발생 시각을 계산하므로 이미 지나간 시각이 목록의 첫 항목으로 표시된다고 가정하지 마세요.

월의 특정 날짜를 지정한 표현식은 해당 달력 조건에 맞는 날짜에 발생 시각을 만들 수 있습니다. 예를 들어 월의 첫날과 자정을 지정한 경우에는 각 달의 첫날 00:00에 해당하는 일정이 이어집니다. 표시되는 날짜 수는 성공 시 5개이므로 하나의 날짜만 확인하는 도구로 이해하기보다 이어지는 실행 순서를 점검하는 데 활용하는 것이 알맞습니다.

일과 요일을 함께 제한한 표현식은 두 조건을 동시에 만족해야만 일치하는 방식이 아닙니다. 두 제한 가운데 일 조건 또는 요일 조건에 맞으면 일치로 처리되므로, 예상보다 많은 날짜가 결과에 포함될 수 있습니다. 이 규칙을 모르면 표현식이 의도와 다르게 계산되었다고 판단할 수 있으니 날짜와 요일을 함께 작성한 뒤에는 두 조건을 각각 대입해 결과를 해석하세요.

실패는 필드 수가 틀린 경우에만 발생하지 않습니다. 입력의 문법이나 값의 해석에서 처리되는 오류가 생길 때에도 실패가 반환되며, 문법적으로 유효한 표현식이라도 다음 일치 시각이 10년 검색 범위 안에 없으면 성공 목록을 만들지 못합니다. 따라서 실패를 확인한 뒤에는 입력 형식과 함께 일정의 반복 간격, 지정한 달력 조건, 앞으로의 검색 범위를 함께 검토하는 것이 좋습니다.

사용 예시

매월 첫날 자정에 실행되는 일정을 점검하려는 상황에서 0 0 1 * *를 입력합니다.

0 0 1 * *를 입력한 뒤 확인 기능을 실행하고, 반환된 다섯 항목의 날짜 부분과 UTC 시간대 표시를 확인합니다.

성공 결과에는 UTC로 식별되는 ISO 형식 날짜·시간 문자열 5개가 표시되며, 각 값은 월의 첫날 00:00에 해당하는 달력 발생 시각입니다.

제한 사항

• 다음 일치 시각이 10년 검색 범위 안에 없으면 문법적으로 유효한 표현식도 실패할 수 있습니다.

자주 발생하는 오류

• 공백으로 나눈 값이 5개가 아니거나 분, 시, 일, 월, 요일 순서를 바꾸면 일정 계산 전에 실패합니다. 필드 수를 다시 세고 각 값을 정해진 위치에 배치한 뒤 재확인하세요.

자주 묻는 질문

크론 표현식을 입력하지 않으면 어떻게 되나요?

입력을 비워 둔 조건에서는 */5 * * * *가 기본 표현식으로 사용되어 다음 일정 계산이 진행됩니다.

6개 필드 크론 표현식도 확인할 수 있나요?

입력 필드가 6개인 조건은 다섯 필드 경계를 벗어나므로 실패하며, 이 도구에서 확인할 형식은 분, 시, 일, 월, 요일 순서입니다.

일과 요일 조건을 함께 쓰면 어떻게 계산되나요?

일과 요일 제한을 함께 둔 조건에서는 두 제한이 모두 맞아야 하는 것이 아니라 일 조건 또는 요일 조건에 맞을 때 일치로 계산됩니다.