Categorias

Testador de Expressão Cron

Testar e validar expressões cron, ver tempos de execução futuros

Fatos principais

Categoria
Development
Tipos de entrada
text, number
Tipo de saída
text
Cobertura de amostras
4
API disponível
Yes

Visão geral

O Testador de Expressão Cron é uma ferramenta essencial para desenvolvedores e administradores de sistemas validarem agendamentos de tarefas e visualizarem as próximas datas de execução de forma rápida e precisa.

Quando usar

  • Ao configurar novas tarefas agendadas em servidores Linux ou ambientes de nuvem.
  • Para depurar expressões cron complexas que não estão disparando no horário esperado.
  • Ao planejar a frequência de automações para garantir que os intervalos de tempo estejam corretos.

Como funciona

  • Insira sua expressão cron no campo principal seguindo o formato padrão de 5 campos.
  • Defina o número de execuções futuras que deseja visualizar para verificar o padrão de repetição.
  • Opcionalmente, insira uma data e hora de início para simular o comportamento do agendador a partir de um ponto específico no tempo.
  • Clique em processar para validar a sintaxe e listar as próximas ocorrências agendadas.

Casos de uso

Verificar se um script de backup configurado para rodar às 03:00 de segunda a sexta está correto.
Simular o comportamento de tarefas que rodam apenas no primeiro dia de cada mês.
Ajustar a frequência de envio de relatórios automáticos para evitar sobrecarga no servidor.

Exemplos

1. Agendamento de Backup Noturno

Administrador de Sistemas
Contexto
Preciso garantir que o backup do banco de dados ocorra todos os dias úteis às 02:30 da manhã.
Problema
Não tenho certeza se a sintaxe '30 2 * * 1-5' cobrirá corretamente todos os dias da semana sem falhas.
Como usar
Insira '30 2 * * 1-5' no campo de expressão e solicite 10 execuções.
Configuração de exemplo
cronExpression: '30 2 * * 1-5', testCount: 10
Resultado
A ferramenta lista as próximas 10 datas de execução, confirmando que o backup ocorrerá apenas de segunda a sexta-feira às 02:30.

2. Tarefa Mensal de Limpeza

Desenvolvedor Backend
Contexto
Uma tarefa de limpeza de logs deve rodar apenas no primeiro dia de cada mês às 00:00.
Problema
Validar se a expressão '0 0 1 * *' está configurada corretamente para o próximo mês.
Como usar
Insira '0 0 1 * *' e defina a data de início para o final do mês atual.
Configuração de exemplo
cronExpression: '0 0 1 * *', testStartDate: '2026-04-01T00:00'
Resultado
O sistema exibe as datas de execução para o primeiro dia de cada mês subsequente, validando a lógica do agendamento.

Testar com amostras

development

Hubs relacionados

FAQ

O que é uma expressão cron?

É uma string composta por cinco campos que define o agendamento de tarefas, especificando minutos, horas, dias do mês, meses e dias da semana.

Posso testar expressões com segundos?

Esta ferramenta foca no formato padrão de 5 campos (minuto, hora, dia, mês, dia da semana). Verifique se o seu sistema suporta extensões de 6 campos antes de testar.

Como a data de início afeta o resultado?

A data de início serve como ponto de referência; o sistema calculará as próximas execuções a partir desse momento específico, ignorando o horário atual.

A ferramenta valida erros de sintaxe?

Sim, se a expressão inserida for inválida ou estiver fora dos padrões aceitos, o sistema notificará o erro imediatamente.

Quantas execuções posso visualizar por vez?

Você pode solicitar até 20 execuções futuras para analisar o comportamento do seu agendamento a longo prazo.

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/cron-expression-tester

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
cronExpression text Sim -
testCount number Não -
testStartDate text Não -

Formato de resposta

{
  "result": "Processed text content",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}
Texto: Texto

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP:

{
  "mcpServers": {
    "elysiatools-cron-expression-tester": {
      "name": "cron-expression-tester",
      "description": "Testar e validar expressões cron, ver tempos de execução futuros",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=cron-expression-tester",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]