Documentación offline PHP master

date_sunrise

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

date_sunrise

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

[!WARNING] 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], [float $latitude], [float $longitude], [float $zenith], [float $utcOffset]): string
```php

`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`  
| 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 |

Constantes para el argumento `format`

`latitude`  
Por defecto, es el Norte. Pase un valor negativo para el Sur. Ver también [date.default_latitude](#ini.date.default-latitude).

`longitude`  
Por defecto, es el Este. Pase un valor negativo para el Oeste. Ver también [date.default_longitude](#ini.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](#ini.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. |

Valores comunes del ángulo `zenith`

`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 con `date_sunrise`
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

Sin salida del sol