Consulte a geração pelo ano de nascimento

O resultado inclui o ano normalizado, o nome da coorte e os anos inicial e final inclusivos usados na correspondência. Esta consulta é útil quando um relatório, formulário, exercício acadêmico, resumo de público ou fluxo de dados precisa de um rótulo consistente sem manter uma tabela própria de limites. Os intervalos são fixos, transparentes e determinísticos; portanto, a mesma entrada sempre produz a mesma saída.

Entenda o que a consulta retorna

A consulta de coorte geracional recebe um ano de nascimento e o compara com uma tabela fixa de intervalos inclusivos. Uma resposta bem-sucedida apresenta o ano enviado, o nome conhecido da coorte e o primeiro e o último ano dessa faixa. Por exemplo, um ano entre 1981 e 1996 é retornado como Millennial, enquanto um ano entre 1997 e 2012 é retornado como Geração Z. A inclusão dos limites em cada resposta permite conferir a classificação sem confiar em um rótulo oculto. A consulta abrange a Geração Perdida, a Greatest Generation, a Geração Silenciosa, os Baby Boomers, a Geração X, os Millennials, a Geração Z, a Geração Alfa e a Geração Beta. Esses nomes são convenções demográficas amplas, e não diagnósticos pessoais. Pessoas nascidas perto de uma fronteira podem se identificar com outro nome, e pesquisadores às vezes adotam cortes um pouco diferentes. Use o resultado como regra consistente de agrupamento para análise, apresentação, encaminhamento ou ensino, e não como afirmação sobre preferências, comportamento, crenças ou identidade de uma pessoa.

Forneça um ano de nascimento válido

Envie o ano como um número inteiro no campo year. O solucionador também normaliza texto com formato de inteiro, mas clientes de API devem preferir um inteiro JSON, pois essa é a representação mais clara e corresponde ao contrato de entrada declarado. Valores decimais, booleanos, campos ausentes, palavras arbitrárias e números inseguros são rejeitados em vez de arredondados ou inferidos. São aceitos os anos de 1883 a 2039, inclusive, porque cada ano desse intervalo possui uma entrada explícita na tabela fixa de coortes. Um ano anterior a 1883 ou posterior a 2039 gera um erro de entrada inválida. Essa restrição impede que a ferramenta invente rótulos históricos ou futuros sem uma convenção suportada. Os anos de fronteira pertencem exatamente às faixas exibidas: 1964 é Baby Boomer, 1965 inicia a Geração X, 1980 permanece na Geração X e 1981 inicia a faixa Millennial. Essa comparação inclusiva torna as integrações previsíveis e oferece a planilhas, formulários e processadores em lote uma regra simples para reproduzir ao conferir resultados.

Use os rótulos com responsabilidade e consistência

Rótulos geracionais são mais úteis como categorias descritivas amplas. Eles podem ajudar a resumir a distribuição de um público, adicionar um campo legível a uma exportação de pesquisa, preparar uma aula sobre história etária ou aplicar uma convenção compartilhada entre serviços que antes usavam tabelas conflitantes. Armazene os anos inicial e final retornados junto ao rótulo quando a auditabilidade for importante; assim, a definição exata usada será preservada mesmo que outra publicação prefira limites diferentes. Não use o resultado como substituto de informações diretas sobre uma pessoa. Grupos por ano de nascimento não determinam de forma confiável habilidade técnica, hábitos de consumo, saúde, política, cultura ou preferências de comunicação e não devem orientar decisões de alto impacto sobre elegibilidade ou tratamento. O algoritmo realiza apenas validação e comparações fixas: não acessa a rede, não consulta a hora atual, não usa modelos nem infere algo a partir de nome ou localização. Por isso, os resultados não mudam entre chamadas. Pela API, cada solicitação custa US$ 0,002. Isso torna o endpoint adequado para automações repetíveis nas quais erros explícitos e classificações estáveis importam mais que interpretações especulativas.