# Gerador e validador de expressões cron da AWS

Grátis, no seu navegador · EventBridge Scheduler e regras · funciona off-line

## Crie e verifique uma expressão

Tudo roda no seu navegador, também off-line: nada do que você digita é enviado. Compartilhe um agendamento copiando o endereço da página; a expressão fica depois do #.

Screenshot: Schedules: regras do EventBridge e agendamentos do Scheduler de hoje e de amanhã em uma mesma linha do tempo

No app CloudConsole

## Faça isso na sua própria conta

Verifique uma expressão aqui; veja todas no app. O Schedules coloca cada regra do EventBridge e cada agendamento do Scheduler da sua conta em uma mesma linha do tempo para as próximas 24 horas ou 7 dias, no seu fuso horário, com os destinos.

[Como funciona o Schedules → (EN)](https://cloudconsole.dev/app-tools/eventbridge-schedules-timeline)

[Baixar na App Store](https://apps.apple.com/app/cloudconsole-for-aws/id6835419710) · [Disponível no Google Play](https://play.google.com/store/apps/details?id=com.cloudconsole.app)

**Resposta curta**

Uma expressão cron da AWS tem seis campos, minutos, horas, dia do mês, mês, dia da semana e ano, dentro de `cron()`: `cron(0 9 ? * MON-FRI *)` roda às 09:00 em todo dia útil. Um dos dois campos de dia precisa ser `?`, o dia da semana vai de 1 = domingo a 7 = sábado, e as regras do EventBridge rodam em UTC, enquanto o EventBridge Scheduler pode usar qualquer fuso horário.

## Sintaxe do cron da AWS: os seis campos

As regras agendadas do EventBridge e o EventBridge Scheduler usam o mesmo formato de cron: `cron(minutes hours day-of-month month day-of-week year)`. Os seis campos são obrigatórios e separados por espaços.

| Campo | Valores | Curingas |
|---|---|---|
| Minutos | 0–59 | `, - * /` |
| Horas | 0–23 | `, - * /` |
| Dia do mês | 1–31 | `, - * ? / L W` |
| Mês | 1–12 ou JAN–DEC | `, - * /` |
| Dia da semana | 1–7 ou SUN–SAT (1 = domingo) | `, - * ? L #` |
| Ano | 1970–2199 | `, - * /` |

### Curingas

- `,` adiciona valores: `JAN,FEB,MAR` no mês significa janeiro, fevereiro e março.
- `-` é um intervalo: `1-15` no dia do mês são os dias 1 a 15. Os próprios exemplos da AWS incluem um intervalo que passa da meia-noite, `20-2` nas horas.
- `*` significa todos os valores. Você não pode usá-lo ao mesmo tempo no dia do mês e no dia da semana.
- `/` é um incremento: `1/10` nos minutos roda nos minutos 1, 11, 21 e assim por diante; `0/15`, a cada 15 minutos a partir da hora cheia. O dia da semana não aceita isso.
- `?` significa "qualquer" e vai no campo de dia que você não está usando: `7` no dia do mês com `?` no dia da semana roda no dia 7, seja qual for o dia da semana.
- `L` é o último dia: do mês no dia do mês, da semana no dia da semana. `6L` no dia da semana é a última sexta-feira do mês.
- `W` é o dia útil mais próximo: `3W` é o dia útil mais próximo do dia 3 do mês.
- `#` é a enésima ocorrência de um dia da semana no mês: `3#2` é a segunda terça-feira (3 é terça, o terceiro dia da semana). Um campo de dia da semana com `#` só pode conter essa expressão, então `3#1,6#3` é inválido.

Dois limites valem para toda expressão: você não pode definir os dois campos de dia (um precisa ser `?`), e expressões cron que rodariam mais de uma vez por minuto não são aceitas.

## Exemplos

| Expressão | Roda |
|---|---|
| `cron(0 10 * * ? *)` | 10:00 UTC todos os dias |
| `cron(15 12 * * ? *)` | 12:15 UTC todos os dias |
| `cron(0 18 ? * MON-FRI *)` | 18:00 UTC, de segunda a sexta |
| `cron(0 8 1 * ? *)` | 08:00 UTC no dia 1 de cada mês |
| `cron(0/15 * * * ? *)` | A cada 15 minutos |
| `cron(0/10 * ? * MON-FRI *)` | A cada 10 minutos, de segunda a sexta |
| `cron(0/5 8-17 ? * MON-FRI *)` | A cada 5 minutos das 08:00 às 17:55 UTC, de segunda a sexta |
| `cron(15 10 ? * 6L 2019-2022)` | 10:15 UTC na última sexta-feira de cada mês, de 2019 a 2022 |
| `cron(0 12 ? * 3#2 *)` | 12:00 na segunda terça-feira de cada mês |
| `cron(0 9 15W * ? *)` | 09:00 no dia útil mais próximo do dia 15 |

Os oito primeiros são da documentação da AWS. Nas regras do EventBridge, os horários são em UTC; no EventBridge Scheduler, estão no fuso horário do agendamento.

## Como o cron da AWS difere do cron do Unix

Uma linha de crontab não funciona do jeito que está. Cole-a no gerador e ele sugere a versão da AWS.

| Diferença | Cron do Unix | Cron da AWS |
|---|---|---|
| Campos | 5: minuto, hora, dia do mês, mês, dia da semana | 6: os mesmos cinco mais o **ano**, dentro de `cron( )` |
| Dia do mês e dia da semana | Os dois podem ser definidos; se ambos forem restritos, o job roda quando qualquer um coincidir | Um deles precisa ser `?`; não dá para restringir os dois |
| Domingo | 0 (e 7 na maioria das versões); os dias vão de 0 a 6 | 1; os dias vão de 1 a 7, de SUN a SAT |
| A cada 5 minutos | `*/5 * * * *` | `cron(0/5 * * * ? *)` ou `rate(5 minutes)` |
| Incrementos no dia da semana | Permitidos na maioria das versões | Não permitidos: liste os dias |
| L, W e # | Não existem no cron padrão | Último dia (`L`, `6L`), dia útil mais próximo (`15W`), enésimo dia da semana (`3#2`) |
| Fuso horário | O fuso horário do servidor | UTC nas regras do EventBridge; qualquer fuso horário IANA por agendamento no EventBridge Scheduler |

Nenhum dos dois tem campo de segundos. Expressões do Quartz e do Spring têm; remova o primeiro campo delas para obter a forma da AWS.

## Expressões rate()

Para um intervalo fixo, `rate(value unit)` é mais simples: `rate(5 minutes)`, `rate(1 hour)`, `rate(12 hours)`, `rate(1 day)`. O valor é um número inteiro positivo e a unidade é minutos, horas ou dias; não há segundos, semanas nem meses.

- As **regras do EventBridge** precisam da unidade no singular para o valor 1 e no plural acima de 1: `rate(1 hour)` e `rate(5 hours)` são válidas, `rate(1 hours)` e `rate(5 hour)` não são.
- O guia do **EventBridge Scheduler** lista as unidades como `minutes | hours | days` e ele mesmo escreve `rate(1 days)`.

Um agendamento rate conta a partir do início, não pelo relógio: a partir da criação da regra ou da `StartDate` de um agendamento do Scheduler (sem ela, ele começa a invocar imediatamente). Use cron quando precisar rodar em minutos específicos.

## Fusos horários e horário de verão

As **regras do EventBridge** avaliam o cron em UTC, e os exemplos da AWS estão todos em UTC+0. Para rodar às 09:00 de Nova York, você precisa calcular a hora em UTC e mudá-la quando os relógios mudam.

O **EventBridge Scheduler** avalia agendamentos cron e únicos no fuso horário que você dá ao agendamento (`--schedule-expression-timezone`, ou `ScheduleExpressionTimezone` no CloudFormation), do banco de dados de fusos IANA, e considera o horário de verão:

- Quando os relógios são adiantados, uma execução que cai na hora que deixa de existir é pulada naquele dia.
- Quando os relógios são atrasados, um horário que acontece duas vezes roda só uma vez, na segunda.
- `rate(1 days)` significa 24 horas, então em um dia de 23 ou 25 horas ele se desloca uma hora em relação ao relógio.

O gerador segue essas regras e sinaliza horários pulados ou repetidos. O Scheduler invoca os destinos com precisão de 60 segundos: uma execução prevista para 1:00 acontece entre 1:00:00 e 1:00:59, a menos que você defina uma janela de tempo flexível.

## Agendamentos únicos: at()

O EventBridge Scheduler também pode invocar um destino uma única vez em um horário definido: `at(2026-12-31T23:30:00)`, no fuso horário do agendamento. As regras do EventBridge não aceitam isso. Um agendamento único continua contando na sua cota de agendamentos depois de rodar, por isso a AWS recomenda excluí-lo depois.

## Fontes

- [Amazon EventBridge User Guide: Setting a schedule pattern for scheduled rules](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html)
- [EventBridge Scheduler User Guide: Schedule types (time zones and daylight saving time)](https://docs.aws.amazon.com/scheduler/latest/UserGuide/schedule-types.html)
- [CloudFormation: AWS::Scheduler::Schedule](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-scheduler-schedule.html)
- [CloudFormation: AWS::Events::Rule](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-events-rule.html)

## Perguntas frequentes

### Por que a AWS diz "Parameter ScheduleExpression is not valid"?

O EventBridge verifica a expressão inteira e a rejeita com essa ValidationException se alguma parte quebrar uma regra. As causas comuns são cinco campos em vez de seis, * no dia do mês e no dia da semana ao mesmo tempo (um deles precisa ser ?), 0 para domingo (a AWS conta de 1 a 7 a partir do domingo), um incremento / no dia da semana ou rate(1 minutes) em vez de rate(1 minute). Cole a expressão no gerador acima para ver qual campo está errado.

### O cron da AWS é em UTC?

Nas regras agendadas do EventBridge, sim: a expressão é sempre avaliada em UTC. O EventBridge Scheduler permite definir um fuso horário por agendamento (ScheduleExpressionTimezone, qualquer nome IANA como America/Sao_Paulo) e considera o horário de verão; sem ele, usa UTC.

### Como rodo uma função do Lambda a cada 5 minutos?

Use rate(5 minutes) ou cron(0/5 * * * ? *). Com o EventBridge Scheduler, crie um agendamento com a função como destino e uma função do IAM que o Scheduler possa assumir. Com uma regra do EventBridge, adicione a função como destino e dê ao EventBridge permissão para invocá-la com aws lambda add-permission.

### O que significa ? em uma expressão cron da AWS?

"Qualquer". O cron da AWS tem campos separados para dia do mês e dia da semana e não deixa restringir os dois, então o que você não usa precisa ser ?. Por exemplo, cron(0 9 ? * MON *) roda às segundas e cron(0 9 1 * ? *) no dia 1.

### Um agendamento do EventBridge pode rodar mais de uma vez por minuto?

Não. Expressões cron que resultam em frequências abaixo de um minuto não são aceitas, e rate() aceita minutos, horas ou dias. O EventBridge Scheduler também invoca os destinos com precisão de 60 segundos: um agendamento para 1:00 roda entre 1:00:00 e 1:00:59.

### O gerador envia minhas expressões para algum lugar?

Não. A análise e o cálculo dos horários de execução acontecem no seu navegador, inclusive a conversão de fuso horário, que usa os dados de fusos embutidos no navegador. Nada do que você digita é enviado, e a página não usa cookies.

**Quando um job agendado falha às 3 da manhã**

EventBridge, Lambda e os alarmes e logs do CloudWatch têm telas próprias no CloudConsole, então você vê qual alarme disparou e lê os logs da execução pelo celular, no iPhone e no Android.

[Sobre o app →](https://cloudconsole.dev/pt-br/aws-console-app)

## Veja também

- [Alarme do CloudWatch: EventBridge Scheduler InvocationDroppedCount (EN)](https://cloudconsole.dev/alarms/eventbridge-scheduler-invocationdroppedcount) – Alarmes do CloudWatch
- [Alarme do CloudWatch: EventBridge Scheduler TargetErrorThrottledCount (EN)](https://cloudconsole.dev/alarms/eventbridge-scheduler-targeterrorthrottledcount) – Alarmes do CloudWatch
- [aws lambda add-permission (EN)](https://cloudconsole.dev/cli/lambda-add-permission) – AWS CLI
- [Lambda: Task timed out after 3.00 seconds (EN)](https://cloudconsole.dev/errors/lambda-task-timed-out) – Correção de erro da AWS
- [Analisador de ARN da AWS](https://cloudconsole.dev/pt-br/tools/arn-parser) – Ferramenta grátis
- [Teste de latência da AWS](https://cloudconsole.dev/pt-br/tools/aws-latency-test) – Ferramenta grátis

---

Source: https://cloudconsole.dev/pt-br/tools/eventbridge-cron-builder

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
