Início e fim de trimestre

O algoritmo é uma consulta pura a uma tabela com validação de inteiros —sem chamadas de rede, sem relógio de parede e sem fuso do host—, de modo que a mesma entrada sempre gera o mesmo JSON.

O que é um trimestre de calendário e como enviar ano e trimestre

Envie o campo obrigatório year como inteiro JSON ou string inteira entre um e nove mil novecentos e noventa e nove; os alias y e yr são aceitos. Envie o campo obrigatório quarter como inteiro de um a quatro; os alias q e qtr são aceitos. Campos ausentes, não inteiros e valores fora da faixa geram invalid_input para que pipelines falhem rápido sem adivinhar.

Como ler start_date, end_date e os campos estruturados do trimestre

Anos bissextos não alteram as datas de início ou fim de trimestre neste contrato, porque nenhum limite de trimestre cai no vinte e nove de fevereiro; trinta e um de março, trinta de junho, trinta de setembro e trinta e um de dezembro são fixos. Ano fora do mínimo e máximo publicados falha do mesmo jeito para que um overflow silencioso nunca invente uma data. Em sucesso a resposta inclui year, quarter, quarter_label como Q2, uma string legível de meses como abril–junho, e as duas strings principais start_date e end_date na forma YYYY-MM-DD com mês e dia preenchidos com zeros. Essas strings são inclusivas: todo dia do início ao fim pertence ao trimestre. Os mesmos limites também voltam como inteiros start_month, start_day, end_month e end_day para fórmulas de planilha e seletores de data da interface se vincularem sem reanalisar strings ISO. O campo calendar é sempre gregorian e method é sempre calendar_quarter para o código a jusante ramificar sem inspecionar formas. Use start_date e end_date sozinhos para cláusulas SQL BETWEEN e filtros de data de API; use os campos numéricos de mês e dia ao montar relatórios de várias colunas; use quarter_label quando a legenda de um gráfico precisar de um selo curto. Trimestre fora de um a quatro falha com invalid_input mencionando a faixa e não é cobrado.

Uso da API, preços, fluxos de relatório e limites práticos

Chame a ferramenta gratuita no navegador de início e fim de trimestre para checagens em planilhas, apresentações e verificação rápida de janelas de relatório sem instalar biblioteca de calendário. Este produto não converte deslocamentos de ano fiscal, trimestres baseados em semana ISO nem semestres —essas são intenções de busca distintas—, então mantenha a lógica fiscal customizada na sua própria camada e chame esta capacidade só para Q1 a Q4 de calendário padrão. Envie um corpo JSON com o inteiro obrigatório year e o inteiro obrigatório quarter de um a quatro. Use a API pré-paga quando um pipeline de faturamento, extração de BI, job cron ou dashboard SaaS precisar de contrato estável sob 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 dias no mês ou meses entre datas quando o próximo passo for contar dias dentro do trimestre ou atravessar vários trimestres. Autores que publicam SDKs podem mapear start_date e end_date diretamente para controles de intervalo de datas, e quarter_label para títulos como Q3 2026.