date_sunset

#[\Deprecated] date_sunset(int $timestamp, [int $returnFormat], [float $latitude], [float $longitude], [float $zenith], [float $utcOffset]): string
```php

La función `date_sunset` devuelve la hora de puesta del sol para un día (especificado como `timestamp` Unix) y un lugar dados.

## Parámetros

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

`returnFormat`  
| Constante | Descripción | Ejemplo |
|----|----|----|
| SUNFUNCS_RET_STRING | Devuelve el resultado en forma de `string` | 16:46 |
| SUNFUNCS_RET_DOUBLE | Devuelve el resultado en forma de `float` | 16.78243132 |
| SUNFUNCS_RET_TIMESTAMP | Devuelve el resultado en forma de `int` (timestamp) | 1095034606 |

Constantes para el parámetro `returnFormat`

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

`longitude`  
Por omisión, 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 omisión [date.sunset_zenith](#ini.date.sunset-zenith)

| Ángulo | Descripción |
|----|----|
| 90°50' | Puesta del sol: El punto donde el sol se vuelve invisible. |
| 96° | Crepúsculo civil: convencionalmente utilizado para significar el fin del crepúsculo. |
| 102° | Crepúsculo náutico: el punto de fin del horizonte siendo visible en el mar. |
| 108° | Crepúsculo astronómico: el punto donde el sol deja de ser la fuente de toda iluminación. |

Valores comunes de ángulo `zenith`

`utcOffset`  
Especificado en horas. El `utcOffset` es ignorado, si `returnFormat` es `SUNFUNCS_RET_TIMESTAMP`.

## Valores devueltos

Devuelve la hora de puesta del sol en el `returnFormat` especificado o `false` si ocurre un error. Una razón posible del fallo es que el sol no se pone, 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_sunset`