Trimestres decorridos e restantes no ano fiscal
Em 12 de agosto de 2026, com um ano fiscal que começa em abril, você está no segundo trimestre fiscal: um já terminou e faltam três, contando o atual. Digite uma data e o mês de início para ver a posição no ano fiscal. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Data
- 2026-08-12
- Mês de início do ano fiscal
- 4
- Início do ano fiscal
- 2026-04-01
- Fim do ano fiscal
- 2027-03-31
- Trimestre atual
- 2
- Trimestres decorridos
- 1
Esta calculadora transforma uma data do calendário em uma posição clara no ano fiscal. Informe uma data estrita YYYY-MM-DD e, opcionalmente, o mês em que o exercício começa. O resultado mostra os limites do ano fiscal, o trimestre atual, quantos trimestres foram totalmente concluídos e quantos restam. O trimestre atual permanece no total restante até terminar, portanto os dois valores sempre somam quatro. O cálculo usa aritmética gregoriana determinística, sem relógio do sistema, fuso horário, rede, aleatoriedade ou dependência do Date do JavaScript.
Entenda exatamente o que significa decorrido e restante
A contagem pode ficar ambígua quando alguém diz que dois trimestres decorreram durante o segundo trimestre. Esta calculadora adota uma convenção precisa de períodos concluídos: somente os trimestres fiscais encerrados antes daquele que contém a data informada são considerados decorridos. O trimestre da data é o atual e continua incompleto, mesmo quando a data corresponde ao último dia civil dele.
Assim, uma data no Q1 retorna zero decorridos e quatro restantes; no Q2, um e três; no Q3, dois e dois; e no Q4, três e um. Essa regra atende bem a marcos de relatórios, prazos e trabalho ainda aberto, pois nunca trata um período em andamento como concluído. Se a sua organização mede o progresso pelo fechamento contábil formal, e não pelas fronteiras do calendário, use esta saída como referência temporal e aplique separadamente a política de fechamento.
A calculadora não presume que a contabilidade já encerrou o período.
Configure um ano fiscal iniciado em qualquer mês
O campo obrigatório date segue o formato internacional estrito YYYY-MM-DD e precisa representar um dia gregoriano real. Se for omitido, janeiro será usado, gerando os trimestres civis comuns: janeiro a março, abril a junho, julho a setembro e outubro a dezembro. Em um exercício iniciado em abril, as posições passam a abril-junho, julho-setembro, outubro-dezembro e janeiro-março.
O algoritmo compara o mês da data com o início escolhido, encontra o ano correto de abertura, calcula o deslocamento mensal e o divide em quatro grupos fixos de três meses. Como a implementação usa inteiros limitados e validação explícita de anos bissextos, sem Date, a mesma entrada gera resultado idêntico no navegador, worker, testes ou máquina configurada em qualquer fuso horário.
Use a posição trimestral no planejamento e na automação
Equipes financeiras e operacionais podem rotular um retrato de relatório com o trimestre fiscal correspondente e descobrir quantos períodos completos estão disponíveis para comparação histórica. Um painel pode mostrar que uma data está no Q3, com dois trimestres totalmente decorridos e dois restantes, incluindo o ativo, sem incorporar uma tabela mensal específica da empresa em cada serviço.
Operações de vendas podem alinhar revisões de pipeline a exercícios iniciados em abril ou julho, enquanto administradores de subsídios e organizações sem fins lucrativos relacionam datas de programas a anos de financiamento que não começam em janeiro. Esta capacidade informa a posição trimestral, mas não calcula receita, rateia metas, conta dias úteis nem decide se um fechamento financeiro terminou. Essas tarefas exigem dados e políticas que uma data não contém.
O escopo restrito torna a saída previsível e reutilizável em planilhas, aplicativos e pipelines auditáveis.
Casos de uso
Retratos de relatórios fiscais
Marque uma data de relatório com o trimestre fiscal atual e as quantidades de períodos concluídos e ainda abertos.
Painéis de ritmo orçamentário
Mostre quantos trimestres estão disponíveis para resultados históricos e quantos restam para atividades planejadas.
Exercícios fora do ano civil
Atenda organizações cujo exercício começa em abril, julho, outubro ou outro mês sem tabelas de datas próprias.
Perguntas frequentes
Como anos bissextos e fusos horários são tratados?
As regras gregorianas validam a data e o fim fiscal.
O trimestre em andamento conta como decorrido?
Não. Só contam como decorridos os trimestres totalmente encerrados. O que contém a sua data continua entre os restantes, mesmo no último dia, então os dois números sempre somam quatro.
O meu ano fiscal pode começar em outro mês que não janeiro?
Sim. Escolha qualquer mês de 1 a 12. Começando em abril, o primeiro trimestre vai de abril a junho e o quarto de janeiro a março; sem escolha, são usados os trimestres normais do calendário.
O que uma data de cada trimestre devolve?
Uma data do primeiro trimestre fiscal dá zero decorridos e quatro restantes; do segundo, um e três; do terceiro, dois e dois; e do quarto, três decorridos e um restante.
A ferramenta diz se um período já foi fechado formalmente?
Não. Ela trabalha só com o calendário e não sabe se a sua equipe contábil fechou um período. Aplique a sua própria regra de fechamento sobre o resultado se a sua organização mede o avanço assim.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/date/quarters-elapsed \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-08-12"}'const res = await fetch("https://api.kit.forhosting.com/date/quarters-elapsed", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2026-08-12"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/quarters-elapsed",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2026-08-12"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/quarters-elapsed", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2026-08-12"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2026-08-12"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/quarters-elapsed", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"date": "2026-08-12"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.quarters_elapsed",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Use gratuitamente no navegador ou automatize o mesmo cálculo pela API por US$ 0,002 para cada item bem-sucedido.
Entenda exatamente o que significa decorrido e restante
O trimestre atual integra a contagem restante, de modo que quarters_elapsed mais quarters_remaining sempre resulta em quatro. A resposta declara a regra e também fornece current_quarter, permitindo que consumidores posteriores entendam o resultado sem procurar uma observação escondida.
Configure um ano fiscal iniciado em qualquer mês
O campo opcional fiscal_year_start_month aceita um inteiro de um a doze, em que um significa janeiro e doze significa dezembro. Ele também retorna fiscal_year_start e fiscal_year_end exatos, incluindo a duração correta de fevereiro quando um exercício não iniciado em janeiro termina nesse mês. Datas impossíveis, formatos flexíveis, meses fracionários e limites fora dos anos 0001 a 9999 falham com invalid_input, sem ajustes silenciosos.
Use a posição trimestral no planejamento e na automação
A ferramenta do navegador serve para consultas individuais; chamadas de API custam US$ 0,002 por item bem-sucedido e retornam o mesmo objeto determinístico.
Perguntas técnicas
O trimestre fiscal atual conta como decorrido?
Não. Apenas trimestres totalmente concluídos são decorridos. O atual integra quarters_remaining, inclusive no último dia civil.
Os trimestres decorridos e restantes sempre somam quatro?
Sim. Pela regra de período concluído, quarters_elapsed varia de zero a três e quarters_remaining de quatro a um.
O ano fiscal pode começar fora de janeiro?
Sim. Defina fiscal_year_start_month como um inteiro entre 1 e 12. O padrão é 1, correspondente a janeiro.
Quanto custa uma solicitação de API?
Cada item bem-sucedido pela API custa US$ 0,002. O mesmo cálculo determinístico também funciona gratuitamente no navegador.