ForHosting KIT · Ferramentas para dev

Conte um dia da semana no ano de uma data ISO

Conte com precisão quantas segundas-feiras, sextas-feiras, domingos ou qualquer outro dia da semana existem no ano civil indicado por uma data ISO explícita.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

A calculadora valida a data completa, extrai o ano e aplica as regras do calendário gregoriano com aritmética inteira determinística. Ela não depende do relógio da máquina, das configurações regionais, do horário de verão nem do interpretador de datas do ambiente. O resultado informa o dia normalizado, a quantidade, se o ano é bissexto, o total de dias e o dia da semana de 1º de janeiro.

Informe uma data explícita e um dia da semana

Envie uma data escrita exatamente como YYYY-MM-DD e um nome de dia, como Monday, Tuesday ou Friday. A data explícita determina qual ano civil será analisado; o mês e o dia não limitam o intervalo da contagem. Por exemplo, 2024-01-01 e 2024-11-30 selecionam o ano inteiro de 2024. Mesmo assim, a data completa precisa representar um dia gregoriano real. Assim, valores impossíveis como 2023-02-29 ou um décimo terceiro mês são rejeitados, e não ajustados silenciosamente. Os nomes dos dias não diferenciam maiúsculas de minúsculas, e abreviações inglesas comuns de três letras, como Mon, Wed e Sat, também são aceitas. A resposta repete a data original, identifica o ano escolhido, normaliza o dia para o nome completo em inglês e fornece um índice iniciado no domingo. Ao exigir essas duas entradas claras, o cálculo não depende da data atual e uma solicitação armazenada continua reproduzível muito tempo depois. O formato também atende formulários, tarefas agendadas, planilhas e registros de auditoria.

Entenda como a contagem determinística é feita

Todo ano gregoriano comum tem 365 dias, isto é, 52 semanas completas e mais um dia. Um ano bissexto tem 366 dias, ou 52 semanas completas e mais dois dias. Portanto, cada dia da semana ocorre pelo menos 52 vezes. Em um ano comum, o dia da semana de 1º de janeiro ocorre pela quinquagésima terceira vez. Em um ano bissexto, os dias correspondentes a 1º e 2 de janeiro ocorrem 53 vezes. Primeiro, a calculadora aplica a regra gregoriana: anos divisíveis por quatro são bissextos, exceto anos de século que não sejam também divisíveis por 400. Em seguida, calcula o dia de 1º de janeiro com aritmética inteira limitada e verifica se o dia escolhido está entre os um ou dois dias excedentes. Nenhum objeto JavaScript Date é criado. Isso evita interpretação dependente do ambiente, fusos do sistema, mudanças de horário de verão e diferenças regionais. O total do ano, o indicador de bissexto e o dia de 1º de janeiro deixam explícito por que a resposta é 52 ou 53.

Use o resultado em planejamento e validação

A contagem ajuda quando uma estimativa anual depende de um evento semanal recorrente. Equipes de folha de pagamento podem descobrir quantas sextas-feiras regulares existirão antes de descontar feriados. Operações pode estimar segundas-feiras de funcionamento, escolas podem medir possíveis dias de aula e analistas podem validar dimensões de calendário criadas por outro sistema. Considere o resultado uma contagem pura de calendário, não um total de dias úteis. Feriados, fechamentos da organização, licenças, datas regionais e horários excepcionais ficam deliberadamente fora do cálculo, pois exigem uma jurisdição e uma política ausentes nas entradas. Se essas exclusões forem importantes, use esta quantidade como base transparente e subtraia as datas conforme seu próprio calendário. A data ISO explícita também favorece fluxos que já transportam uma data de relatório: você não precisa separar nem validar o ano antes. O navegador e a API executam o mesmo solucionador puro, e chamadas automatizadas custam US$ 0,002.

Casos de uso

Estimar dias recorrentes de trabalho

Conte todas as ocorrências de um dia programado no ano do relatório antes de descontar feriados ou fechamentos.

Conferir calendários de pagamento

Confirme se um dia semanal de pagamento aparece 52 ou 53 vezes no ano associado à data da folha.

Validar bases de calendário

Compare os totais por dia da semana de um calendário anual gerado com uma referência gregoriana determinística.

Perguntas frequentes

Quanto custa uma chamada de API?

Cada chamada de API custa US$ 0,002.

Por que devo informar uma data completa, e não apenas o ano?

A data ISO explícita e validada fornece o ano e se adapta a fluxos que já usam datas de relatório ou referência.

Um dia da semana pode ocorrer mais de 53 vezes no mesmo ano?

Não. Um ano gregoriano possui 52 semanas completas e somente um ou dois dias adicionais.

Os feriados são excluídos?

Não. O resultado conta apenas dias do calendário e não aplica regras de feriados regionais ou organizacionais.

O fuso horário altera a resposta?

Não. O cálculo usa somente a data ISO escrita e aritmética gregoriana inteira, sem relógio local nem interpretação com Date.

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/count-weekday-in-year

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/count-weekday-in-year \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-06-15","weekday":"Monday"}'

const res = await fetch("https://api.kit.forhosting.com/date/count-weekday-in-year", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "date": "2024-06-15",
    "weekday": "Monday"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/count-weekday-in-year",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "date": "2024-06-15",
    "weekday": "Monday"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/count-weekday-in-year", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"date":"2024-06-15","weekday":"Monday"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"date":"2024-06-15","weekday":"Monday"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/count-weekday-in-year", 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-06-15",
  "weekday": "Monday"
}

Exemplo de resposta

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

Ver a documentação completa do KIT →