PHP / cal_from_jd

Bienvenidos sean a este post, hoy veremos una funcion de PHP.

Esta funcion permite convertir una fecha del calendario Juliano a cualquier otro de los validos, veamos su sintaxis:

cal_from_jd(fecha, calendario);

En fecha pasaremos una fecha juliana pero en formato UNIX o entero y el segundo dato sera el calendario al cual convertiremos. Estos son los calendarios disponibles:

Constante	Valor	Descripcion
CAL_GREGORIAN	0	Calendario Gregoriano
CAL_JULIAN	1	Calendario Juliano
CAL_JEWISH	2	Calendario Judio
CAL_FRENCH	3	Cal. Revol. Francesa

Esta conversion sera devuelta en formato de array. Para entender el concepto, vamos a analizar el siguiente ejemplo:

<?php

$dia = unixtojd(mktime(0,0,0,10,22,2024));
print_r(cal_from_jd($dia, CAL_JEWISH));
print_r(cal_from_jd($dia, CAL_GREGORIAN));

?>

Primero definiremos una variable que almacenara el valor del calendario Juliano. En esta crearemos el valor en formato UNIX con la funcion mktime y los valores que le pasamos. La funcion unixtojd se encarga de convertir el valor anterior a uno de Juliano. Lo siguiente es mostrar el resultado de usar la funcion con la fecha anteriormente generada y la convertiremos al calendario judio. Volvemos a repetir la operacion pero esta vez con el calendario gregoriano. Ejecutemos este codigo para ver como es su salida:

$ php calendario.php
Array
(
    [date] => 1/19/5785
    [month] => 1
    [day] => 19
    [year] => 5785
    [dow] => 1
    [abbrevdayname] => Mon
    [dayname] => Monday
    [abbrevmonth] => Tishri
    [monthname] => Tishri
)
Array
(
    [date] => 10/21/2024
    [month] => 10
    [day] => 21
    [year] => 2024
    [dow] => 1
    [abbrevdayname] => Mon
    [dayname] => Monday
    [abbrevmonth] => Oct
    [monthname] => October
)
$

Como pueden ver nos devolvio un monton de datos que podremos recuperar en base a la clave que tiene asignada. Para entender como usarlo, tomemos el codigo anterior y hagamos la siguiente modificacion:

<?php

$dia = unixtojd(mktime(0,0,0,10,22,2024));
$datos = cal_from_jd($dia, CAL_JEWISH);

echo $datos['dayname'] . ", " . $datos['day'] . " de " . $datos['monthname']
        . " del " . $datos['year'] . "\n";

?>

Mantenemos la creacion de la fecha y la conversion de esta al calendario judio. Pero ahora lo almacenaremos en otra variable. Luego tomaremos esta variable y mostraremos los valores de algunas claves que contiene para generar un mensaje con la fecha. Ejecutemos y veamos como es su salida:

$ php calendario.php
Monday, 19 de Tishri del 5785
$

En resumen, hoy hemos visto a cal_from_jd, que es, para que sirve, como se utiliza, y un ejemplo para verlo en accion. Espero les haya resultado de utilidad sigueme en tumblr, Twitter o Facebook para recibir una notificacion cada vez que subo un nuevo post en este blog, nos vemos en el proximo post.