(PHP 5)
date_sunset — Retourne l'heure de coucher du soleil pour un jour et un endroit donnés
$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
]]]]] )
La fonction date_sunset() retourne l'heure de coucher
du soleil pour un jour (spécifié en tant que timestamp
Unix) et un endroit donnés.
timestamp
Le timestamp
Unix du jour pour lequel l'heure du
coucher du soleil est donnée.
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.
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()
Version | Description |
---|---|
5.1.0 |
Émet un message de type |
Retourne l'heure de coucher du soleil dans le format
spécifié ou FALSE
si une erreur survient.
Exemple #1 Exemple avec date_sunset()
<?php
/* Calcul l'heure du coucher 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