PHP / date_sunset

Bienvenidos sean a este post, hoy veremos una función de PHP.

Esta función nos informa la hora de puesta del sol de un lugar. Pasemos a ver como es su sintaxis:

date_sunset(timestamp, formato, latitud, longitud, cenit, gmtoffset);

Para obtener este dato vamos a necesitar varios datos. El primero va a ser la hora de nuestro equipo, por lo general es recomendable usar a la función time que nos entregará este dato que es en formato UNIX. El siguiente parámetro es el formato de como mostraremos la información. Disponemos de tres constantes:

• SUNFUNCS_RET_STRING: devuelve el valor como un tipo String
• SUNFUNCS_RET_DOUBLE: devuelve el valor como tipo coma flotante
• SUNFUNCS_RET_TIMESTAMP: devuelve el valor como tipo entero y Unix

El tercer parámetro es para indicar la latitud de donde queremos obtener el dato. Los valores positivos son paraa el Norte y los negativos para el Sur. El cuarto parámetro es para la longitud, al igual que el anterior los valores positivos son para el Este y negatiivos para el Oeste. El quinto es para el cenit o punto más alto del observador, sino se informa utiliza a date.sunrise_zenith. El último parámetro es para indicar la diferencia horaria entre UTC y la región a verificar.

El primer parámetro es el único obligatorio, el resto son opcionales y siempre tomará el valor predeterminado que tengan asignado. Con todo esto comentado, para entender como funciona vamos a analizar el siguiente ejemplo:

<?php
echo("Cordoba, Argentina: Date: " . date("D M d Y")) . "\n";
echo("Hora de puesta del sol: ");
echo(date_sunset(time(),SUNFUNCS_RET_STRING,-33,-65,90,-3)) . "\n";
?>

En este ejemplo calcularemos el horario en base a la zona donde vivó. Las primeras dos líneas son para mostrar primero el día que lo ejecutamos y donde mostraremos el horario de la puesta del sol. Como mencionamos anteriormente, usamos a time para obtener el tiempo Unix necesario para procesarlo. Luego le indicamos como debe formatear la respuesta, para luego pasar los datos de la zona a verificar.

Estos son los valores aproximados a donde vivó, sino quieren usar los mismos les recomiendo usar a google para obtenerlos. También les pasé el cenit y la diferencia horaria correcta para mi zona. Esto para obtener un valor más aproximado al verdadero. Veamos como es la salida:

$ php date_sunset.php
Cordoba, Argentina: Date: Sun Mar 22 2026
Hora de puesta del sol: 19:25
$

En este caso, obtuve un valor muy próximo a la hora verdadera de la puesta del sol. Por eso, les recomiendo usar los propios de la zona donde viven para entender mejor como funciona.

En resumen, hoy hemos visto a date_sunset, que es, para que sirve, como se utiliza, los parámetros que podemos utilizar y un ejemplo simple para ver como trabaja. Espero les haya sido de utilidad, les dejo algunas de mis redes sociales para seguirme o recibir una notificacion cada vez que subo un nuevo post:

Donación

Es para mantenimento del sitio, gracias!

$1.50