Conversor gregoriano para hégira
Digite uma data gregoriana e receba a data da hégira tabular civil: 1 de janeiro de 2000 é 24 de Ramadã de 1420. As regras aritméticas kuwaitianas dão o mesmo resultado em qualquer aparelho, sem avistamento da lua. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Data
- 2000-01-01
- Ano gregoriano
- 2.000
- Mês gregoriano
- 1
- Dia gregoriano
- 1
- Jdn
- 2.451.545
Converter uma data civil gregoriana em uma data islâmica da hégira é uma necessidade diária em agendamento, documentação, educação e recursos de produto que precisam exibir os dois calendários lado a lado. Feriados religiosos, rótulos fiscais, certificados e cadeias de localização frequentemente armazenam um sistema e devem exibir o outro sem depender do relógio do navegador nem de um serviço astronômico remoto. Este conversor de data gregoriana para hégira aceita uma data de calendário ISO explícita no formato YYYY-MM-DD, trata esse dia como data civil UTC (sem hora do dia e sem deslocamento de fuso horário local) e devolve o ano, mês e dia da hégira civil tabular correspondentes usando o conhecido algoritmo aritmético kuwaitiano. O algoritmo é matemática inteira totalmente determinística: dia gregoriano para Número do Dia Juliano e, em seguida, JDN para hégira no ciclo fixo de anos bissextos de 30 anos. Não é avistamento da lua; calendários administrativos e muitos de software usam essa convenção civil, que pode diferir em um dia da observação religiosa local.
O que significa a hégira civil tabular e como difere do avistamento da lua
O calendário islâmico é um calendário lunar puro de doze meses que, no esquema civil, alternam entre vinte e nove e trinta dias, com um dia intercalar adicionado ao décimo segundo mês nos anos bissextos de um ciclo de trinta anos. Onze de cada trinta anos são bissextos na convenção aritmética (tabular) comum, resultando em uma duração média do ano de trezentos e cinquenta e quatro e onze trinta avos de dia.
Esse calendário aritmético às vezes é chamado de hégira civil ou tabular porque governos, bancos de dados e muitas bibliotecas usam regras fixas em vez de esperar um avistamento local do crescente. Calendários de avistamento usados para observância religiosa em uma cidade podem iniciar o mês um dia antes ou depois da tabela civil; esta capacidade documenta deliberadamente a via civil para que os resultados permaneçam reproduzíveis entre máquinas e anos.
A conversão não consulta almanaques, satélites nem APIs: com a mesma entrada ISO gregoriana, cada cliente recebe o mesmo ano, número do mês, nome do mês e dia da hégira. A época civil do algoritmo coloca 1 de Muharram do ano 1 AH no dia gregoriano proléptico que os inteiros kuwaitianos codificam (classicamente ligado a meados de julho de 622 d.C. no cômputo juliano).
Ao publicar documentos com dupla datação, associe este conversor a um rótulo claro como AH civil tabular para que os leitores saibam que não se reivindica uma data de avistamento de grau fatwa. Se o seu produto precisa coincidir com uma autoridade religiosa nacional específica, use o mapeamento publicado por essa autoridade em vez de tratar qualquer tabela aritmética única como verdade sagrada universal.
Contrato de entrada, semântica do dia UTC e campos de resposta
O valor deve ser exatamente quatro dígitos, um hífen, dois dígitos, um hífen e dois dígitos: YYYY-MM-DD. O dia deve existir no calendário gregoriano proléptico: mês entre 01 e 12, dia dentro do comprimento desse mês, e 29 de fevereiro apenas em anos bissextos. Anos fora de 0001–9999 são rejeitados.
Não há componente de hora nem deslocamento de fuso na solicitação: a string é interpretada como um dia civil UTC inteiro, de modo que dois chamadores em zonas diferentes nunca partem a mesma string de data à meia-noite. Exemplo: 2000-01-01 converte-se em 24 Ramadan 1420 AH nesta tabela civil. Não passe Date.now() a menos que primeiro formate um dia de calendário fixo; a capacidade nunca lê o relógio do servidor.
Casos de uso
Documentos e certificados com dupla datação
Imprima datas gregorianas e da hégira civil tabular em diplomas, contratos e cartas oficiais a partir de uma única string ISO armazenada.
Localização e linhas de data em CMS
Gere rótulos AH estáveis para artigos, páginas de eventos e modelos de e-mail sem surpresas de fuso do Date no cliente.
Comparações de calendários em sala de aula
Permita que os alunos verifiquem conversões aritméticas da hégira em relação a tabelas didáticas e contrastem convenções civis versus avistamento da lua.
Perguntas frequentes
Isto é avistamento da lua ou civil tabular?
Apenas civil tabular (aritmética kuwaitiana em um ciclo bissexto fixo de 30 anos). O avistamento religioso local pode diferir em um dia; rotule os resultados como AH civil quando essa distinção importar.
O fuso horário ou o relógio do servidor afetam o resultado?
Não. A data ISO é tratada como um dia civil UTC inteiro, sem hora do dia.
Quantos anos bissextos tem o calendário da hégira tabular?
Onze a cada trinta anos. Nesses anos bissextos, o décimo segundo mês ganha um dia, e o ciclo de trinta anos se repete sempre igual, o que permite calcular qualquer data sem tabelas.
Quantos dias tem um mês da hégira?
No esquema civil, os doze meses lunares alternam entre 29 e 30 dias. A única exceção é o décimo segundo mês dos anos bissextos, que ganha um dia extra.
Como identificar a data em um documento com duas datas?
Use um rótulo claro, como «hégira tabular civil», para o leitor saber que não é uma data de avistamento da lua. Se precisar seguir uma autoridade religiosa nacional, use as datas que ela publica.
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
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/gregorian-to-hijri \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2000-01-01"}'const res = await fetch("https://api.kit.forhosting.com/date/gregorian-to-hijri", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2000-01-01"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/gregorian-to-hijri",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2000-01-01"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/gregorian-to-hijri", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2000-01-01"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2000-01-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/gregorian-to-hijri", 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": "2000-01-01"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.gregorian_to_hijri",
"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
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
O mesmo módulo puro alimenta a ferramenta gratuita do navegador e o caminho da API, de modo que verificações de lição de casa, plugins de CMS e workers na borda nunca discordam da data AH impressa para uma entrada dada.
Contrato de entrada, semântica do dia UTC e campos de resposta
Envie por POST um corpo JSON com um único campo de string obrigatório chamado date (os alias iso_date, value e gregorian são aceitos). Em caso de sucesso, a resposta ecoa a data gregoriana normalizada e seu ano, mês e dia; inclui o Número do Dia Juliano inteiro usado como intermediário; e devolve hijri_year, hijri_month (1–12), hijri_day, hijri_month_name em inglês, hijri_iso como ano-mês-dia com mês e dia preenchidos com zeros, e hijri_formatted como frase legível como 24 Ramadan 1420 AH. Os campos de metadados calendar, algorithm e formula documentam que o caminho é hijri_tabular_civil via kuwaiti_arithmetic. Campos ausentes, valores que não são strings, strings ISO malformadas e dias de calendário impossíveis falham com invalid_input e não são cobrados.
Onde uma API de gregoriano para hégira vale a pena
Equipes de produto que entregam linhas de data bilíngues em bilhetes, diplomas e formulários oficiais precisam de uma única função que transforme uma data ISO armazenada em uma string AH estável sem embutir grandes bibliotecas de calendário em cada cliente. Plataformas educacionais que ensinam sistemas de calendário podem mostrar o ciclo civil de anos bissextos ao lado das regras bissextas gregorianas e permitir que os alunos verifiquem a lição sem raspar sites de terceiros que mudam algoritmos em silêncio. Pipelines de localização que geram e-mails ou PDFs em vários locales podem chamar este endpoint uma vez por data de documento e armazenar em cache os campos estruturados. Como a implementação é pure parse de nível A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo e sem rede de saída; a validação falha não consome saldo.
Perguntas técnicas
Como converto uma data gregoriana para hégira?
Envie {"date":"YYYY-MM-DD"} como dia civil gregoriano real. A API devolve hijri_year, hijri_month, hijri_day, nome do mês em inglês, hijri_iso e uma string AH formatada com o algoritmo civil tabular.
Quais erros de entrada são rejeitados?
Data ausente, valores que não são strings, strings que não são exatamente YYYY-MM-DD, anos fora de 0001–9999 e dias impossíveis como 2023-02-29 falham com invalid_input e não são cobrados.
Quanto custa o conversor de gregoriano para hégira?
A ferramenta do navegador é gratuita. Solicitações API usam saldo KIT pré-pago a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.