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

# date_sunrise

(PHP 5, PHP 7)

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

### Description

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() 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.

`format`

  Constantes pour le paramètre `format`
  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' | Levé 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.

`gmtoffset`

  Spécifié en heures. Le `gmtoffset` est ignoré si `format` est `SUNFUNCS_RET_TIMESTAMP`.

### Valeurs de retour

Retourne l'heure de lever du soleil dans le `format` 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 message de type `E_NOTICE` si le fuseau horaire n'est pas valide, et/ou un message de type `E_STRICT` ou `E_WARNING` si vous utilisez la configuration du système ou la variable d'environnement TZ. Voir aussi date_default_timezone_set()

### Historique

Version | Description
--- | ---
5.1.0 | Émet un message de type `E_STRICT` et `E_NOTICE` lors d'erreurs de fuseaux horaires.

### 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);
?>`

L'exemple ci-dessus va afficher quelque chose de similaire à :

    Mon Dec 20 2004, sunrise time : 08:54

Exemple #2 Pas de levé 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 :

    bool(false)

### Voir aussi

- date_sunset() - Retourne l'heure de coucher du soleil pour un jour et un endroit donnés
- 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