ForHosting KIT · Fechas y tiempo

Convertidor gregoriano a hégira

Escriba una fecha gregoriana y obtenga la fecha de la hégira tabular civil: el 1 de enero de 2000 es el 24 de Ramadán de 1420. Las reglas aritméticas kuwaitíes dan el mismo resultado en cualquier equipo, sin observación de la luna. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Fecha
2000-01-01
Obtiene
Año gregoriano
2 000
Mes gregoriano
1
Día gregoriano
1
Jdn
2 451 545

Convertir una fecha civil gregoriana en una fecha islámica de la hégira es una necesidad cotidiana en planificación, documentación, educación y funciones de producto que deben mostrar ambos calendarios a la vez. Festividades religiosas, etiquetas fiscales, certificados y cadenas de localización suelen guardar un sistema y deben mostrar el otro sin depender del reloj del navegador ni de un servicio astronómico remoto. Este convertidor de fecha gregoriana a hégira acepta una fecha de calendario ISO explícita en forma YYYY-MM-DD, la trata como día civil UTC (sin hora del día y sin desplazamiento de zona horaria local) y devuelve el año, mes y día de la hégira civil tabular correspondientes mediante el conocido algoritmo aritmético kuwaití. El algoritmo es aritmética entera plenamente determinista: día gregoriano a número de día juliano y, a continuación, JDN a hégira en el ciclo de años bisiestos de 30 años fijo. No es observación lunar; los calendarios administrativos y muchos de software usan esta convención civil, que puede diferir un día de la observación religiosa local.

Qué significa la hégira civil tabular y cómo se diferencia de la observación lunar

El calendario islámico es un calendario lunar puro de doce meses que, en el esquema civil, alternan entre veintinueve y treinta días, con un día intercalar añadido al duodécimo mes en los años bisiestos de un ciclo de treinta años. Once de cada treinta años son bisiestos bajo la convención aritmética (tabular) habitual, lo que da una duración media del año de trescientos cincuenta y cuatro y once treintavos de día.

Ese calendario aritmético se llama a veces hégira civil o tabular porque gobiernos, bases de datos y muchas bibliotecas usan reglas fijas en lugar de esperar una observación local del creciente. Los calendarios de observación lunar usados para el culto en una ciudad dada pueden iniciar el mes un día antes o después de la tabla civil; esta capacidad documenta deliberadamente la vía civil para que los resultados sean reproducibles entre máquinas y años.

La conversión no consulta almanaques, satélites ni APIs: con la misma entrada ISO gregoriana, cada cliente recibe el mismo año, número de mes, nombre de mes y día de la hégira. La época civil del algoritmo sitúa el 1 de muharram del año 1 AH en el día gregoriano proléptico que codifican los enteros kuwaitíes (clásicamente ligado a mediados de julio de 622 d. C. en el cómputo juliano).

Cuando publique documentos con doble datación, combine este convertidor con una etiqueta clara como AH civil tabular para que el lector sepa que no se reivindica una fecha de observación de grado fatwa. Si su producto debe coincidir con una autoridad religiosa nacional concreta, utilice el mapeo publicado por esa autoridad en lugar de tratar cualquier tabla aritmética única como verdad sagrada universal.

Contrato de entrada, semántica del día UTC y campos de respuesta

El valor debe ser exactamente cuatro dígitos, un guion, dos dígitos, un guion y dos dígitos: YYYY-MM-DD. El día debe existir en el calendario gregoriano proléptico: mes entre 01 y 12, día dentro de la longitud de ese mes, y 29 de febrero solo en años bisiestos. Se rechazan los años fuera de 0001–9999.

No hay componente horario ni desfase de zona horaria en la solicitud: la cadena se interpreta como un día civil UTC completo, de modo que dos llamantes en zonas distintas nunca partan la misma cadena de fecha a medianoche. Ejemplo: 2000-01-01 se convierte en 24 Ramadan 1420 AH según esta tabla civil. No pase Date.now() a menos que antes formatee un día de calendario fijo; la capacidad nunca lee el reloj del servidor.

Documentos y certificados con doble fecha

Imprima fechas gregorianas y de hégira civil tabular en diplomas, contratos y cartas oficiales a partir de una sola cadena ISO almacenada.

Localización y líneas de fecha en CMS

Genere etiquetas AH estables para artículos, páginas de eventos y plantillas de correo sin sorpresas de zona horaria del Date en el cliente.

Comparaciones de calendarios en el aula

Permita al alumnado verificar conversiones aritméticas de la hégira frente a tablas de libro y contrastar convenciones civiles frente a observación lunar.

¿Es observación lunar o civil tabular?

Solo civil tabular (aritmética kuwaití en un ciclo bisiesto fijo de 30 años). La observación religiosa local puede diferir un día; etiquete los resultados como AH civil cuando importe esa distinción.

¿Afectan la zona horaria o el reloj del servidor al resultado?

No. La fecha ISO se trata como un día civil UTC completo sin hora del día. El manejador nunca llama a Date ni lee la hora de pared.

¿Cuántos años bisiestos tiene el calendario de la hégira tabular?

Once de cada treinta años. En esos años bisiestos se añade un día al duodécimo mes, y el ciclo de treinta años se repite siempre igual, lo que permite calcular cualquier fecha sin tablas.

¿Cuántos días tiene un mes de la hégira?

En el esquema civil, los doce meses lunares alternan entre 29 y 30 días. La única excepción es el duodécimo mes de los años bisiestos, que gana un día adicional.

¿Cómo debo rotular un documento con doble fecha?

Añada una etiqueta clara, como «hégira tabular civil», para que el lector sepa que no es una fecha de avistamiento lunar. Si debe coincidir con una autoridad religiosa nacional, use las fechas que esa autoridad publica.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/date/gregorian-to-hijri

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

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"}'
{
  "date": "2000-01-01"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.gregorian_to_hijri",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

El mismo módulo puro alimenta la herramienta gratuita del navegador y la ruta API, de modo que comprobaciones escolares, plugins de CMS y workers en el borde nunca discrepan en la fecha AH impresa para una entrada dada.

Contrato de entrada, semántica del día UTC y campos de respuesta

Envíe por POST un cuerpo JSON con un único campo de cadena obligatorio llamado date (se aceptan los alias iso_date, value y gregorian). En caso de éxito, la respuesta repite la fecha gregoriana normalizada y su año, mes y día; incluye el número de día juliano entero usado como intermediario; y devuelve hijri_year, hijri_month (1–12), hijri_day, hijri_month_name en inglés, hijri_iso como año-mes-día con mes y día rellenados a cero, y hijri_formatted como frase legible del tipo 24 Ramadan 1420 AH. Los campos de metadatos calendar, algorithm y formula documentan que la vía es hijri_tabular_civil mediante kuwaiti_arithmetic. Campos ausentes, valores que no son cadenas, cadenas ISO mal formadas y días de calendario imposibles fallan con invalid_input y no se facturan.

Dónde una API de gregoriano a hégira aporta valor real

Los equipos de producto que envían líneas de fecha bilingües en billetes, diplomas y formularios oficiales necesitan una sola función que convierta una fecha ISO almacenada en una cadena AH estable sin embeber grandes bibliotecas de calendario en cada cliente. Las plataformas educativas que enseñan sistemas de calendario pueden mostrar el ciclo civil de años bisiestos junto a las reglas bisiestas gregorianas y permitir que el alumnado compruebe los deberes sin raspar sitios de terceros que cambian algoritmos en silencio. Las canalizaciones de localización que generan correos o PDF en varios locales pueden llamar a este endpoint una vez por fecha de documento y almacenar en caché los campos estructurados. Como la implementación es pure parse de nivel A, cada llamada correcta cuesta el precio base publicado $0.002 sin tokens de modelo y sin red saliente; la validación fallida no consume saldo.

¿Cómo convierto una fecha gregoriana a hégira?

Envíe {"date":"YYYY-MM-DD"} como día civil gregoriano real. La API devuelve hijri_year, hijri_month, hijri_day, nombre de mes en inglés, hijri_iso y una cadena AH formateada con el algoritmo civil tabular.

¿Qué errores de entrada se rechazan?

Fecha ausente, valores que no son cadenas, cadenas que no son exactamente YYYY-MM-DD, años fuera de 0001–9999 y días imposibles como 2023-02-29 fallan con invalid_input y no se facturan.

¿Cuánto cuesta el convertidor de gregoriano a hégira?

La herramienta del navegador es gratuita. Las solicitudes API usan saldo KIT prepago a $0.002 por llamada correcta; la entrada inválida no se factura.

Ver la documentación completa del KIT →