Calculadora de TTL de Cache

Um TTL (time-to-live) de cache é quanto tempo uma resposta armazenada — uma entrada de cache do navegador, um cache de borda de CDN, uma chave Redis — é considerada "fresh" antes de precisar ser re-buscada ou re-validada contra a origem. Na web, a forma mais comum de expressar um TTL é o header de resposta HTTP Cache-Control: max-age=<seconds>, onde o valor é sempre em segundos, não em minutos ou horas. Essa incompatibilidade — pensar em horas ou dias mas tendo que digitar segundos — é onde erros se infiltram (um typo transforma "1 dia" em 864 segundos em vez de 86400).

Esta calculadora elimina a aritmética. Digite um valor de TTL e escolha sua unidade (segundos, minutos, horas, dias ou semanas), e ela instantaneamente converte o valor para total de segundos, explica uma duração legível por humanos, e escreve a string de header Cache-Control: max-age= correspondente que você pode colar direto em config de servidor, regra de CDN, ou código de aplicação.

Como usar

1. Digite o Valor TTL — qualquer número não-negativo, incluindo decimais (ex. 1.5).
2. Escolha a Unidade — Segundos, Minutos, Horas, Dias ou Semanas.
3. Leia a tabela de resultado:
   • Total Seconds — o número bruto que max-age espera.
   • Human-Readable Duration — o mesmo valor dividido em semanas, dias, horas, minutos e segundos (ex. "1 dia, 12 horas").
   • Cache-Control Header — a string de header pronta para usar (Cache-Control: max-age=7200).
   • Expires Header (relative) — um lembrete de que o header Expires mais antigo (uma data absoluta) é equivalente a "o tempo atual mais este número de segundos," para sistemas que ainda emitem Expires em vez de max-age.

O resultado é atualizado automaticamente conforme você digita — não há botão para clicar.

FAQ

Por que segundos especificamente? max-age (e seu irmão de cache compartilhado s-maxage) são definidos na especificação HTTP como um número inteiro de segundos. Esta ferramenta arredonda resultados fracionários (ex. 1.5 minutos) para o segundo mais próximo, já que max-age não suporta frações.

O que max-age=0 significa? Zero segundos significa que a resposta em cache está imediatamente stale — clientes devem revalidar com a origem antes de reutilizá-la. É diferente de no-store, que proíbe armazenar a resposta de todo; max-age=0 ainda permite cache, apenas com revalidação obrigatória.

Existe um TTL máximo útil? Praticamente, valores muito além de um ano (31536000 segundos) raramente agregam valor — a maioria dos navegadores e CDNs limitam o cache efetivo bem abaixo disso, e TTLs muito longos tornam difícil lançar mudanças sem cache-busting (ex. nomes de arquivo versionados). Dias-a-semanas é típico para ativos estáticos; segundos-a-minutos é típico para respostas de API dinâmicas.

E quanto a s-maxage, stale-while-revalidate, ou outras diretivas de Cache-Control? Esta ferramenta se concentra em converter um único TTL para max-age. Qualquer uma das diretivas acima usa a mesma unidade de "segundos", então o valor de Total Seconds aqui se conecta diretamente a s-maxage=<seconds>, stale-while-revalidate=<seconds>, etc. se você está montando um header mais complexo manualmente.

Privacidade

Tudo é executado localmente no seu navegador — o valor de TTL que você digita nunca é enviado para um servidor.