Retourne l'heure de lever du soleil pour un jour et un endroit donnés

# date_sunrise

(PHP 5, PHP 7, PHP 8)

date_sunrise — Retourne l'heure de lever du soleil pour un jour et un endroit donnés

Avertissement

Cette fonction est OBSOLÈTE à partir de PHP 8.1.0. Dépendre de cette fonction est fortement déconseillé. L'utilisation de date_sun_info() est encouragée à la place.

### Description

#[\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() retourne l'heure de lever du soleil pour un jour (spécifié par le paramètre `timestamp`) et un endroit donnés.

### Liste de paramètres

`timestamp`

  Le timestamp Unix du jour pour lequel l'heure de lever du soleil est donnée.

`returnFormat`

  Constantes pour le paramètre `returnFormat`
  Constante | Description | Exemple
  --- | --- | ---
  SUNFUNCS_RET_STRING | Retourne le résultat en tant que chaîne de caractères | 16:46
  SUNFUNCS_RET_DOUBLE | Retourne le résultat en tant que nombre décimal | 16.78243132
  SUNFUNCS_RET_TIMESTAMP | Retourne le résultat en tant qu'entier (timestamp) | 1095034606

`latitude`

  Par défaut, c'est le Nord. Passez une valeur négative pour le Sud. Voir aussi date.default_latitude.

`longitude`

  Par défaut, c'est l'Est. Passez une valeur négative pour l'Ouest. Voir aussi date.default_longitude.

`zenith`

  `zenith` est l'angle entre le centre du soleil et la ligne perpendiculaire à la surface de la terre. Par défaut date.sunrise_zenith

  Valeurs courantes de l'angle `zenith`
  Angle | Description
  --- | ---
  90°50' | Lever du soleil : le point où le soleil devient visible.
  96° | Crépuscule civil : conventionnellement utilisé pour signifier le début de l'aube.
  102° | Crépuscule nautique : le point où l'horizon commence à être visible en mer.
  108° | Crépuscule astronomique : le point où le soleil commence à être la source de toute illumination.

`utcOffset`

  Spécifié en heures. Le `utcOffset` est ignoré si `returnFormat` est `SUNFUNCS_RET_TIMESTAMP`.

### Valeurs de retour

Retourne l'heure de lever du soleil dans le `returnFormat` spécifié en cas de succès ou `false` si une erreur survient. Une raison possible de l'échec est que le soleil ne se lève pas du tout, ce qui arrive à l'intérieur des cercles polaires pendant une partie de l'année.

### Erreurs / Exceptions

Chaque appel à une fonction date/heure générera un diagnostic de type `E_WARNING` si le fuseau horaire n'est pas valide. Voir aussi date_default_timezone_set()

### Historique

Version | Description
--- | ---
8.1.0 | Cette fonction a été rendue obsolète en faveur de date_sun_info().
8.0.0 | `latitude`, `longitude`, `zenith` et `utcOffset` sont désormais nullable.

### Exemples

Exemple #1 Exemple avec date_sunrise()

    <?php

    /* Calcule l'heure du lever du soleil pour Lisbonne, Portugal
    Latitude: 38.4 North
    Longitude: 9 West
    Zenith ~= 90
    offset: +1 GMT
    */

    echo date("D M d Y"). ', sunrise time : ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);

Résultat de l'exemple ci-dessus est similaire à :

    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

Exemple #2 Pas de lever de soleil

    <?php
    $solstice = strtotime('2017-12-21');
    var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));

L'exemple ci-dessus va afficher :

    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)

### Voir aussi

- date_sun_info() - Retourne un tableau avec les informations sur le lever/coucher du soleil ainsi que le début et la fin de l'aube

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