ForHosting KIT · Datas e tempo

Número da semana ISO 8601

Digite uma data e receba o número da semana ISO 8601 e o ano-semana: 25 de julho de 2026 cai na semana 30, escrita 2026-W30. As semanas vão de segunda a domingo e a semana 1 contém a primeira quinta-feira do ano. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Data: 2026-07-25

Você obtém

Semana: 30
Ano da semana: 2.026
Semana ISO: 2026-W30
Dia da semana: 6

A numeração de semanas ISO 8601 é o padrão usado em relatórios europeus, calendários de folha de pagamento, planejamento industrial e muitas APIs. Diferente das semanas no estilo americano, que costumam começar no domingo e não atravessam o ano, uma semana ISO começa sempre na segunda-feira, e a semana 1 é a que contém a primeira quinta-feira do ano gregoriano. Essa regra faz com que o fim de dezembro e o início de janeiro possam pertencer a um ano-semana ISO diferente do ano civil impresso na data. Esta capacidade recebe uma string de data ISO, interpreta-a como dia civil UTC e devolve o número da semana (1–53), o ano-semana ISO, um rótulo compacto YYYY-Www e o dia da semana — de forma determinística, sem adivinhar o fuso horário.

O que um número de semana ISO realmente significa

As pessoas costumam dizer «número da semana» para três coisas diferentes: a semana ordinal do ano civil a partir de 1º de janeiro, a semana do mês (primeira a quinta dentro de um mês), ou a semana ISO 8601 definida na norma internacional. Só a última é estável nos países que seguem calendários ISO. Segundo a ISO 8601, cada semana tem sete dias de segunda a domingo.

A semana 1 do ano Y é a que inclui a primeira quinta-feira de Y — equivalente à semana que contém 4 de janeiro. Assim, um ano pode ter 52 ou 53 semanas ISO. Quando há 53, 29, 30 ou 31 de dezembro ainda podem estar na semana 53 daquele ano ISO, e 1–3 de janeiro do ano civil seguinte podem ainda pertencer à semana 52 ou 53 do ano-semana ISO anterior.

Confundir o ano civil com o ano-semana é o erro mais comum em helpers de data caseiros, painéis e relatórios SQL.

Contrato de entrada e avaliação apenas em UTC

Envie um campo obrigatório, date, como string ISO-8601. A forma preferida é YYYY-MM-DD (por exemplo 2026-07-25). Um datetime completo com hora e sufixo de fuso opcional é aceito, mas só o dia de calendário é usado após o parse da string; o cálculo sempre roda sobre esse dia civil à meia-noite UTC.

Valores ausentes ou que não sejam string também falham na validação e não são cobrados.

Onde pipelines usam o número da semana e como chamar

KPIs semanais, quadros de sprint, relatórios fiscais que seguem semanas ISO, slots logísticos rotulados por semana e jobs de enriquecimento CSV precisam de um índice de semana confiável. Só esses três pegam bugs de um a mais/menos em segunda/domingo, erros de ano-semana no limite do ano e formatação com zero à esquerda em semanas de um dígito. Mantenha o contrato UTC: se precisar de meias-noites locais em outro fuso, converta primeiro para a data civil local e passe esse YYYY-MM-DD aqui para o cálculo da semana permanecer puro e reproduzível.

Casos de uso

Analítica semanal e agregações de KPI

Agrupe eventos por semana ISO e ano-semana para que o tráfego de dezembro e janeiro caia na semana de relatório correta, e não no ano civil errado.

Calendários de folha e manufatura

Rotule folhas de ponto, turnos e lotes de produção com números de semana ISO alinhados a sistemas europeus e de planejamento ISO.

Perguntas frequentes

O que é o número da semana ISO 8601?

É o índice de semana de 1 a 53 definido pela ISO 8601: as semanas começam na segunda-feira e a semana 1 é a que contém a primeira quinta-feira do ano (ou, de forma equivalente, 4 de janeiro).

O cálculo é em hora local ou em UTC?

Somente UTC. A data é tratada como dia civil UTC (YYYY-MM-DD). Sufixos de hora opcionais são ignorados na aritmética da semana para o resultado permanecer determinístico entre fusos.

Por que os primeiros dias de janeiro podem ser da semana do ano anterior?

Porque a semana ISO pertence a um ano-semana que pode não coincidir com o ano do calendário. De 1 a 3 de janeiro os dias ainda podem cair na semana 52 ou 53 do ano ISO anterior.

Quantas semanas ISO um ano tem?

Tem 52 ou 53. A semana 1 é a que contém 4 de janeiro, então nos anos de 53 semanas os dias 29, 30 ou 31 de dezembro ainda podem ficar na semana 53.

Posso informar uma data com hora?

Pode. Uma data com hora, até com fuso horário, é aceita, mas só o dia do calendário é usado. A semana é sempre calculada sobre esse dia à meia-noite UTC.

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

POSThttps://api.kit.forhosting.com/date/week-number

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 \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-07-25"}'

const res = await fetch("https://api.kit.forhosting.com/date/week-number", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2026-07-25"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/week-number",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2026-07-25"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/week-number", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2026-07-25"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2026-07-25"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/week-number", 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-07-25"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.week_number",
  "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

por chamadaUS$ 0,002

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

O que um número de semana ISO realmente significa

Este endpoint isola essa regra para que quem chama obtenha uma única resposta auditada em vez de resultados divergentes de bibliotecas dependentes de localidade.

Contrato de entrada e avaliação apenas em UTC

Datas impossíveis como 2026-02-30 são rejeitadas com invalid_input em vez de avançar pela implementação host de Date. A resposta inclui a data normalizada, week (1–53), week_year (o ano-semana ISO, que pode diferir do ano gregoriano perto dos limites), iso_week na forma compacta 2026-W30, além de weekday (segunda=1 … domingo=7) e weekday_name para legibilidade.

Onde pipelines usam o número da semana e como chamar

Use a ferramenta gratuita do navegador para checagens pontuais, ou a API pré-paga ao normalizar milhares de linhas: cada item bem-sucedido é cobrado na base publicada de US$ 0,002, e entrada inválida é grátis. Combine esta capacidade com normalização de datas quando os dados de origem estiverem bagunçados; depois mapeie cada dia ISO limpo para week e week_year antes de agrupar.

Casos de integração

Enriquecimento de CSV e data warehouse

Adicione colunas week e iso_week às exportações para que ferramentas de BI agrupem linhas sem reimplementar as regras ISO em dialetos SQL.

Perguntas técnicas

Por que week_year pode diferir do ano civil?

Perto do Ano Novo, dias no fim de dezembro ou início de janeiro podem pertencer ao ano-semana ISO anterior ou seguinte. A quinta-feira daquela semana decide o ano-semana, não o ano gregoriano do próprio dia.

Quais formatos de data são aceitos?

YYYY-MM-DD é o preferido. Datetimes ISO completos são aceitos se começarem com uma data de calendário válida; datas impossíveis e valores ausentes retornam invalid_input.

Quanto custa a API de número da semana ISO?

A ferramenta do navegador é gratuita. Chamadas de API bem-sucedidas usam saldo pré-pago no preço base publicado de US$ 0,002 por item; entrada inválida não é cobrada.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que um número de semana ISO realmente significa

Contrato de entrada e avaliação apenas em UTC

Onde pipelines usam o número da semana e como chamar

Casos de uso

Analítica semanal e agregações de KPI

Calendários de folha e manufatura

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Erros

Notas técnicas

O que um número de semana ISO realmente significa

Contrato de entrada e avaliação apenas em UTC

Onde pipelines usam o número da semana e como chamar

Casos de integração

Enriquecimento de CSV e data warehouse

Perguntas técnicas

obrigado