Início e fim do século

Esta capacidade aceita uma única data de calendário ISO explícita no formato YYYY-MM-DD e devolve o século gregoriano histórico que a contém: o número e o rótulo ordinal do século, o primeiro e o último ano, e as strings inclusivas first_date e last_date. O algoritmo é aritmética inteira pura apenas a partir da sua entrada — sem chamadas de rede, sem relógio de parede e sem fuso do host — de modo que a mesma data sempre produz o mesmo JSON.

Como os séculos históricos mapeiam anos aos limites inicial e final

Dias bissextos como 29 de fevereiro de 2024 são aceitos; 29 de fevereiro em anos não bissextos e meses ou dias impossíveis geram invalid_input para que pipelines nunca inventem um século a partir de uma data quebrada. Solicitações idênticas sempre produzem o mesmo JSON porque o caminho nunca toca Date, sementes aleatórias ou serviços remotos.

Como ler first_year, last_year, first_date, last_date e rótulos de século

As datas de fronteira são deliberadas: uma entrada de 31 de dezembro de 2000 devolve o século XX que termina nesse dia, enquanto 1 de janeiro de 2001 devolve o século XXI que começa nesse dia. Em caso de sucesso, a resposta inclui a data de entrada ecoada e seus componentes year, month e day; o inteiro century; century_ordinal como 21st para o vigésimo primeiro; e century_label como 21st century para exibição. Os campos principais do produto são first_year e last_year (inteiros inclusivos) mais first_date e last_date como strings YYYY-MM-DD com zeros à esquerda: first_date é sempre o primeiro de janeiro do primeiro ano, e last_date é sempre o trinta e um de dezembro do último ano. length_years é sempre cem neste contrato. O campo calendar é sempre gregorian e method é sempre historical_century para que o código a jusante possa ramificar sem inspecionar formatos. Use first_date e last_date sozinhos para cláusulas SQL BETWEEN, filtros de partição de data warehouse e faixas de zoom de linha do tempo; use first_year e last_year ao montar agregações no nível do século ou marcas de eixo de gráfico; use century_label quando um selo de IU ou título de aula precisar de uma frase humana curta. Ano fora de 1 a 9999, datas que não são string, formato ISO incorreto e dias de mês impossíveis falham com invalid_input mencionando o campo e não são cobrados.

Uso da API, preços, fluxos e diferenças em relação a ferramentas de década

Chame a ferramenta gratuita no navegador de início e fim do século para planos de aula, etiquetas de museu, checagens em planilhas e verificação rápida de janelas de século sem instalar uma biblioteca de calendário. Este produto não converte eras a.C., ano astronômico zero, séculos fiscais nem apelidos informais de século de dois dígitos — são intenções de busca diferentes — então mantenha regras de cronologia especializadas na sua própria camada e chame esta capacidade para limites históricos de século da era comum a partir de uma data ISO. Envie um corpo JSON com o campo de string obrigatório date definido para um dia de calendário ISO explícito. Use a API pré-paga quando um pipeline de arquivo, linha do tempo de CMS, produto educacional ou cron de relatórios precisar de um contrato estável com saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após a rejeição do motor. Combine este endpoint com ferramentas de início e fim de semana, mês ou trimestre quando o próximo passo for um intervalo mais fino dentro do mesmo século, ou com rotulagem de década e século quando você só tiver um ano e precisar de tags de década em vez de limites completos de data de século. Autores que publicam SDKs podem mapear first_date e last_date para controles de intervalo de datas e century_label para títulos.