ForHosting KIT · Ferramentas para dev

Data da sua próxima idade redonda

A calculadora da próxima idade redonda encontra o dia em que uma pessoa atingirá, depois da referência, uma idade divisível por dez, como 30, 40, 50 ou 60 anos.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Informe uma data de nascimento ISO e uma data de referência ISO explícitas; o resultado não consulta o relógio nem presume um fuso horário. A resposta mostra a idade completa na referência, a próxima idade redonda e sua data exata. Todos os cálculos seguem o calendário gregoriano proléptico em UTC, tornando chamadas repetidas à API determinísticas e adequadas a registros, campanhas agendadas e testes.

Escolha uma referência explícita para uma resposta reproduzível

O próximo aniversário de década depende de quando a pergunta é feita, por isso esta calculadora nunca substitui a referência pela data de hoje. Forneça birth_date e reference_date como datas ISO completas no formato YYYY-MM-DD. A referência deve ser igual ou posterior ao nascimento. Os dois valores são interpretados como datas civis UTC, sem deslocamento local, horário de verão ou hora atual oculta. Assim, uma solicitação salva é reproduzível: a mesma entrada retorna a mesma resposta amanhã, em outro país ou em um ambiente de testes. A saída contém as entradas validadas, a idade completa na referência, o próximo múltiplo de dez e a data em que ele será alcançado. Use como referência a data do evento de negócio relevante, como a preparação de uma lista de e-mails ou o início de uma revisão de benefícios. Isso evita que um processo próximo da meia-noite atribua datas de marco diferentes em regiões distintas.

Entenda o significado de próxima idade redonda

Uma idade redonda é uma idade positiva divisível por dez. Primeiro, o cálculo determina os anos civis completos na data de referência; depois, seleciona o múltiplo de dez estritamente maior. Uma pessoa com 32 anos caminha para 40, enquanto uma com 9 caminha para 10. A regra de estritamente maior também vale no próprio marco: se a referência for o 40º aniversário, a próxima idade redonda será 50, não 40, pois 40 já foi alcançada. A comparação usa mês e dia, e não uma média de dias por ano, portanto anos bissextos e meses de tamanhos diferentes não causam erro de um ano. A data-alvo preserva mês e dia do nascimento quando essa data existe. Os resultados abrangem os anos 0001 a 9999 do calendário gregoriano proléptico. Se o marco ultrapassar 9999, a solicitação será rejeitada em vez de produzir uma data inventada ou truncada. O método usa aritmética inteira e nunca recorre a relógio, aleatoriedade ou rede.

Trate aniversários de 29 de fevereiro de forma consistente

Um nascimento em 29 de fevereiro exige uma regra explícita, porque muitos anos-alvo não contêm esse dia. Esta capacidade considera 28 de fevereiro como aniversário em anos não bissextos e mantém 29 de fevereiro quando o ano-alvo é bissexto. A mesma regra determina a idade completa e constrói a data do próximo marco, evitando divergência entre as duas partes. Trata-se de uma convenção computacional determinística, não de uma afirmação sobre a regra legal de cada jurisdição; algumas leis e políticas adotam 1º de março. Se um direito, contrato ou aviso regulado depender do aniversário, confirme a regra aplicável. Para planejamento, análise, lembretes, segmentação de CRM e testes reproduzíveis, a convenção declarada de 28 de fevereiro fornece um resultado estável. A resposta inclui february_29_rule até para aniversários comuns, permitindo que sistemas posteriores registrem a convenção sem consultar documentação. Cada solicitação API custa US$ 0,002, e nenhuma data de nascimento é enviada a terceiros.

Casos de uso

Planejar uma comemoração marcante

Converta uma data de nascimento conhecida na data exata do próximo aniversário de década para convites, orçamentos ou lembretes.

Agendar uma campanha de CRM

Calcule uma data estável para 30, 40 anos ou outro marco usando a referência da campanha, sem desvio do relógio do servidor.

Criar testes determinísticos de datas

Teste a lógica de aniversário com entradas ISO fixas, incluindo o próprio dia do marco e casos de 29 de fevereiro.

Perguntas frequentes

O que conta como a próxima idade redonda?

É o menor múltiplo de dez estritamente maior que a idade completa na data de referência.

O que acontece no 40º aniversário?

Como 40 já foi alcançada nessa data, a próxima idade redonda é 50.

Como são tratados os nascimentos em 29 de fevereiro?

Usa-se 28 de fevereiro em aniversários não bissextos e mantém-se 29 de fevereiro nos anos bissextos.

A calculadora usa a data de hoje?

Não. reference_date é obrigatória, e o cálculo nunca consulta o relógio do sistema.

Quanto custa um cálculo pela API?

Cada item custa US$ 0,002. O cálculo também é puro e não usa serviços de rede de terceiros.

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/date/next-round-age-day

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/date/next-round-age-day \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth_date":"1994-08-17","reference_date":"2026-08-13"}'

const res = await fetch("https://api.kit.forhosting.com/date/next-round-age-day", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "birth_date": "1994-08-17",
    "reference_date": "2026-08-13"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/next-round-age-day",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "birth_date": "1994-08-17",
    "reference_date": "2026-08-13"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/next-round-age-day", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"birth_date":"1994-08-17","reference_date":"2026-08-13"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"birth_date":"1994-08-17","reference_date":"2026-08-13"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/next-round-age-day", 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

{
  "birth_date": "1994-08-17",
  "reference_date": "2026-08-13"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.next_round_age_day",
  "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 →