PHP date_sunset()Fonction

PHP Date/TimeManuel de référence PHP Date/Time

Exemples

Retourne l'heure du coucher du soleil à Lisbonne, Portugal aujourd'hui :

<?php
// Lisbonne, Portugal :
// Latitude : 38.4 Nord, Longitude : 9 Ouest
// Zénith ~= 90, décalage : +1 GMT

echo("Lisbonne, Portugal : Date : " . date("D M d Y"));
echo("<br>Heure du coucher du soleil : ");
echo(date_sunset(time(),SUNFUNCS_RET_STRING,38.4,-9,90,1));
?>

Exécuter l'exemple »

Définition et utilisation

La fonction date_sunset() retourne l'heure du coucher du soleil pour une date et un lieu spécifiés.

Astuce :Voir aussidate_sunrise()fonction, qui retourne l'heure du lever du soleil pour la date et le lieu spécifiés.

Syntaxe

date_sunset(timestamp,format,latitude,longitude,zenith,gmtoffset);

Paramètre Description
timestamp Obligatoire. Spécifie l'horodatage date/heure pour calculer l'heure du coucher du soleil.
format

Optionnel. Spécifie comment renvoyer le résultat :

  • SUNFUNCS_RET_STRING (renvoie le résultat sous forme de chaîne, par ex., 16:46) (par défaut)
  • SUNFUNCS_RET_DOUBLE (renvoie le résultat sous forme de nombre à virgule flottante, par ex. 16.78243132)
  • SUNFUNCS_RET_TIMESTAMP (renvoie le résultat sous forme d'entier (horodatage), par ex. 1095034606)
latitude Facultatif. Spécifie la latitude de l'emplacement. La valeur par défaut est la latitude nord. Par conséquent, pour spécifier une latitude sud, une valeur négative doit être passée.
longitude Facultatif. Spécifie la longitude de l'emplacement. La valeur par défaut est la longitude est. Par conséquent, pour spécifier une longitude ouest, une valeur négative doit être passée.
zenith Facultatif. La valeur par défaut est date.sunset_zenith.
gmtoffset Facultatif. Spécifie la différence entre GMT et l'heure locale, en heures.

Détails techniques

Valeur de retour : En cas de succès, dans leformatspécifié, l'heure du coucher du soleil est retournée. En cas d'échec, FALSE est retourné.
Version de PHP : 5+
Journal des modifications : Depuis PHP 5.1.0, cette fonction signale les erreurs de fuseau horaire E_STRICT et E_NOTICE.

PHP Date/TimeManuel de référence PHP Date/Time Autres extensions