jdtojewish()

Introducción

La función PHP jdtojewish() convierte un Número de Día Juliano (un número entero continuo de días) en una fecha del calendario judío (hebreo). Forma parte de la extensión Calendar de PHP y es la inversa de jewishtojd().

Esta página cubre la sintaxis de la función, sus parámetros y valor de retorno, los flags opcionales de formato hebreo, un ejemplo funcional y los errores comunes a tener en cuenta.

¿Qué es un Número de Día Juliano?

Un Número de Día Juliano (JDC) es un conteo continuo de días enteros desde el mediodía del 1 de enero de 4713 a.C. (en el calendario juliano proléptico). Dado que cada fecha — pasada o futura — se corresponde con un único entero, el JDC es una representación neutral conveniente: conviertes cualquier fecha de calendario a un Día Juliano y luego lo conviertes de nuevo a otro calendario. Así es exactamente como funcionan las funciones de conversión de calendario de PHP: cada calendario tiene una función *tojd() y una función jdto*().

Nótese que el "Día Juliano" no tiene relación con el "calendario Juliano" — solo comparten el nombre.

Sintaxis

jdtojewish(int $julian_day, bool $hebrew = false, int $flags = 0): string

Valor de retorno: una cadena de texto. Cuando $hebrew es false, el formato es "mes/día/año", por ejemplo "8/7/5784". Cuando $hebrew es true, la fecha se muestra como una cadena en hebreo.

Flags de formato hebreo

Estas constantes se pueden combinar con el operador | (OR a nivel de bits) y solo tienen efecto cuando $hebrew es true:

Ejemplo básico

<?php

// First convert a Gregorian date to a Julian Day Count.
$julianDay = gregoriantojd(8, 7, 2024); // month, day, year

// Then convert that Julian Day to a Jewish calendar date.
$jewishDate = jdtojewish($julianDay);

echo "Julian Day Count: $julianDay\n";
echo "Jewish date (month/day/year): $jewishDate\n";
?>

En este ejemplo partimos de la fecha gregoriana 7 de agosto de 2024, la convertimos en un Número de Día Juliano con gregoriantojd(), y luego pasamos ese número a jdtojewish(). El resultado se devuelve en formato mes/día/año usando los números de mes y año del calendario judío.

Devolver una cadena en hebreo

Pasa true como segundo argumento para mostrar la fecha en texto hebreo, y combina flags para un formato más completo:

<?php

$julianDay = gregoriantojd(8, 7, 2024);

$hebrew = jdtojewish(
    $julianDay,
    true,
    CAL_JEWISH_ADD_GERESHAYIM | CAL_JEWISH_ADD_ALAFIM_GERESH
);

echo $hebrew;
?>

Errores comunes

• Usa un Día Juliano entero, no fraccionario. Funciones como gregoriantojd() devuelven un número entero. Pasar un valor flotante como 2459401.5 es rechazado en PHP moderno — trabaja siempre con enteros de días completos.
• Los flags se ignoran a menos que $hebrew sea true. Las constantes CAL_JEWISH_* solo modifican la salida en formato de cadena hebreo.
• La extensión Calendar debe estar disponible. jdtojewish() forma parte de la extensión calendar de PHP. Viene incluida por defecto en la mayoría de distribuciones, pero si la función no está definida, habilita o compila la extensión.

Funciones relacionadas

• jewishtojd() — la inversa: fecha judía a Número de Día Juliano.
• gregoriantojd() — fecha gregoriana a Número de Día Juliano.
• jdtogregorian() — Número de Día Juliano a fecha gregoriana.
• jdmonthname() — nombre del mes para un Día Juliano en un calendario dado.
• jddayofweek() — día de la semana para un Día Juliano.

Conclusión

jdtojewish() convierte un Número de Día Juliano en una fecha del calendario judío, opcionalmente como texto hebreo. Combínala con gregoriantojd() (o cualquier otra función *tojd()) para convertir entre calendarios, recuerda pasar un número entero de días, y usa los flags CAL_JEWISH_* solo cuando solicites la forma de cadena hebreo.

Práctica