Quantos anos eu tenho? Idade exata em anos, meses e dias

«Quantos anos eu tenho?» é a forma em primeira pessoa de uma pergunta de idade exata: não só quantos aniversários inteiros já passaram, mas quantos meses restantes e quantos dias sobrando existem entre uma data de nascimento e uma data de referência escolhida. Quem digita essa frase quer um detalhamento civil que possa ser lido em voz alta — trinta e oito anos, quatro meses e dezesseis dias — para um formulário, um convite, um dossiê de visto ou a simples curiosidade sobre um dia futuro. Esta ferramenta nunca inventa o hoje com o relógio do servidor.

O que «quantos anos eu tenho?» realmente conta

«Quantos anos eu tenho?» é uma idade civil, não uma duração de relógio nem um único inteiro de anos completos. O motor percorre primeiro do nascimento até o último aniversário que já ocorreu na data de referência ou antes dela.

Esse aniversário usa o mês e o dia de nascimento, salvo que um vinte e nove de fevereiro se ajusta ao vinte e oito em um ano comum para que o dia de chegada sempre exista. Os anos concluídos são o número desses aniversários. A partir desse último aniversário o motor acrescenta meses de calendário inteiros, ajustando um dia de mês longo ao último dia de um mês mais curto, até que mais um mês ultrapassaria a referência.

O intervalo restante é contado em dias civis inteiros. Quem nasceu em nove de março de mil novecentos e oitenta e oito tem trinta e oito anos, quatro meses e dezesseis dias em vinte e cinco de julho de dois mil e vinte e seis, porque nove de março já passou e restam dezesseis dias depois de nove de julho. O mesmo par de datas civis produz sempre o mesmo tripleto, porque o motor nunca consulta um relógio do hospedeiro, um fuso horário nem tabelas de horário de verão.

Datas iguais devolvem zero anos, zero meses e zero dias: um instantâneo de recém-nascido no dia do parto. Use uma ferramenta vizinha de anos completos quando o formulário pedir só anos inteiros, e um auxiliar de data a data quando o par for um intervalo sem ordem e não uma idade. Use esta página quando a busca for «quantos anos eu tenho?»

e a resposta tiver de ser o detalhamento civil misto.

Contrato de entrada, validação de calendário e forma da resposta

Cada valor deve ser um dia civil no formato YYYY-MM-DD, por exemplo mil novecentos e oitenta e oito hífen zero três hífen zero nove para o nascimento e dois mil e vinte e seis hífen zero sete hífen vinte e cinco para o dia do instantâneo. Você pode prefixar uma data-hora ISO-8601 completa; se houver hora, só a parte de calendário é usada, porque «quantos anos eu tenho?» é uma medida civil de data a data, não uma duração de relógio com fusos.

Os anos vão de um a nove mil novecentos e noventa e nove, os meses de um a doze, e o dia deve existir naquele mês sob regras gregorianas de ano bissexto, incluindo vinte e nove de fevereiro só em anos bissextos. Se o nascimento cair estritamente depois da referência, o pedido falha com uma mensagem clara de que a idade não pode ser negativa. Ambos os extremos são obrigatórios de propósito: uma calculadora de «quantos anos eu tenho?»

que substitua em silêncio o relógio do hospedeiro produz respostas diferentes na integração contínua, em um notebook que cruza um meridiano e em um worker em Coordinated Universal Time, o que quebra auditorias e exportações reproduzíveis.

Onde uma calculadora de «quantos anos eu tenho?» se justifica

O texto de um convite e os painéis da família precisam de uma frase que se possa dizer em voz alta — quantos anos eu tenho no dia do casamento, no cruzeiro ou no primeiro dia de aula — não de um único inteiro que esconda os meses restantes. A admissão clínica e o acompanhamento pediátrico costumam imprimir anos, meses e dias ao lado do carimbo da visita para que o prontuário continue legível entre aniversários.

A admissão de recursos humanos e os instantâneos de seguros guardam o mesmo tripleto diante de uma data de auditoria para que exportações e suítes de regressão reproduzam sempre o mesmo detalhamento. Regras de concursos, classificações de cinema e acesso a produtos regulados ainda podem ler o campo years quando só precisam de um limiar, enquanto os meses e dias restantes ficam para a letra miúda.

Páginas de pais e demonstrações em sala podem executar a calculadora gratuita no navegador sem instalar uma biblioteca de datas nem enviar uma base de fusos a cada cliente. Mantenha expectativas honestas: esta capacidade mede a idade civil gregoriana entre duas datas explícitas; não pula fins de semana como idade útil, não carrega calendários de feriados, não converte idades lunares, não define a referência como hoje no servidor nem relê um par invertido como um intervalo absoluto.

Combine-a com um auxiliar de anos completos quando o produto pedir só anos inteiros, e com uma contagem regressiva de aniversário quando a pergunta for quantos dias faltam até o próximo aniversário. Como a implementação é parse pura de nível A, cada chamada bem-sucedida continua barata, determinística e livre de tokens de modelo ou rede de saída, exatamente o que suítes de regressão precisam ao fixar pares de dia bissexto e fim de mês ao longo de décadas de datas de nascimento.