Rechercher une fonction PHP

date_sunset

(PHP 5, PHP 7)

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

Description

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 ]]]]] ) : mixed

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.

Retour à la première page de Manuel PHP  Table des matières Haut

Liste de paramètres

timestamp

Le timestamp Unix du jour pour lequel l'heure du coucher 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

zenith est l'angle entre le centre du soleil et la ligne perpendiculaire à la surface de la terre. Par défaut date.sunset_zenith

Valeurs communes d'angle zenith
Angle Description
90°50' Coucher du soleil: Le point où le soleil devient invisible.
96° Crépuscule civil: conventionnellement utilisé pour signifier la fin du crépuscule.
102° Crépuscule nautique: le point de fin de l'horizon étant visible en mer.
108° Crépuscule astronomique: le point où le soleil finit d'être la source de toute illumination.

gmtoffset

Spécifié en heures. Le gmtoffset est ignoré, si format est SUNFUNCS_RET_TIMESTAMP.

Retour à la première page de Manuel PHP  Table des matières Haut

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()

Retour à la première page de Manuel PHP  Table des matières Haut

Historique

Version Description
5.1.0

Émet un message de type E_STRICT et E_NOTICE lors d'erreurs de fuseaux horaires.

Retour à la première page de Manuel PHP  Table des matières Haut

Valeurs de retour

Retourne l'heure de coucher du soleil dans le format spécifié ou FALSE si une erreur survient. Une raison possible de l'échec est que le     le soleil ne se couche pas, ce qui se passe à l'intérieur des cercles polaires pour une partie de l'année.

Retour à la première page de Manuel PHP  Table des matières Haut

Exemples

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_STRING38.4, -9901);

?>

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

Mon Dec 20 2004, sunset time : 18:13

Exemple #2 Pas de coucher du soleil

<?php
$solstice 
strtotime('2017-12-21');
var_dump(date_sunset($solsticeSUNFUNCS_RET_STRING69.245833, -53.537222));
?>

L'exemple ci-dessus va afficher :

bool(false)

Retour à la première page de Manuel PHP  Table des matières Haut

Voir aussi

  • date_sunrise() - Retourne l'heure de lever du soleil pour un jour et un endroit donnés
  • date_sun_info() - Retourne un tableau avec les informations sur le lever/coucher du soleil ainsi que le début et la fin de l'aube

Rechercher une fonction PHP

Version en cache

23/12/2024 05:36:58 Cette version de la page est en cache (à la date du 23/12/2024 05:36:58) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-date-sunset.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut