array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.date-sunrise.php', 1 => 'date_sunrise', 2 => 'Devuelve la hora de salida del sol para un día y un lugar dados', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Funciones de Fecha/Hora', ), 'prev' => array ( 0 => 'function.date-sun-info.php', 1 => 'date_sun_info', ), 'next' => array ( 0 => 'function.date-sunset.php', 1 => 'date_sunset', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/datetime/functions/date-sunrise.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

date_sunrise

(PHP 5, PHP 7, PHP 8)

date_sunrise — Devuelve la hora de salida del sol para un día y un lugar dados

Advertencia

Esta función está OBSOLETA a partir de PHP 8.1.0. Depender de esta función está altamente desaconsejado. Se recomienda el uso de date_sun_info() en su lugar.

Descripción

#[\Deprecated]
date_sunrise(
    int $timestamp,
    int $returnFormat = SUNFUNCS_RET_STRING,
    ?float $latitude = null,
    ?float $longitude = null,
    ?float $zenith = null,
    ?float $utcOffset = null
): string|int|float|false

date_sunrise() devuelve la hora de salida del sol para un día (especificado por el argumento timestamp) y un lugar dados.

Parámetros

timestamp

El timestamp Unix del día para el cual se proporciona la hora de salida del sol.

returnFormat

Constantes para el argumento 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 int (timestamp) 1095034606

latitude

Por defecto, es el Norte. Pase un valor negativo para el Sur. Ver también date.default_latitude.

longitude

Por 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
Valores comunes del ángulo 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.

Valores devueltos

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.

Errores/Excepciones

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()

Historial de cambios

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.

Ejemplos

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:

Deprecated: Constant SUNFUNCS_RET_STRING is deprecated in script on line 10
Deprecated: Function date_sunrise() is deprecated since 8.1, use date_sun_info() instead in script on line 10
Mon Dec 20 2004, sunrise time : 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á:

Deprecated: Constant SUNFUNCS_RET_STRING is deprecated in script on line 3
Deprecated: Function date_sunrise() is deprecated since 8.1, use date_sun_info() instead in script on line 3
bool(false)

Ver también