ForHosting KIT · Datas e tempo

Contagem de dias da semana no ano

Escolha um dia da semana e um ano e veja quantas vezes ele aparece: 2024 tem 53 segundas-feiras, porque é bissexto e começou numa segunda. A maioria dos dias aparece 52 vezes, e só um ou dois chegam a 53. 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

Ano: 2.024
Dia da semana: Monday

Você obtém

Índice do dia: 1
Quantidade: 53
Dias no ano: 366
Dia de 1º de janeiro: 1

Planejar reuniões, ciclos de folha, calendários de conteúdo e exercícios de datas em sala convergem na mesma pergunta: quantas vezes um dia da semana dado cai dentro de um ano particular? Um ano comum tem trezentos e sessenta e cinco dias, ou seja cinquenta e duas semanas completas mais um dia sobrando; um ano bissexto tem trezentos e sessenta e seis, ou seja dois dias sobrando. Esses sobras fazem a maioria dos dias da semana aparecerem cinquenta e duas vezes enquanto um ou dois aparecem cinquenta e três, dependendo de em que dia da semana cai o primeiro de janeiro e se existe o vinte e nove de fevereiro. Strings de dia não reconhecidas falham com um erro claro de entrada inválida e não são cobradas.

Como a frequência de dias funciona em anos comuns e bissextos

Todo ano gregoriano contém trezentos e sessenta e cinco ou trezentos e sessenta e seis dias. Trezentos e sessenta e cinco equivalem a cinquenta e duas semanas mais um dia, então exatamente um dia da semana aparece cinquenta e três vezes e os outros seis aparecem cinquenta e duas. Trezentos e sessenta e seis equivalem a cinquenta e duas semanas mais dois dias, então dois dias consecutivos aparecem cinquenta e três vezes — o dia do primeiro de janeiro e o próximo na semana.

Anos bissextos seguem a regra padrão: divisíveis por quatro, exceto anos seculares salvo se divisíveis por quatrocentos. Envie weekday como nome inglês completo como Monday, abreviação de três letras como Mon, ou um inteiro de zero a seis onde zero é domingo. Maiúsculas são ignoradas nos nomes.

Casos de uso

Calendários de reuniões e campanhas

Equipes de produto e marketing verificam quantas segundas ou sextas caem em um ano de lançamento antes de reservar slots recorrentes ou publicações semanais de conteúdo.

Estimadores de folha e turnos

Ferramentas de RH e operações estimam ciclos de pagamento semanais ou modelos de turno a partir da frequência real de dias em um ano comum ou bissexto.

Perguntas frequentes

Como conto quantas segundas há em um ano?

O campo count é 52 ou 53 conforme esse ano gregoriano.

O que acontece se o nome do dia estiver errado?

Nomes não reconhecidos como "Funday" são rejeitados e não cobrados; use Sunday–Saturday ou abreviações comuns de três letras.

O ano bissexto muda a resposta?

Sim. Um ano bissexto tem 366 dias, então dois dias da semana aparecem 53 vezes em vez de um. O 29 de fevereiro é incluído via a regra bissexta gregoriana padrão.

A calculadora de contagem de dias é gratuita?

A ferramenta do navegador roda grátis no seu dispositivo.

Posso passar um número em vez de um nome?

Sim. Weekday pode ser um inteiro 0–6 onde 0 é domingo e 6 é sábado, alinhado a APIs de calendário comuns. A resposta ainda devolve o nome canônico em inglês.

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/weekday-frequency

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

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

import os, requests

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

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

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

{
  "year": 2024,
  "weekday": "Monday"
}

Exemplo de resposta

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

Esta capacidade responde essa pergunta de forma determinística para qualquer ano gregoriano de um a nove mil novecentos e noventa e nove: envie o ano e um nome de dia da semana, e receba uma contagem JSON estável de cinquenta e dois ou cinquenta e três mais o contexto de ano bissexto e a lista de dias que atingem cinquenta e três ocorrências.

Como a frequência de dias funciona em anos comuns e bissextos

Envie year como inteiro JSON ou string inteira (aliases y e yr). Entradas idênticas sempre produzem JSON idêntico porque o caminho é aritmética pura sem rede, sem semente aleatória e sem relógio de parede.

Leitura dos campos de resposta e tratamento de nomes de dia inválidos

O campo count é a resposta que você buscou: cinquenta e dois ou cinquenta e três. A mensagem de erro nomeia o token ruim quando possível para que formulários mostrem uma dica precisa. Prefira nomes completos em formulários voltados ao usuário; aceite abreviações e índices numéricos ao integrar calendários que já usam índices de domingo baseados em zero. Em caso de sucesso a resposta ecoa year, o nome canônico do dia (Sunday a Saturday) e weekday_index de zero para domingo a seis para sábado. Campos de apoio ajudam UIs e testes: days_in_year é trezentos e sessenta e cinco ou trezentos e sessenta e seis, is_leap_year é um booleano, jan1_weekday e jan1_weekday_name descrevem o primeiro dia do ano, e weekdays_with_53 lista todo nome de dia que aparece cinquenta e três vezes naquele ano para destacar os dias longos sem uma segunda solicitação. O rótulo method é sempre weekday_frequency e calendar é sempre gregorian para que o código a jusante possa ramificar sem cheirar formas. Ano ausente, dia ausente, ano fora de um a nove mil novecentos e noventa e nove, ano não inteiro e qualquer string de dia não reconhecida falham com invalid_input e não são cobrados.

Uso da API, preços, fluxos de agendamento e limites práticos

Chame a calculadora gratuita de contagem de dias no navegador para planejadores de reuniões, calendários editoriais, horários escolares e checagens rápidas de quantas sextas ou segundas um ano de campanha contém. Os anos são limitados de um a nove mil novecentos e noventa e nove para alinhar com outras ferramentas de data do catálogo e manter a exibição segura. Envie um corpo JSON com o ano inteiro obrigatório e o dia da semana obrigatório como string ou inteiro. Use a API pré-paga quando um serviço de agendamento, estimador de folha, CMS de conteúdo ou pipeline de analytics de calendário 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 o motor rejeitar a solicitação. Combine este endpoint com um gerador de calendário mensal quando precisar de uma grade imprimível, ou com contadores de dias úteis quando feriados importem mais do que a frequência bruta de dias. Autores que publicam SDKs podem mapear count e weekdays_with_53 diretamente em painéis que respondem quantas segundas há em um ano sem reimplementar regras bissextas em cada linguagem.

Casos de integração

Geradores de sala de aula e quizzes

Professores e apps de tutoria perguntam quantas terças há em um ano e verificam as respostas dos alunos com JSON determinístico.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Como a frequência de dias funciona em anos comuns e bissextos

Casos de uso

Calendários de reuniões e campanhas

Estimadores de folha e turnos

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

Como a frequência de dias funciona em anos comuns e bissextos

Leitura dos campos de resposta e tratamento de nomes de dia inválidos

Uso da API, preços, fluxos de agendamento e limites práticos

Casos de integração

Geradores de sala de aula e quizzes

obrigado