Número da semana do trimestre por data ISO
Digite uma data e veja em que semana do trimestre ela cai: 20 de maio de 2026 está na semana 8 do segundo trimestre, contada a partir de 1º de abril. A semana 1 são sempre os sete primeiros dias do trimestre. 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-05-20
- Ano
- 2.026
- Trimestre
- 2
- Início do trimestre
- 2026-04-01
- Número da semana
- 8
Transforme uma data ISO explícita em uma posição semanal clara e reproduzível dentro de Q1, Q2, Q3 ou Q4. O cálculo fixa a semana 1 no primeiro dia do trimestre civil e reúne cada período seguinte de sete dias sob o próximo número. Ele nunca consulta a hora atual, aplica um fuso local nem acessa um calendário externo. Por isso, o resultado atende painéis, fluxos de relatórios, regras de validação e testes que precisam coincidir em qualquer ambiente. Envie uma data real no formato YYYY-MM-DD e receba a data normalizada, o ano, o trimestre, o início do trimestre e o número semanal iniciado em um.
Definição da semana dentro do trimestre
Esta calculadora usa trimestres civis e blocos de sete dias contados a partir de seu início. Q1 começa em 1 de janeiro, Q2 em 1 de abril, Q3 em 1 de julho e Q4 em 1 de outubro. As sete primeiras datas pertencem à semana 1; da oitava à décima quarta, à semana 2; e o padrão continua.
O serviço conta dias completos desde o início, divide o total por sete com divisão inteira e soma um. Isso não é o número ISO da semana do ano, cujas semanas começam na segunda-feira e podem atravessar limites trimestrais. A convenção trimestral é apropriada quando um relatório, uma campanha ou uma meta reinicia exatamente no primeiro dia do trimestre.
Como a duração varia, a semana final pode ter menos de sete dias, e certos trimestres chegam à semana 14. As regras gregorianas de ano bissexto, incluindo exceções de séculos, são aplicadas em todos os anos aceitos.
Envio e validação da data
Envie o campo date como uma data civil ISO explícita no formato exato YYYY-MM-DD, por exemplo 2026-05-20. Texto adicional, ordem regional, timestamp e falta de zeros iniciais são rejeitados em vez de interpretados. A regra estrita impede que 03/04/2026 represente dias diferentes conforme o país.
O ano deve ficar entre 0001 e 9999, o mês entre 01 e 12, e o dia precisa existir naquele mês. A capacidade não usa Date do JavaScript, o fuso da máquina nem o relógio do sistema. Ela extrai os componentes numéricos, valida cada um e executa aritmética inteira limitada.
Assim, repetir uma solicitação armazenada sempre produz a mesma resposta.
Aplicação em relatórios e automações
Números semanais relativos ao trimestre são rótulos compactos para trabalhos com ritmo trimestral. Uma equipe de produto consegue comparar a adoção na semana 3 de diferentes trimestres, mesmo quando o número comum da semana anual muda. Exportações agendadas podem enriquecer cada data antes de carregar o armazém, tornando a regra explícita e reproduzível.
Esta capacidade mede blocos de dias civis, não semanas úteis. Ela não ignora fins de semana ou feriados, não começa obrigatoriamente na segunda-feira e não implementa calendário varejista 4-4-5 nem exercício fiscal personalizado. Mantenha um eventual valor ISO anual em outro campo.
Em reprocessamentos históricos, forneça a data da aplicação em vez de pedir “hoje”.
Casos de uso
Painéis de desempenho trimestral
Rotule indicadores datados com uma semana trimestral consistente para comparar trimestres civis sucessivos.
Acompanhamento de campanhas
Mapeie uma data de atividade para o bloco atual de sete dias sem depender do fuso horário.
Perguntas frequentes
A semana 1 começa na segunda-feira?
Não. Ela começa no primeiro dia civil do trimestre, e cada bloco seguinte contém sete dias civis.
É igual à semana ISO do ano?
Não. A semana ISO começa na segunda-feira e pode cruzar trimestres; este número reinicia a cada trimestre civil.
O resultado pode chegar à semana 14?
Sim. Um trimestre tem 90, 91 ou 92 dias; portanto, as últimas datas podem cair na semana trimestral 13 ou 14.
Timestamp e formatos locais são aceitos?
Não. Informe exatamente YYYY-MM-DD para evitar deslocamentos de fuso e ordens ambíguas.
Quando começa cada trimestre?
O primeiro começa em 1º de janeiro, o segundo em 1º de abril, o terceiro em 1º de julho e o quarto em 1º de outubro. Em cada um desses dias a contagem volta à semana 1.
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/week-number-in-quarter \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-05-20"}'const res = await fetch("https://api.kit.forhosting.com/date/week-number-in-quarter", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2026-05-20"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/week-number-in-quarter",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2026-05-20"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/week-number-in-quarter", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2026-05-20"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2026-05-20"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/week-number-in-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-05-20"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.week_number_in_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
Definição da semana dentro do trimestre
A resposta inclui quarter_start para que você confirme a referência usada.
Envio e validação da data
O dia 29 de fevereiro só é aceito em ano bissexto gregoriano; entradas impossíveis retornam invalid_input. Uma operação bem-sucedida pela API custa US$ 0,002 por item; o navegador executa localmente o mesmo cálculo puro. Guarde a data ISO original e quarter_start quando precisar de auditoria.
Aplicação em relatórios e automações
Um painel de receita pode agrupar observações por ano, trimestre e week_number sem deixar uma semana anterior atravessar a fronteira. O resultado também favorece testes: use datas próximas de 1 de abril, julho, outubro ou janeiro para confirmar que week_number volta a um.
Casos de integração
Enriquecimento do data warehouse
Acrescente ano, trimestre, quarter_start e week_number antes de agregar ou reprocessar registros.
Perguntas técnicas
Quanto custa o cálculo?
O cálculo no navegador é gratuito. Uma solicitação válida pela API custa US$ 0,002 por item.