date_sunrise
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_infoen 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