ForHosting KIT · Datas e tempo

Número do dia ISO

Digite uma data e receba o número do dia ISO, de 1 para segunda a 7 para domingo: 25 de julho de 2026 é um sábado, então a resposta é 6. O nome do dia e os passos vêm junto. 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

Ano: 2.026
Mês: 7
Dia: 25
Dia da semana ISO: 6

Um número de dia da semana ISO responde a uma pergunta precisa que engenheiros e planejadores orientados a padrões fazem todo dia: dada uma data de calendário, qual inteiro de um a sete a ISO 8601 atribui a esse dia? Cole uma string ano-mês-dia como dois mil e vinte e seis hífen zero sete hífen vinte e cinco, e esta ferramenta devolve o número de dia ISO em que segunda-feira é um, terça é dois e domingo é sete, mais um nome curto do dia em inglês de contrato e uma lista ordenada de passos aritméticos.

O que significa a numeração ISO de dias e por que difere de sistemas com origem no domingo

A ISO 8601 define o número do dia da semana como um inteiro de um a sete com segunda-feira como primeiro dia da semana e domingo como sétimo. Essa convenção sustenta datas de semana ISO, muitos calendários empresariais europeus e inúmeras APIs que armazenam o dia da semana como código amigável à máquina em vez de um nome localizado. Não é o mesmo que JavaScript Date getDay, que devolve zero para domingo até seis para sábado, nem o mesmo que sistemas que tratam domingo como dia um.

Quando você precisa especificamente do número ISO —por exemplo para montar uma string de data de semana ISO, comparar com uma coluna de banco que guarda de um a sete, ou validar que uma série de reuniões sempre cai no dia número cinco— você quer uma calculadora que nunca confunda as duas convenções.

Esta capacidade aceita uma única data de calendário ISO escrita como quatro dígitos, hífen, dois dígitos, hífen, dois dígitos, valida que o dia existe no calendário gregoriano proléptico e mapeia a data para o número de dia ISO usando a fórmula inteira compacta de Sakamoto. Anos bissextos seguem a regra usual: divisíveis por quatro são bissextos exceto séculos não divisíveis por quatrocentos. A resposta ecoa a data canônica e o ano, mês e dia numéricos para quem chama registrar entrada e código derivado sem reanalisar.

Dicas práticas, limites, casos de borda e buscas relacionadas

Sempre envie uma data de calendário pura sem componente de hora, segundos fracionários ou Z final; timestamps estendidos são rejeitados para midnights de fuso não deslocarem o dia civil. Guarde um conjunto pequeno conhecido para testes: uma data no meio da semana, um domingo que deve devolver sete, uma segunda que deve devolver um, um dia bissexto válido como dois mil e vinte e quatro hífen zero dois hífen vinte e nove, e uma falha deliberada como dois mil e vinte e três hífen zero dois hífen vinte e nove.

Limites de ano param em nove mil novecentos e noventa e nove para strings ISO de quatro dígitos permanecerem bem definidas nesta superfície de produto. Checagens de ida e volta são diretas: recalcule o dia da semana com outra fonte gregoriana confiável e confirme que segunda mapeia para um e domingo para sete. Esta landing atende quem busca número do dia ISO, dia da semana ISO 8601 de um a sete, ou segunda igual a um domingo igual a sete a partir de uma data ISO.

Não é contador de dias úteis, não é formatador ciente de locale e não é ferramenta de idade ou intervalo.

Casos de uso

Exercícios escolares e de padrões

Alunos e instrutores confirmam o inteiro de dia ISO para datas de livro e comparam com sistemas de origem domingo que usam de zero a seis.

Perguntas frequentes

Qual formato de data eu preciso?

Uma única data de calendário ISO como YYYY-MM-DD (por exemplo 2026-07-25). Datetimes, datas ordinais e datas de semana não são aceitos.

O que acontece com uma data inválida como 2023-02-29?

Meses inválidos, dias zero e formas não YYYY-MM-DD também são rejeitados.

O domingo é 7 ou 0 na numeração ISO?

O domingo é 7. A ISO conta de segunda como 1 até domingo como 7, ao contrário de programas que numeram o domingo como 0 e o sábado como 6, ou de sistemas que começam a semana com o domingo como dia 1.

Posso colar uma data com o horário junto?

Não. Digite só a data do calendário, sem horário nem marca de fuso. Um horário poderia empurrar o dia para o outro lado da meia-noite em outro fuso, por isso é recusado para não dar o dia errado.

O resultado informa se o ano é bissexto?

Sim. Ao lado do número e do nome do dia, você vê se o ano é bissexto e uma lista curta dos passos usados, então o 29 de fevereiro de um ano bissexto é aceito e conferido como qualquer outro dia.

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/iso-weekday-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/iso-weekday-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/iso-weekday-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/iso-weekday-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/iso-weekday-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/iso-weekday-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.iso_weekday_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.

Limites

`year_min`	1
`year_max`	9999

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

Formas inválidas, meses impossíveis e um vinte e nove de fevereiro fora de ano bissexto são rejeitados com invalid_input em vez de uma resposta errada silenciosa.

Como chamar a API e o que a resposta contém

A string deve casar exatamente com YYYY-MM-DD e representar um dia real no intervalo de ano inclusivo de um a nove mil novecentos e noventa e nove. Envie um corpo JSON com um campo string obrigatório chamado date. O mesmo valor pode chegar sob os alias iso_date, value ou day por compatibilidade de formulário. Em sucesso o payload inclui date como string canônica, year, month e day como inteiros, iso_weekday e weekday_number iguais ao mesmo inteiro de um a sete, weekday_name como rótulo longo em inglês alinhado a esse número, leap_year como booleano, uma mensagem legível e um array steps que reafirma o parse e a classificação. Validação falha —campo ausente, tipo errado, forma ruim, ano fora do intervalo, mês ou dia impossíveis, ou vinte e nove de fevereiro não bissexto— devolve invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por requisição bem-sucedida com unidade item e preço marginal zero. Prefira este endpoint quando o produto principal da chamada é o próprio número ISO; se você precisa sobretudo de um nome longo do dia para prosa, uma calculadora de dia da semana mais ampla pode servir melhor, mas ambas permanecem consistentes na numeração de segunda a domingo.

Dicas práticas, limites, casos de borda e buscas relacionadas

Tarefas falhas que devolvem invalid_input não consomem saldo pré-pago. Ao integrar, armazene iso_weekday como coluna inteira e trate weekday_name como texto de conveniência em inglês só para exibição.

Casos de integração

Fixtures de semana ISO e agendadores

Equipes de backend geram fixtures conhecidas de segunda=1…domingo=7 para pipelines de semana ISO e UIs de calendário sem depender do relógio do host ou do fuso.

Checagens de contrato em banco e API

Engenheiros verificam que códigos de dia armazenados batem com a numeração ISO 8601 quando só há um carimbo de data ISO de um formulário ou arquivo de importação.

Perguntas técnicas

Como o número do dia da semana ISO é definido?

Segunda = 1, terça = 2, quarta = 3, quinta = 4, sexta = 5, sábado = 6, domingo = 7, conforme ISO 8601.

O resultado depende do meu fuso horário?

Não. O solver usa aritmética gregoriana pura e nunca lê o relógio do host nem o fuso de Date, então navegador e API concordam.

Quanto custa a API de número do dia ISO?

Requisições bem-sucedidas custam um US$ 0,002 fixo por item. Validação falha (invalid_input) não é cobrada. O executor no navegador é gratuito.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que significa a numeração ISO de dias e por que difere de sistemas com origem no domingo

Dicas práticas, limites, casos de borda e buscas relacionadas

Casos de uso

Exercícios escolares e de padrões

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Limites

Erros

Notas técnicas

Como chamar a API e o que a resposta contém

Dicas práticas, limites, casos de borda e buscas relacionadas

Casos de integração

Fixtures de semana ISO e agendadores

Checagens de contrato em banco e API

Perguntas técnicas

obrigado