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

# 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]
function 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

- date_sun_info() - Retorna un array con las informaciones sobre el amanecer/atardecer así como el inicio y el fin del amanecer

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open