ForHosting KIT · Ferramentas para dev

Dia da semana do Ano-Novo

Esta calculadora do dia da semana do Ano-Novo recebe uma data ISO explícita, usa o ano com quatro dígitos e informa em que dia cai 1º de janeiro daquele ano.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

O resultado deriva somente da data fornecida e das regras do calendário gregoriano, sem depender da data atual, do relógio do servidor, do fuso horário do navegador ou de um serviço externo. A resposta inclui o nome do dia, seu número ISO e a data exata de 1º de janeiro usada no cálculo.

Use qualquer data para identificar o ano desejado

Informe uma data completa no formato ISO YYYY-MM-DD. A calculadora valida toda a data, incluindo a quantidade de dias do mês e a regra especial de fevereiro nos anos bissextos, e então usa o ano no cálculo. Por exemplo, uma entrada de agosto de 2026 não pede o dia da semana daquela data de agosto: o resultado corresponde especificamente a 1º de janeiro de 2026. Isso facilita o trabalho quando um registro, prazo, boleto ou evento já contém uma data e você precisa saber como começou o mesmo ano. Exigir uma data completa e válida também evita entradas ambíguas como 03/04/26, nas quais a ordem do mês e do dia depende da convenção regional. São aceitos anos de 0001 a 9999, sempre pelo calendário gregoriano proléptico. A saída repete a entrada aceita, identifica o ano extraído e mostra a data normalizada do Ano-Novo, deixando clara a base da resposta.

Entenda o cálculo determinístico do dia da semana

O cálculo soma os dias de todos os anos completos anteriores ao ano informado. Anos comuns contribuem com 365 dias, enquanto anos bissextos acrescentam um dia conforme a regra gregoriana: um ano divisível por quatro é bissexto, exceto quando é divisível por cem, mas anos divisíveis por quatrocentos continuam bissextos. O total é reduzido módulo sete, considerando segunda-feira como dia ISO 1 e domingo como dia ISO 7. Essa aritmética identifica diretamente o dia em que começa 1º de janeiro. O resultado não usa relógio do sistema, configuração regional, banco de fusos horários, valor aleatório, chamada de rede nem o objeto Date do JavaScript. Assim, a mesma entrada válida gera a mesma resposta JSON em uma API, em um navegador de outro país ou em um teste configurado com outro fuso. A resposta traz o nome legível do dia e o número ISO, atendendo tanto à exibição quanto à ordenação, às decisões condicionais e à integração com outros sistemas.

Aplique o resultado ao planejamento e à automação

Saber o dia da semana de 1º de janeiro ajuda a entender como o ano se alinha a rotinas semanais. O resultado pode orientar a criação de agendas anuais, a configuração de períodos de relatório, a conferência de arquivos, modelos de escala e consultas de calendário. Em um fluxo automatizado, envie a data já associada ao registro e use o número ISO retornado para escolher um layout ou um caminho do processo. O resultado 6 ou 7 indica que o Ano-Novo cai no fim de semana segundo a rotina comum de segunda a sexta; valores de 1 a 5 o colocam em um dia útil convencional. A capacidade informa fatos do calendário, sem presumir quais dias sua organização considera úteis ou feriados. Para anos históricos, as regras gregorianas são aplicadas retroativamente para manter a consistência. A execução no navegador é gratuita, e cada solicitação via API custa US$ 0,002. Como a resposta depende apenas da entrada, ela também serve para builds reproduzíveis, relatórios em cache, testes de regressão e transformações auditáveis.

Casos de uso

Montar uma agenda anual

Escolha a coluna correta de 1º de janeiro antes de gerar as semanas restantes de um calendário anual.

Classificar o início do ano

Use o número ISO do dia para verificar se o Ano-Novo começa em um dia útil convencional ou no fim de semana.

Conferir calendários arquivados

Compare o dia calculado para 1º de janeiro com um relatório histórico ou calendário importado sob regras gregorianas consistentes.

Perguntas frequentes

Qual formato de data você deve enviar?

Envie uma data ISO completa no formato YYYY-MM-DD, como 2026-08-07.

O mês ou o dia altera a resposta?

Eles devem formar uma data válida, mas o cálculo usa o ano da data para avaliar o 1º de janeiro correspondente.

O fuso horário afeta o resultado?

Não. O cálculo usa aritmética inteira do calendário gregoriano e nunca converte a entrada em um horário local.

Como os anos bissextos são tratados?

Anos divisíveis por quatro são bissextos, anos de século não são, exceto quando também são divisíveis por quatrocentos.

Quanto custa?

A execução no navegador é gratuita. Cada solicitação via API custa US$ 0,002.

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

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

import os, requests

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

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

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

Exemplo de resposta

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