Calculadora do número do aniversário
Descubra qual aniversário um dia específico marca: quem foi contratado em 15 de março de 2014 completa 10 anos de casa em 15 de março de 2024. As datas do último e do próximo aniversário também aparecem. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Data do evento
- 2014-03-15
- As of
- 2024-03-15
- Número do aniversário
- 10
- Número do aniversário
- 10th
- Data do último aniversário
- 2024-03-15
- Data do próximo aniversário
- 2024-03-15
As pessoas buscam qual número de aniversário quando precisam de uma resposta clara a uma pergunta prática: se alguém foi contratado em um determinado dia do calendário, qual aniversário de trabalho cai em uma data posterior—o quinto, o décimo, o vigésimo quinto? A mesma necessidade aparece em aniversários de casamento, marcos de lançamento de produto, renovações de assinatura e prêmios por tempo de serviço que disparam ao completar anos inteiros a partir de um evento original. Ferramentas genéricas de diferença de datas devolvem dias totais ou uma idade completa; não dizem «este é o décimo aniversário» com rótulo ordinal e um sinal de se o dia de referência é o próprio dia de aniversário observado. Esta capacidade aceita duas datas de calendário ISO estritas, valida as regras gregorianas de ano bissexto, conta anos completos com lógica de mês e dia no estilo da idade, trata eventos de vinte e nove de fevereiro como observados em vinte e oito em anos não bissextos, e devolve o número do aniversário, o ordinal em inglês, as strings ISO do último e do próximo aniversário e uma fórmula curta.
Como o número do aniversário é calculado a partir de duas datas ISO
Comece com duas datas civis de calendário na forma internacional ISO ano-mês-dia com larguras fixas para que todo cliente concorde nos mesmos seis inteiros: a data original do evento (dia de admissão, casamento, fundação, primeira cobrança de assinatura) e a data de referência que você deseja rotular.
Em cada string confirme que o ano está no intervalo gregoriano prático de um a nove mil novecentos e noventa e nove, que o mês está entre um e doze, e que o dia existe para aquele mês sob as regras de bissexto gregorianas: um ano é bissexto quando é divisível por quatro, exceto que anos seculares só são bissextos quando também são divisíveis por quatrocentos.
Essa regra torna legal o vinte e nove de fevereiro em anos como dois mil vinte e quatro e dois mil, e ilegal em dois mil vinte e três e mil novecentos. Quando ambos os triplos são válidos e o dia de referência não é anterior ao evento, subtraia o ano do evento do ano de referência para obter uma contagem candidata de anos e verifique se o mês e o dia de referência já alcançaram o dia de aniversário observado no ano de referência.
Se o dia de referência ainda estiver antes daquele mês e dia observados, subtraia um para nunca reivindicar um aniversário completo que ainda não ocorreu. O dia de aniversário observado é o mesmo mês e dia do evento, exceto que um evento em vinte e nove de fevereiro é observado em vinte e oito em anos não bissextos para que todo ano ainda tenha um dia de calendário concreto. No próprio dia do evento o número completo é zero—o dia do evento, ainda não o primeiro aniversário.
Um ano depois no dia observado o número é um; dez anos depois é dez, e assim por diante.
Onde calculadoras de número de aniversário aparecem no trabalho real
Equipes de recursos humanos e de operações de pessoas geram listas de prêmios por tempo de serviço que dizem quem atinge o quinto, décimo ou vigésimo quinto aniversário de trabalho em um dia de calendário ou em uma janela futura, e precisam de um número determinístico em vez de uma string de idade em texto livre. Planejadores de casamentos e eventos agendam jantares comemorativos no dia exato do aniversário e querem um ordinal claro para convites e programas impressos.
Sistemas de produto e de membros desbloqueiam distintivos, descontos ou níveis de fidelidade em anos completos desde o cadastro ou a primeira compra e devem concordar com a página de aniversário voltada ao cliente. Se mais tarde você precisar de dias absolutos entre duas datas sem ordem, idade em anos meses e dias, contagens de dias úteis que pulam fins de semana, ou soma pura de dias a uma única base, trate-os como intenções de busca e landings distintas em vez de sobrecarregar esta página de número de aniversário.
Casos de uso
Listas de prêmios de trabalho e tempo de serviço
A partir de uma data ISO de admissão e um dia de referência, obtenha o número e o ordinal do aniversário de trabalho completo para o RH sinalizar o quinto, décimo e vigésimo quinto prêmio sem contar à mão.
Marcos de casamento e pessoais
Rotule qual aniversário de casamento ou de relacionamento cai em uma data de celebração planejada, inclusive se esse dia é o dia de aniversário observado exato.
Portões anuais de membros e fidelidade
Desbloqueie distintivos ou descontos por ano quando o dia de referência de um membro atingir um número de aniversário completo desde o cadastro ou a primeira compra.
Perguntas frequentes
Qual é o número do aniversário no dia original do evento?
Zero. O dia do evento é o início, ainda não o primeiro aniversário. Um ano depois no dia observado o número é 1; dez anos depois é 10.
Como são tratados eventos de 29 de fevereiro (dia bissexto)?
Em anos não bissextos o aniversário é observado em 28 de fevereiro para que todo ano tenha um dia de calendário concreto. Em anos bissextos permanece 29 de fevereiro.
Que número aparece se o aniversário deste ano ainda não chegou?
O anterior. Só contam os anos completos, então na véspera de 15 de março de 2024 quem foi contratado em 15 de março de 2014 ainda está no nono aniversário, não no décimo.
A calculadora mostra quando cai o próximo aniversário?
Mostra. Além do número, você recebe a data do aniversário mais recente e a do próximo, e um aviso dizendo se o dia consultado é exatamente o dia do aniversário.
Serve para casamentos ou marcos de uma empresa?
Serve. Qualquer evento de origem funciona: uma contratação, um casamento, a fundação de uma empresa ou a entrada como associado. Informe essa data e o dia que quer conferir.
Ferramentas relacionadas
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
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/anniversary-number \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"event_date":"2014-03-15","as_of":"2024-03-15"}'const res = await fetch("https://api.kit.forhosting.com/date/anniversary-number", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"event_date": "2014-03-15",
"as_of": "2024-03-15"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/anniversary-number",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"event_date": "2014-03-15",
"as_of": "2024-03-15"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/anniversary-number", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"event_date":"2014-03-15","as_of":"2024-03-15"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"event_date":"2014-03-15","as_of":"2024-03-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/anniversary-number", 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
{
"event_date": "2014-03-15",
"as_of": "2024-03-15"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.anniversary_number",
"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
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. |
Notas técnicas
O que você envia e o que recebe de volta
Envie dois campos de string obrigatórios: event_date e as_of, cada um um dia de calendário ISO estrito como dois mil quatorze hífen zero três hífen um cinco e dois mil vinte e quatro hífen zero três hífen um cinco. Aliases comuns como hire_date, original, start, check_date, reference_date e on são aceitos pelo mesmo núcleo para que scripts de RH e formulários SEO usem nomes familiares sem mudar a matemática. Campos ausentes, valores que não são string, strings que não batem com o padrão de quatro-dois-dois dígitos, datas que batem com o padrão mas não são dias de calendário reais, e um dia as_of anterior ao evento falham com invalid_input e não são cobrados. Em caso de sucesso a resposta ecoa as strings ISO normalizadas de event_date e as_of; anniversary_number como os anos completos não negativos; anniversary_ordinal como o rótulo em inglês (por exemplo tenth ou first); is_anniversary_day true quando o dia as_of coincide com o mês e dia de aniversário observados naquele ano; last_anniversary_date e next_anniversary_date como strings ISO do aniversário mais recente em ou antes de as_of e do próximo em ou depois de as_of; first_anniversary_date quando o ano do primeiro aniversário permanece no intervalo suportado; e uma string de fórmula curta que documenta a regra no estilo da idade e a observação de vinte e nove de fevereiro. Verificações clássicas incluem admissão em quinze de março de dois mil quatorze e as_of em quinze de março de dois mil vinte e quatro gerando o número dez com is_anniversary_day true; o dia anterior àquele décimo aniversário gerando nove com is_anniversary_day false; o próprio dia do evento gerando zero; e um evento de dia bissexto observado em vinte e oito de fevereiro em um ano comum. O preço de chamadas API bem-sucedidas é a base publicada de US$ 0,002 por item; falhas de validação não consomem saldo pré-pago.
Onde calculadoras de número de aniversário aparecem no trabalho real
Jornalistas e boletins internos escrevem «completa dez anos desde o lançamento» e precisam da contagem completa para um dia as_of específico, não de um delta bruto de dias. Como esta capacidade é um motor parse puro, o preço da API é a base publicada de US$ 0,002 por item bem-sucedido e a validação falha não consome saldo.
Perguntas técnicas
Como descubro qual número de aniversário uma data representa?
Envie event_date e as_of como strings ISO YYYY-MM-DD. A API devolve anniversary_number como anos completos desde o evento (estilo idade), mais anniversary_ordinal como 10th, e is_anniversary_day quando as_of coincide com o dia de aniversário observado.
E se as_of for anterior à data do evento?
A tarefa falha com invalid_input. Não é possível calcular um número de aniversário antes do evento original, e entrada inválida não é cobrada.
Quanto custa a calculadora do número do aniversário?
A ferramenta do navegador é gratuita. Solicitações API usam saldo pré-pago do KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.