Fonction date_sunset()

❮ Référence PHP Date/Heure

Exemple

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

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

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

Définition et Utilisation

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

Remarque : Cette fonction a été dépréciée dans PHP 8.1.0.

Astuce : Utilisez la fonction date_sun_info() à la place.


Syntaxe

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

Valeurs des Paramètres

Paramètre Description
timestamp Requis. Spécifie le timestamp du jour à partir duquel l'heure du coucher de soleil est calculée.
format

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

  • SUNFUNCS_RET_STRING (retourne le résultat sous forme de chaîne, par ex. 16:46) (C'est par défaut)
  • SUNFUNCS_RET_DOUBLE (retourne le résultat sous forme de flottant, par ex. 16.78243132)
  • SUNFUNCS_RET_TIMESTAMP (retourne le résultat sous forme d'entier (timestamp), par ex. 1095034606)
latitude Optionnel. Spécifie la latitude de l'emplacement. Par défaut, elle est au Nord. Pour spécifier une valeur pour le Sud, passez une valeur négative.
longitude Optionnel. Spécifie la longitude de l'emplacement. Par défaut, elle est à l'Est. Pour spécifier une valeur pour l'Ouest, passez une valeur négative.
zenith Optionnel. Par défaut, il est à date.sunset_zenith.
gmtoffset Optionnel. Spécifie la différence entre GMT et l'heure locale en heures.


Détails Techniques

Valeur de Retour : Retourne l'heure du coucher de soleil, dans le format spécifié, en cas de succès. FALSE en cas d'échec.
Version PHP : 5+
Journal des Modifications : À partir de PHP 5.1.0, cette fonction génère des erreurs de fuseau horaire E_STRICT et E_NOTICE.

❮ Référence PHP Date/Heure