ForHosting KIT · Ferramentas para dev

Duração do mês Hijri

Esta calculadora de duração do mês Hijri retorna o número de dias de determinado ano e mês do calendário islâmico tabular.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Informe um ano Hijri a partir de 1 AH e um número de mês de 1 a 12. O resultado mostra se esse mês contém vinte e nove ou trinta dias e se o ano informado é bissexto no sistema tabular. Como usa aritmética fixa de calendário, entradas idênticas sempre produzem resultados idênticos, sem consultar observações, localização, relógio ou calendário externo.

O que esta calculadora informa

Um mês Hijri pode ter vinte e nove ou trinta dias, e a resposta depende da convenção de calendário islâmico adotada. Esta calculadora responde especificamente segundo o calendário islâmico tabular, um sistema baseado em regras que organiza os anos em um ciclo recorrente de trinta anos. Informe o ano Hijri como inteiro positivo e o mês como número de 1 a 12. A resposta repete esses valores, apresenta a duração no campo days e indica se o ano é bissexto no calendário tabular. Esse resultado compacto é útil em regras de validação, seletores de data, agendas, materiais didáticos e sistemas que já armazenam datas Hijri tabulares. Ele não converte a data para o calendário gregoriano, não identifica o mês por nomes locais nem determina quando o crescente lunar foi observado. Ao declarar o modelo de calendário, o resultado permanece preciso: é uma resposta aritmética, e não uma afirmação sobre o início do mês anunciado por uma autoridade religiosa de determinado país.

Como o cálculo tabular funciona

O calendário islâmico tabular alterna a duração dos meses conforme um padrão regular. Os meses ímpares normalmente têm trinta dias, enquanto os pares têm vinte e nove. O décimo segundo mês é a exceção que liga o padrão mensal ao ciclo bissexto: tem vinte e nove dias em um ano comum e trinta em um ano bissexto. Os anos bissextos são escolhidos de forma determinística em um ciclo recorrente de trinta anos Hijri. O cálculo avalia o ano informado nesse ciclo usando aritmética de inteiros e aplica a regra correspondente ao mês. Não há dependência da data atual, do fuso horário local do dispositivo, das regras de horário de verão, de coordenadas geográficas, da rede ou de dados aleatórios. Embora possa ser executado em ambientes UTC, o cálculo sequer precisa construir uma data baseada em relógio. Isso evita misturar métodos de data local com serialização UTC e garante que o navegador e o processo da API retornem o mesmo resultado para os mesmos dois inteiros.

Escolha a convenção antes de usar o resultado

Use este resultado quando sua especificação exigir explicitamente o calendário islâmico tabular ou quando a aritmética determinística for mais importante do que coincidir com um mês lunar proclamado localmente. Ele é especialmente indicado para testes de software, cálculos históricos que adotam uma convenção tabular declarada, ferramentas offline e restrições de banco de dados baseadas no ciclo de trinta anos. Não trate a resposta como substituta de um calendário observacional, de uma autoridade nacional ou de um calendário como Umm al-Qura. Esses sistemas podem definir os limites dos meses por observações, previsões ou tabelas publicadas e, portanto, divergir do resultado tabular. Uma boa integração registra a convenção junto à data Hijri, valida que o ano seja pelo menos 1 e o mês esteja entre 1 e 12, e usa days como o maior dia permitido. Cada solicitação automatizada pela API custa US$ 0,002; a mesma lógica determinística também pode rodar no navegador para uma verificação imediata.

Casos de uso

Validar uma data Hijri tabular

Defina o maior dia aceito para um ano e mês Hijri antes de salvar um formulário ou importar registros.

Criar um seletor de data determinístico

Ofereça a quantidade correta de dias sem depender de relógio, fuso horário, solicitação de rede ou observações variáveis.

Montar testes de calendário repetíveis

Gere resultados estáveis para anos comuns e bissextos em software que implemente explicitamente o calendário islâmico tabular.

Perguntas frequentes

Quanto custa uma solicitação à API?

Cada solicitação à API custa US$ 0,002. Você também pode executar um cálculo individual no navegador.

O cálculo usa observações da Lua?

Não. Ele usa o calendário islâmico tabular determinístico e não consulta observações nem anúncios.

Por que outro calendário Hijri pode mostrar uma duração diferente?

Calendários observacionais e calendários regionais publicados podem usar regras ou dados diferentes. Este resultado vale apenas para a convenção tabular indicada.

Como o décimo segundo mês é tratado?

O mês 12 tem vinte e nove dias em um ano tabular comum e trinta dias em um ano tabular bissexto.

O fuso horário afeta o resultado?

Não. O cálculo usa somente o ano e o mês inteiros informados e não cria nem consulta uma data baseada em relógio.

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/hijri-month-length

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/hijri-month-length \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1446,"month":12}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/hijri-month-length",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 1446,
    "month": 12
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"year":1446,"month":12}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/hijri-month-length", 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": 1446,
  "month": 12
}

Exemplo de resposta

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