date_sunset

Manuel PHP
Précédent		Suivant

Description

mixed date_sunset ( int timestamp [, int format [, float latitude [, float longitude [, float zenith [, float gmt_offset]]]]] )

date_sunset() retourne l'heure de coucher du soleil pour un jour (spécifié par le paramètre timestamp) et un endroit donnés. Les paramètres latitude, longitude et zenith ont pour valeurs par défaut, respectivement, les valeurs des options de configuration date.default_latitude, date.default_longitude et date.sunrise_zenith.

La valeur par défaut du paramètre latitude est North. Si vous voulez passer une valeur correspondant au Sud, vous devez donc passer une valeur négative. De même pour le paramètre longitude, qui, par défaut, vaut East.

Le paramètre gmt_offset est spécifié en heures.

Tableau 1. Constantes pour le paramètre format

constante	description	exemple
SUNFUNCS_RET_STRING	retourne l'heure de coucher du soleil sous forme de chaîne de caractères	16:46
SUNFUNCS_RET_DOUBLE	retourne le résultat sous la forme d'un nombre à virgule flottante	16.78243132
SUNFUNCS_RET_TIMESTAMP	retourne l'heure de coucher du soleil sous la forme d'un entier (timestamp)	1095034606

Exemple 1. Exemple avec date_sunset()
<?php /* calcul de l'heure de coucher du soleil pour la ville de Lisbonne, Portugal Latitude: 38.4 North Longitude: 9 West Zenith ~= 90 offset: +1 GMT */ echo 'Heure de coucher du soleil pour le ' . date("d/m/Y"). ' : ' .date_sunset(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1); ?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
Heure de coucher du soleil pour le 20/12/2004 : 18:13

Voir aussi date_sunrise().