date_sunrise
date_time_set
Fonctions Date/Heure
PHP Manual

# date_sunset

(PHP 5)

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

### Description

mixed date_sunset ( 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.sunset_zenith") [, float `$gmt_offset` = 0 ]]]]] )

date_sunset() retourne l'heure de couché du soleil pour un jour (spécifié en tant que `timestamp` Unix) et un endroit donnés.

### Liste de paramètres

`timestamp`

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

`format`

  Constantes pour le paramètre `format`
  Constante | Description | Exemple
  --- | --- | ---
  SUNFUNCS_RET_STRING | Retourne le résultat sous la forme d'une chaîne de caractères | 16:46
  SUNFUNCS_RET_DOUBLE | Retourne le résultat sous la forme d'un nombre décimal | 16.78243132
  SUNFUNCS_RET_TIMESTAMP | Retourne le résultat sous la forme d'un 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`

  Par défaut : date.sunrise_zenith

`gmtoffset`

  Spécifié en heures.

### 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.

### Valeurs de retour

Retourne l'heure de couché du soleil dans un `format` spécifié ou `FALSE` si une erreur survient.

### Exemples

Exemple #1 Exemple avec date_sunset()

`<?php
/* Calcul l'heure du couché du soleil pour Lisbonne, Portugal
Latitude: 38.4 North
Longitude: 9 West
Zenith ~= 90
offset: +1 GMT
*/
echo date("D M d Y"). ', sunset time : ' .date_sunset(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>`

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

    Mon Dec 20 2004, sunset time : 18:13

### Voir aussi

- date_sunrise() - Retourne l'heure de levé du soleil pour un jour et un endroit donnés

date_sunrise
date_time_set
Fonctions Date/Heure
PHP Manual