(PHP 5, PHP 7, PHP 8)
date_sunrise — Devuelve la hora de salida del sol para un día y un lugar dados
Esta función está DEPRECADA a partir de PHP 8.1.0. Depender de esta función se desaconseja fuertemente. Se recomienda el uso de date_sun_info() en su lugar.
$timestamp,$returnFormat = SUNFUNCS_RET_STRING,$latitude = null,$longitude = null,$zenith = null,$utcOffset = null
date_sunrise() devuelve la hora de salida del sol para un día
(especificado por el argumento timestamp) y un lugar dados.
timestampEl timestamp Unix del día para el cual se proporciona la hora de salida del sol.
returnFormat
| Constante | Descripción | Ejemplo |
|---|---|---|
| SUNFUNCS_RET_STRING | Devuelve el resultado como string | 16:46 |
| SUNFUNCS_RET_DOUBLE | Devuelve el resultado como número decimal | 16.78243132 |
| SUNFUNCS_RET_TIMESTAMP | Devuelve el resultado como entero (timestamp) | 1095034606 |
latitudePor defecto, es el Norte. Pase un valor negativo para el Sur. Ver también date.default_latitude.
longitudePor defecto, es el Este. Pase un valor negativo para el Oeste. Ver también date.default_longitude.
zenith
zenith es el ángulo entre el centro del
sol y la línea perpendicular a la superficie de la tierra. Por defecto
date.sunrise_zenith
| Ángulo | Descripción |
|---|---|
| 90°50' | Salida del sol: el punto donde el sol se vuelve visible. |
| 96° | Crepúsculo civil: convencionalmente utilizado para significar el inicio del amanecer. |
| 102° | Crepúsculo náutico: el punto donde el horizonte comienza a ser visible en el mar. |
| 108° | Crepúsculo astronómico: el punto donde el sol comienza a ser la fuente de toda iluminación. |
utcOffset
Especificado en horas.
El utcOffset se ignora si
returnFormat es
SUNFUNCS_RET_TIMESTAMP.
Devuelve la hora de salida del sol en el returnFormat
especificado en caso de éxito o false si ocurre un error.
Una razón posible del fallo es que el sol no salga
en absoluto, lo cual ocurre dentro de los círculos
polares durante parte del año.
Cada llamada a una función de fecha/hora generará un diagnóstico de tipo
E_WARNING si la zona horaria no es válida.
Ver también date_default_timezone_set()
| Versión | Descripción |
|---|---|
| 8.1.0 | Esta función ha sido marcada como obsoleta en favor de date_sun_info(). |
| 8.0.0 |
latitude, longitude,
zenith y utcOffset ahora son nullable.
|
Ejemplo #1 Ejemplo con date_sunrise()
<?php
/* Calcula la hora de salida del sol para Lisboa, Portugal
Latitud: 38.4 Norte
Longitud: 9 Oeste
Zenith ~= 90
offset: +1 GMT
*/
echo date("D M d Y"). ', hora de salida del sol: ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>Resultado del ejemplo anterior es similar a :
Mon Dec 20 2004, hora de salida del sol: 08:54
Ejemplo #2 Sin salida del sol
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>El ejemplo anterior mostrará :
bool(false)