Calculadora de semana EUA
Calcule o número da semana nos Estados Unidos de qualquer data, com semanas de domingo a sábado e a semana 1 sendo a que contém 1º de janeiro: 15 de março de 2024 cai na semana 11. Você também vê quantas semanas o ano tem. 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
- 2024-03-15
- Ano
- 2.024
- Mês
- 3
- Dia
- 15
- Dia do ano
- 75
Nos Estados Unidos muitos calendários, sistemas de folha de pagamento, planejadores escolares e modelos de planilha numeram as semanas de modo que cada uma comece no domingo e a semana um seja simplesmente a que contém o primeiro de janeiro. Essa regra difere do sistema de data de semana ISO 8601, que inicia as semanas na segunda-feira e define a semana um como a que inclui a primeira quinta-feira do ano. Quando um cronograma, relatório ou trilha de auditoria deve coincidir com números de semana dos EUA e não com os ISO, um conversor determinístico pequeno evita peculiaridades do Date do host e a deriva de localidade.
Regras de semana EUA versus semanas ISO, e como enviar uma data
Pela convenção dos EUA usada aqui, uma semana sempre começa no domingo e termina no sábado. A semana um de um ano é a que inclui o primeiro de janeiro, mesmo quando essa semana começou em dezembro do ano anterior no calendário de parede. As semanas seguintes contam-se como blocos completos de domingo a sábado até trinta e um de dezembro, que pode cair na semana cinquenta e dois ou cinquenta e três conforme onde caiu o primeiro de janeiro e se o ano é bissexto.
As semanas ISO 8601 são diferentes: começam na segunda-feira, e a semana um é a da primeira quinta-feira do ano, de modo que o mesmo dia civil pode mapear para um índice de semana distinto.
Como o número é calculado e como são datas inválidas
O motor primeiro valida o dia do calendário gregoriano, aplicando regras de ano bissexto de modo que fevereiro tenha vinte e nove dias só quando o ano é divisível por quatro, exceto que anos de século também devem ser divisíveis por quatrocentos. O número de semana EUA é o piso de dia-do-ano menos um mais o dia da semana do primeiro de janeiro, tudo dividido por sete, mais um, onde domingo é o dia da semana zero.
Essa fórmula coloca o primeiro de janeiro na semana um e avança de um em um a cada domingo seguinte. Strings malformadas que não sejam ano de quatro dígitos, mês de dois dígitos e dia de dois dígitos separados por hífens são igualmente rejeitadas.
Casos de uso
Folha de pagamento e relatórios de semana de trabalho EUA
Pipelines de RH e folha que agrupam horas por semanas que começam no domingo rotulam cada período de pagamento com o número de semana EUA que contém a data de trabalho, alinhado às expectativas comuns de WEEKNUM em planilhas.
Calendários escolares e de planejamento varejista
Calendários de distritos e planos de merchandising costumam numerar semanas com 1º de janeiro na semana 1; converta datas ISO para esse índice em slides, resumos por e-mail e janelas de estoque.
Perguntas frequentes
É o mesmo que o número de semana ISO?
Não. Semanas ISO começam na segunda-feira e definem a semana 1 pela regra da primeira quinta-feira. A mesma data civil pode gerar um índice diferente sob regras ISO.
O que acontece se a data for inválida?
Exemplos: formato YYYY-MM-DD incorreto, 30 de fevereiro ou 29 de fevereiro em ano não bissexto. Validação falha não é cobrada.
A calculadora de número de semana EUA é gratuita?
A ferramenta do navegador roda grátis no seu dispositivo.
Um ano pode ter 53 semanas?
Pode. O dia 31 de dezembro cai na semana cinquenta e dois ou na 53, conforme o dia da semana de 1º de janeiro e se o ano é bissexto. Em 2024, por exemplo, a última semana é a 53.
A semana 1 pode começar em dezembro?
Pode. A semana 1 é a de domingo a sábado que contém 1º de janeiro, então, quando esse dia cai no meio da semana, ela começou nos últimos dias de dezembro do ano anterior.
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/us-week-number \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-15","calendar":"valor-ejemplo"}'const res = await fetch("https://api.kit.forhosting.com/date/us-week-number", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-15",
"calendar": "valor-ejemplo"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/us-week-number",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-15",
"calendar": "valor-ejemplo"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/us-week-number", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-15","calendar":"valor-ejemplo"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-15","calendar":"valor-ejemplo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/us-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": "2024-03-15",
"calendar": "valor-ejemplo"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.us_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
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
Esta calculadora de número de semana EUA aceita uma data de calendário ISO, aplica aritmética bissexta gregoriana e uma fórmula pura de dia da semana, e devolve o índice da semana junto com fatos de dia da semana e do ano em JSON estável.
Regras de semana EUA versus semanas ISO, e como enviar uma data
Envie uma string de data no formato YYYY-MM-DD, ou os campos estruturados year, month e day juntos. Aliases como calendar, calendar_date e iso_date são aceitos para o caminho de string. Entrada estruturada parcial sem as três partes é rejeitada com invalid_input para que quem chama corrija o corpo em vez de adivinhar valores ausentes. Entradas idênticas sempre produzem JSON idêntico porque o caminho nunca lê o relógio de parede, a localidade ou a rede.
Como o número é calculado e como são datas inválidas
Datas impossíveis como trinta e um de abril, trinta de fevereiro ou vinte e nove de fevereiro em ano não bissexto falham com invalid_input e uma mensagem que indica o comprimento real do mês. A resposta ecoa week_starts igual a Sunday, week_1_rule igual a contains_january_1, e weeks_in_year igual à semana EUA de trinta e um de dezembro para que painéis mostrem o intervalo do ano sem uma segunda chamada.
Uso da API, preços, fluxos de trabalho e limites práticos
Use a calculadora gratuita de número de semana EUA no navegador para checagens de dever de casa, demos de planejamento e verificação rápida sem instalar bibliotecas de calendário. Os limites de ano seguem o intervalo de parâmetros publicado para segurança de isolamento. Envie um corpo JSON com date como YYYY-MM-DD, ou com year, month e day como inteiros nos intervalos publicados. Em sucesso o payload inclui a data normalizada, componentes estruturados, day_of_year, day_of_week de zero para domingo a seis para sábado com um nome em inglês, week_number, weeks_in_year, is_leap_year, calendar igual a gregorian, e method igual a us_week_number para roteadores e testes que ramificam por rótulos. Use a API pré-paga quando uma exportação de folha, calendário escolar, ferramenta de planejamento varejista ou SDK precisar de um 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 ordinal ISO ou dias no mês quando precisar de índices de dia ou do comprimento de fevereiro, mas não espere que o índice de semana coincida com rótulos de semana-data ISO.
Casos de integração
Paridade de planilhas em APIs
Serviços que devem coincidir com números de semana baseados em domingo do Excel ou Google Sheets expõem um campo JSON estável em vez de reimplementar a matemática do dia da semana em cada linguagem cliente.
Perguntas técnicas
Como obtenho o número de semana EUA de uma data?
Envie JSON com date igual a uma string ISO como 2024-03-15, ou envie year, month e day. A resposta inclui week_number e day_of_week_name.
As semanas começam no domingo ou na segunda-feira?
No domingo. Esta calculadora usa a convenção dos EUA: week_starts é sempre Sunday, e a semana 1 é a que contém 1º de janeiro.