Dias decorridos no trimestre
Em 15 de fevereiro de 2026, já se passaram 45 dias inteiros desde que o primeiro trimestre começou em 1º de janeiro. Digite uma data e veja o trimestre, o início dele e os dias decorridos, com o dia de abertura valendo zero. 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-02-15
- Ano
- 2.026
- Trimestre
- 1
- Início do trimestre
- 2026-01-01
- Dias decorridos
- 45
As contagens de dias do trimestre até a data alimentam painéis, relógios de SLA, checklists de fechamento financeiro e métricas de produto que reportam o progresso dentro do Q1 ao Q4. Esta capacidade recebe uma data ISO explícita, mapeia-a para o seu trimestre civil em UTC e retorna quantos dias inteiros se passaram desde que aquele trimestre começou — não um palpite de relógio de parede nem um “hoje” relativo. Na data de início do trimestre o resultado é zero; cada dia de calendário seguinte soma um.
O que significa dias decorridos no trimestre
Um trimestre civil é um bloco fixo de três meses no ano gregoriano: o Q1 vai de janeiro a março, o Q2 de abril a junho, o Q3 de julho a setembro e o Q4 de outubro a dezembro. O início de cada trimestre é o primeiro dia do seu primeiro mês na data de calendário em UTC, independentemente de fusos horários, calendários comerciais ou deslocamentos de ano fiscal.
Dias inteiros decorridos é a diferença inteira entre o dia do ano da sua data e o dia do ano do início do trimestre, no mesmo ano. Essa definição faz o primeiro dia do trimestre reportar zero dia decorrido, o segundo dia reportar um, e assim por diante até o último dia do trimestre. Diferentemente de “dias restantes” ou “dias úteis”, esta contagem ignora fins de semana e feriados; é uma distância puramente de calendário civil.
Os anos bissextos são tratados corretamente para fevereiro, então uma data no fim do Q1 de um ano bissexto ainda subtrai a partir de primeiro de janeiro, com o dia extra incluído quando ele cai antes da entrada.
Como enviar a data ISO corretamente
Forneça date como uma string no formato AAAA-MM-DD, ou como um datetime ISO completo cujo prefixo de calendário seja AAAA-MM-DD antes de um T ou de um espaço. Apenas a data de calendário em UTC é usada: horas, minutos, segundos e deslocamentos são ignorados, de modo que 2026-02-15T23:59:59Z e 2026-02-15 contam como o mesmo dia civil. Apelidos como iso, day, value, on e at são aceitos, para que os campos de formulário existentes se mapeiem sem renomeação.
Datas impossíveis, como 30 de fevereiro ou o mês 13, também falham. Prefira uma string ISO legível por máquina, sem unidades ou prosa, para que os parsers nunca precisem adivinhar. Quando você precisar de “dias decorridos até agora neste trimestre” em relação a uma data de relatório, passe essa data de relatório explicitamente em vez de confiar no relógio do servidor — a capacidade nunca lê Date.now().
Casos de uso
Fechamento financeiro e checklists de operações
Carimbe as tarefas com quantos dias inteiros se passaram desde o início do trimestre para um ritmo de prazos que acompanha o calendário civil, e não os dias úteis locais.
Perguntas frequentes
O primeiro dia do trimestre é zero ou um?
Zero. Dias inteiros decorridos significa a distância inteira a partir do início do trimestre; na própria data de início nenhum dia completo ainda se passou.
Ela usa meu fuso horário local ou o relógio do servidor?
Nenhum dos dois. Apenas a data de calendário que você envia é usada. Horário do dia e deslocamentos são ignorados, e o serviço nunca lê o relógio do sistema.
Quanto custa?
A ferramenta da página é grátis no seu navegador. Entradas inválidas não são cobradas.
Fins de semana e feriados ficam de fora?
Não. É uma contagem de calendário em que cada dia soma um, incluindo fins de semana e feriados. Se você só precisa de dias úteis, use uma calculadora de dias úteis.
Quais formatos de data posso digitar?
Ano, mês e dia ligados por hífens, como 2026-02-15, com um horário depois se quiser, que é ignorado. Formas regionais como 15/02/2026 e nomes de mês são recusados.
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/days-elapsed-quarter \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-02-15"}'const res = await fetch("https://api.kit.forhosting.com/date/days-elapsed-quarter", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2026-02-15"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/days-elapsed-quarter",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2026-02-15"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/days-elapsed-quarter", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2026-02-15"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2026-02-15"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/days-elapsed-quarter", 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-02-15"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.days_elapsed_quarter",
"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
A aritmética usa apenas o ano, o mês e o dia que você envia, então o mesmo payload sempre gera o mesmo quarter, quarter_start e days_elapsed em qualquer ambiente. Valores ausentes, strings fora do padrão ISO e dias de calendário impossíveis são rejeitados com invalid_input, para que as automações falhem em voz alta em vez de inventar uma linha do tempo.
O que significa dias decorridos no trimestre
Como cada campo é derivado apenas da entrada, testes de referência, scripts offline e o executor gratuito do navegador permanecem idênticos bit a bit ao caminho pago da API.
Como enviar a data ISO corretamente
Não envie strings formatadas por localidade, como 15/02/2026, nem nomes de meses; esses são rejeitados como invalid_input. Chamadas bem-sucedidas retornam a data normalizada, year, quarter (1–4), quarter_start no formato AAAA-MM-DD e days_elapsed como um inteiro não negativo. A ferramenta da página é grátis; pela API, um cálculo bem-sucedido custa US$ 0,002 por requisição, e entradas inválidas não são cobradas.
Onde as contagens por trimestre se encaixam em pipelines reais
Equipes de operações e de finanças costumam precisar de um único número que responda o quanto o trimestre atual avançou em um calendário fixo, para barras de progresso, gráficos de consumo e checklists de fechamento que abrem no dia zero do trimestre. Importadores em lote percorrem linhas de CSV com datas ISO e anexam a mesma estrutura de quatro campos em cada carga de data warehouse. Combine a saída com outras ferramentas de data se precisar de dias restantes ou filtros de dias úteis; esta capacidade permanece focada em uma única contagem determinística de dias decorridos, para que o contrato continue pequeno e estável. Trabalhos de análise de produto carimbam eventos com quarter e days_elapsed, de modo que os coortes se alinhem entre regiões sem desvio de horário local. Motores de SLA podem comparar contagens de dias contratuais com o days_elapsed a partir de um início de trimestre conhecido, sem inventar uma tabela de dias úteis quando o contrato é puramente tempo de calendário. Use o executor gratuito do navegador para uma única data, ou chame a API quando a automação precisar do mesmo resultado em forma fechada em escala.
Casos de integração
Painéis de progresso do trimestre
Converta cada data ISO de relatório em quarter e days_elapsed para que os quadros de KPI mostrem o progresso de calendário dentro do Q1–Q4 sem bibliotecas de data no cliente.
Rotulagem de eventos em lote na análise
Mapeie linhas de CSV ou de data warehouse com datas ISO para os campos year, quarter, quarter_start e days_elapsed, garantindo relatórios de coorte e SLA consistentes.
Perguntas técnicas
O que dias decorridos no trimestre retorna?
Ele retorna a data ISO normalizada, year, quarter (1–4), quarter_start (AAAA-MM-DD) e days_elapsed: os dias inteiros do primeiro dia daquele trimestre até a sua data, em UTC.
Quando o cálculo falha?
Ele falha com invalid_input quando date está ausente, não está em ISO AAAA-MM-DD (ou em um datetime ISO com esse prefixo) ou não é um dia de calendário real para aquele mês e ano.