ForHosting KIT · Ferramentas para dev

Próximas execuções do cron

Você tem a expressão cron, mas quer ver as datas de verdade: quando esse agendamento dispara da próxima vez, e da seguinte. Cole a linha, escolha o fuso e receba a lista das próximas execuções em data e hora legíveis — sem esperar o servidor rodar para descobrir se acertou o horário.

● EstávelGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Da regra para o calendário

Uma expressão cron descreve um padrão, não uma agenda: 0 8 * * 1 é “toda segunda às 8h”, mas não diz qual segunda. Calcular as próximas execuções resolve isso — a ferramenta projeta o padrão para a frente e mostra as datas concretas: 20/07/2026 às 8h, 27/07/2026 às 8h, e assim por diante. É a forma mais rápida de confirmar que o agendamento cai onde você espera, antes de confiar nele em produção.

O fuso muda tudo

O mesmo padrão gera horários diferentes conforme o fuso. Servidores costumam rodar em UTC, e Brasília fica três horas atrás: 0 0 * * * dispara às 21h do dia anterior no horário de Brasília, não à meia-noite daqui. Ao listar as próximas execuções, escolha o fuso em que você quer ler — o do servidor para depurar, o de Brasília para avisar o time. Ver a mesma regra nos dois fusos lado a lado evita a confusão clássica do relatório que “roda um dia antes”.

Quando o dia do mês e o dia da semana brigam

Há uma regra sutil quando a expressão preenche ao mesmo tempo o dia do mês e o dia da semana: 0 0 13 * 5 não é “sexta-feira dia 13”, e sim “todo dia 13 OU toda sexta-feira” — o cron soma os dois, não cruza. Essa é uma das pegadinhas que só aparecem quando você olha as datas reais: se a lista das próximas execuções trouxer mais dias do que você imaginava, provavelmente é isso. Ver o calendário projetado é o jeito de flagrar a regra antes que ela surpreenda.

Prever execuções em escala

Precisa da próxima cobrança de cada assinatura, ou quer alimentar um painel com o horário do próximo processamento? Via API, o cálculo das próximas execuções sai por US$ 0,002 a chamada, preço publicado, com fuso e quantidade de datas configuráveis — o script devolve a agenda pronta para cada expressão. Para conferir um agendamento avulso, a página faz na hora, grátis e sem cadastro, sem mandar a expressão para lugar nenhum.

Casos de uso

Saber quando cai o próximo backup

O backup da Distribuidora Horizonte Verde roda por 0 2 * * 0. Antes de agendar uma manutenção, o time cola a expressão e vê que a próxima execução é domingo às 2h — e remarca a manutenção para não colidir.

Avisar o cliente da próxima fatura

A cobrança mensal dispara por 0 6 1 * *. O suporte lista as próximas datas e responde ao cliente com precisão: “sua próxima fatura é gerada em 01/08/2026 às 6h”, sem chutar.

Testar um agendamento novo sem esperar

O dev criou um job para rodar de hora em hora só em dias úteis. Em vez de esperar até amanhã para ver se acertou, lista as próximas dez execuções e confirma na hora que sábado e domingo ficaram de fora.

Perguntas frequentes

Por que a próxima execução aparece em um horário diferente do que eu esperava?

Quase sempre é fuso. O cálculo segue o fuso que você escolher; se o padrão foi pensado para UTC e você lê em Brasília, as horas saem três a menos. Selecione o fuso certo e as datas batem.

Consigo ver mais de uma data futura?

Sim — a ideia é justamente listar uma sequência: a próxima execução e as seguintes. Ver várias de uma vez ajuda a flagrar um intervalo errado, como um job que você achava diário e aparece de hora em hora.

Por que aparecem mais dias do que eu esperava no mês?

Se a expressão define dia do mês e dia da semana juntos, o cron soma os dois: dispara nos dois casos, não só quando coincidem. É o motivo mais comum de a lista trazer datas “a mais”.

Ele considera horário de verão?

O Brasil não adota horário de verão desde 2019, então para o fuso de Brasília não há troca. Para fusos que ainda mudam a hora, o cálculo usa a regra do fuso escolhido na data de cada execução.

Isso substitui rodar o cron de verdade?

Não — é uma previsão do padrão, útil para conferir antes de confiar no agendamento. Quem dispara a tarefa continua sendo o seu servidor ou o seu serviço de agendamento.

Tem custo? Meus dados ficam salvos?

Conferir uma expressão na página é grátis, sem cadastro, e nada é enviado para servidor nenhum. Para calcular execuções em volume, a API cobra US$ 0,002 por chamada, sempre em dólares e com o preço publicado aqui.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/dev/cron-next

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/dev/cron-next \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"items":["valor-1","valor-2"]}'

const res = await fetch("https://api.kit.forhosting.com/dev/cron-next", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "items": [
      "valor-1",
      "valor-2"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/cron-next",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "items": [
        "valor-1",
        "valor-2"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/cron-next", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"items":["valor-1","valor-2"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/cron-next", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.cron_next",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →

Executar grátis