date_sunset

(PHP 5, PHP 7, PHP 8)

date_sunset Devuelve la hora de la puesta de sol de un día y ubicación dados

Descripción

date_sunset(
    int $timestamp,
    int $format = SUNFUNCS_RET_STRING,
    float $latitude = ini_get("date.default_latitude"),
    float $longitude = ini_get("date.default_longitude"),
    float $zenith = ini_get("date.sunset_zenith"),
    float $gmt_offset = 0
): mixed

date_sunset() devuelve la hora de la puesta de sol para un día (especificado como timestamp) y ubicación dados.

Parámetros

timestamp

La marca de tiempo timestamp del día del que se va a tomar la puesta de sol.

format

Constantes format
constante descripción ejemplo
SUNFUNCS_RET_STRING devuelve el resultado como string 16:46
SUNFUNCS_RET_DOUBLE devuelve el resultado como float 16.78243132
SUNFUNCS_RET_TIMESTAMP devuelve el resultado como integer (timestamp) 1095034606

latitude

La latitud, por defecto a Norte, y como valor negativo a Sur. Vea también: date.default_latitude

longitude

La longitud, por defecto a Este, y como valor negativo a Oeste. Vea tambien: date.default_longitude

zenith

El cénit, por defecto: date.sunset_zenith

gmtoffset

El índice GMT especificado en horas.

Errores/Excepciones

Cada vez que se llame a una función de fecha/hora se generará un E_NOTICE si la zona horaria no es válida, y/o un mensaje E_STRICT o E_WARNING si se emplea la configuración del sistema o la variable global TZ. Véase también date_default_timezone_set()

Historial de cambios

Versión Descripción
5.1.0

Ahora muestra un error E_STRICT y E_NOTICE cuando ocurren errores con zonas horarias.

Valores devueltos

Devuelve la hora de la puesta de sol en un formato format especificado si se tuvo éxito o false en caso de error.

Ejemplos

Ejemplo #1 Ejemplo de date_sunset()

<?php

/* calcular la puesta de sol para Lisboa, Portugal
Latitud: 38.4 Norte
Longitud: 9 Oeste
Cenit ~= 90
Índice: +1 GMT
*/

echo date("D M d Y"). ', hora de la puesta de sol : ' .date_sunset(time(), SUNFUNCS_RET_STRING38.4, -9901);

?>

El resultado del ejemplo sería algo similar a:

Mon Dec 20 2004, hora de la puesta de sol : 18:13

Ver también

  • date_sunrise() - Devuelve la hora de la salida del sol de un día y ubicación dados