# date_sunrise

(PHP 5, PHP 7, PHP 8)

date_sunrise — Devuelve la hora de la salida del sol de un día y ubicación dados

### Descripción

date_sunrise(
int `$timestamp`,
int `$format` = SUNFUNCS_RET_STRING,
float `$latitude` = ini_get("date.default_latitude"),
float `$longitude` = ini_get("date.default_longitude"),
float `$zenith` = ini_get("date.sunrise_zenith"),
float `$gmt_offset` = 0
): mixed

date_sunrise() devuelve la hora de la salida del sol para un día (especificado como `timestamp`) y ubicación dados.

### Parámetros

`timestamp`

  La marca de tiempo `timestamp` del día del que se va a tomar la salida del sol.

`format`

  Constantes `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 integer (timestamp) | 1095034606

`latitude`

  La latitud, por defecto a Norte, y como valor negativo a Sur. Vea también: `date.default_latitude`

`longitude`

  La longitud, por defecto a Este, y como valor negativo a Oeste. Vea tambien: `date.default_longitude`

`zenith`

  El cénit, por defecto: `date.sunset_zenith`

`gmtoffset`

  El índice GMT especificado en horas.

### Valores devueltos

Devuelve la hora de la salida del sol en un formato `format` especificado si se tuvo éxito o `false` en caso de error.

### Errores/Excepciones

Cada vez que se llame a una función de fecha/hora se generará un `E_NOTICE` si la zona horaria no es válida, y/o un mensaje `E_STRICT` o `E_WARNING` si se emplea la configuración del sistema o la variable global TZ. Véase también date_default_timezone_set()

### Historial de cambios

Versión | Descripción
--- | ---
5.1.0 | Ahora muestra un error `E_STRICT` y `E_NOTICE` cuando ocurren errores con zonas horarias.

### Ejemplos

Ejemplo #1 Ejemplo de date_sunrise()

`<?php
/* calcular la salida del sol para Lisboa, Portugal
Latitud: 38.4 Norte
Longitud: 9 Oeste
Cenit ~= 90
Índice: +1 GMT
*/
echo date("D M d Y"). ', hora de la salida del sol : ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>`

El resultado del ejemplo sería algo similar a:

    Mon Dec 20 2004, hora de la salida del sol : 08:54

### Ver también

- date_sunset() - Devuelve la hora de la puesta de sol de un día y ubicación dados