Diferença em décadas entre datas

Informe uma data inicial e uma final no formato YYYY-MM-DD para receber um inteiro: positivo quando a data final for posterior, negativo quando for anterior e zero quando ainda não tiverem transcorrido dez anos completos. O cálculo aplica regras fixas do calendário gregoriano em UTC, sem permitir que a hora atual, o fuso horário do navegador ou qualquer serviço externo altere a resposta.

O que representa uma década completa nesta calculadora

Uma década completa é um intervalo de dez anos de calendário concluído a partir da primeira data, e não uma simples comparação dos nomes de décadas impressos em um calendário. De 15 de junho de 2000 a 14 de junho de 2020, apenas uma década inteira terminou, pois ainda falta um dia para o segundo aniversário de dez anos. Em 15 de junho de 2020, o resultado passa a dois. Essa distinção impede que datas próximas de um aniversário sejam arredondadas para cima apenas porque os números dos anos diferem em vinte. Ela também significa que duas datas podem estar em décadas nominais diferentes e ainda produzir zero. A saída é propositalmente um inteiro e descarta o restante incompleto depois do último aniversário de dez anos. Isso é útil quando uma política, um arquivo, um contrato ou uma regra de relatório se refere a décadas concluídas, e não a uma duração aproximada. As duas entradas devem ser datas ISO explícitas no formato YYYY-MM-DD, deixando a interpretação visível e reproduzível.

Direção do sinal, regras UTC e dias bissextos

O sinal segue a ordem em que você fornece as datas. Se a segunda data vier depois da primeira, a contagem será positiva. Se vier antes, a mesma quantidade de décadas completas será devolvida como um inteiro negativo. Datas iguais retornam zero. Portanto, inverter o par inverte o sinal sem mudar a magnitude, o que facilita ordenações, comparações e cálculos direcionais. A validação e a aritmética de calendário usam regras gregorianas prolépticas e não recorrem ao objeto Date do JavaScript. Não há conversão de fuso horário local, mudança de horário de verão, relógio atual, consulta de rede nem analisador dependente da localidade. Quando a data inicial é 29 de fevereiro, o aniversário é tratado como 28 de fevereiro se o ano de destino não for bissexto. Esse ajuste explícito fornece uma resposta estável nos limites de anos bissextos e mantém o cálculo coerente com a aritmética usual de durações de calendário. São aceitos anos de 0001 a 9999.

Como usar o resultado com segurança

Envie a data ISO inicial no campo from e a data ISO final no campo to. A resposta repete as duas entradas validadas, fornece a contagem de décadas com sinal e classifica a direção como para a frente, para trás ou zero. Use o inteiro diretamente quando precisar de períodos completos de dez anos, como ao agrupar programas duradouros pelo tempo transcorrido, verificar se um marco de aniversário foi alcançado ou descrever o intervalo entre registros históricos. Não o trate como uma estimativa decimal de anos: um resultado de três informa que três décadas completas de calendário transcorreram, não que as datas estejam separadas por exatamente trinta anos sem meses ou dias restantes. Esta capacidade também não deduz datas de expressões em linguagem natural, formatos regionais, carimbos de data e hora ou do momento presente. Essas exclusões são intencionais, pois entradas explícitas tornam chamadas repetidas à API determinísticas. Uma solicitação custa US$ 0,002 pela API, enquanto a versão no navegador usa o mesmo cálculo puro para produzir uma saída correspondente.