ForHosting KIT · Ferramentas para dev

Como ler uma expressão cron

Uma expressão cron são cinco campos — minuto, hora, dia do mês, mês e dia da semana — que dizem a um servidor quando repetir uma tarefa. Cole a linha e receba a tradução em português claro: em vez de decifrar asteriscos e barras, você lê quando aquele agendamento realmente dispara.

● EstávelGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Os cinco campos, da esquerda para a direita

A ordem é sempre a mesma: minuto (0–59), hora (0–23), dia do mês (1–31), mês (1–12) e dia da semana (0–6, domingo é 0). Cada campo aceita um valor, uma lista ou um intervalo. Ler 30 8 * * 1 fica fácil quando você sabe a posição: minuto 30, hora 8, qualquer dia do mês, qualquer mês, segunda-feira — ou seja, toda segunda às 8h30. Trocar a ordem dos campos na cabeça é o erro que mais gera agendamento no horário errado.

Asterisco, barra, vírgula e hífen

O asterisco quer dizer “todos os valores” do campo. A barra define passo: um asterisco com /15 no minuto é “a cada 15 minutos”. A vírgula lista valores soltos: 1,15 no dia do mês roda no dia 1º e no dia 15. O hífen marca intervalo: 9-18 na hora cobre das 9h às 18h. Combinando tudo, 0 9-18 * * 1-5 vira “de hora em hora, das 9h às 18h, de segunda a sexta”. A tradução monta essa frase para você, sem risco de somar os campos errado.

Cuidado com os apelidos e o fuso

Além dos números, muitas ferramentas aceitam apelidos como @daily, @hourly ou @reboot, e alguns sistemas incluem um sexto campo para segundos ou para o ano. Nem todo agendador entende os mesmos atalhos: o cron do Linux, o do GitHub Actions e o de um framework podem divergir num detalhe. E há a pegadinha do fuso: a maioria dos servidores roda em UTC, então 0 0 * * * dispara à meia-noite de Londres — 21h do dia anterior em Brasília. A tradução deixa a regra explícita para você conferir contra o fuso certo.

Conferir muitos agendamentos de uma vez

Revisar o crontab inteiro de um servidor, ou auditar os agendamentos de um projeto antes de subir para produção, é onde a tradução em lote ajuda. Via API, cada expressão é traduzida por US$ 0,002 a chamada, com o preço publicado aqui na página — o script percorre o arquivo e devolve a explicação de cada linha em português. Para tirar a dúvida de uma expressão só, a página resolve grátis, direto no navegador, sem cadastro e sem enviar nada para servidor nenhum.

Casos de uso

Herdou o servidor de outra pessoa

Você assumiu a infra da TecnoSul Soluções Digitais e o crontab tem 15 linhas sem um comentário. Cola cada expressão, lê a tradução e descobre que dois backups rodam no mesmo minuto — de madrugada, brigando por disco.

Conferir antes de subir para produção

Antes do deploy, o dev cola a expressão do novo job para ter certeza de que 0 3 * * * é “toda madrugada às 3h” e não “às 3h de todo dia 3”. Dois segundos que evitam um relatório rodando no dia errado.

Explicar o agendamento para o time

A analista precisa avisar o suporte quando a fatura mensal é gerada. Em vez de mandar 0 6 1 * * no grupo do WhatsApp, ela manda a frase pronta: “todo dia 1º às 6h”. Todo mundo entende, sem saber cron.

Perguntas frequentes

O primeiro campo é hora ou minuto?

Minuto. A ordem é minuto, hora, dia do mês, mês, dia da semana — da esquerda para a direita. Trocar minuto e hora de lugar é o engano mais comum; a tradução mostra cada campo com nome para você não errar.

Domingo é 0 ou 7?

Na maioria dos crons, domingo é 0 — e vários também aceitam 7 para o mesmo domingo. Segunda é 1, e assim por diante até sábado, que é 6. Quando a expressão usa nome (SUN, MON), a leitura fica mais segura.

O que significa a barra, tipo o asterisco com /5?

É passo: no campo de minuto, quer dizer “a cada 5 minutos”. Na hora, um asterisco com /2 é “a cada 2 horas”. É diferente de um valor fixo — por isso a frase traduzida diz “a cada”, e não “às”.

A que fuso horário a expressão obedece?

Ao fuso do servidor que roda o cron, que quase sempre é UTC. 0 0 * * * dispara à meia-noite UTC, ou seja, 21h em Brasília. A tradução mostra a regra; conferir o fuso do seu servidor é com você.

Isso funciona com o cron do meu framework?

A leitura dos cinco campos é padrão e vale para crontab de Linux, GitHub Actions e a maioria dos agendadores. Apelidos como @daily e o sexto campo de segundos variam de sistema para sistema — confira a documentação do seu quando aparecerem.

Precisa instalar algo ou fazer cadastro?

Não. A tradução roda direto no navegador, de graça e sem limite; a expressão que você cola não é enviada para servidor nenhum. Para traduzir muitas expressões de uma vez, existe a API, a US$ 0,002 por chamada, sempre em dólares.

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-explain

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-explain \
  -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-explain", {
  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-explain",
    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-explain", 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-explain", 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_explain",
  "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