date_sunrise
(PHP 5, PHP 7)
date_sunrise — Retourne l'heure de lever du soleil pour un jour et un endroit donnés
Description
$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.sunrise_zenith")
[, float $gmt_offset = 0
]]]]] ) : mixed
date_sunrise() retourne l'heure de lever du soleil pour un jour
(spécifié par le paramètre timestamp) et un endroit donnés.
Liste de paramètres
-
timestamp -
Le timestamp Unix du jour pour lequel l'heure de lever du soleil est donnée.
-
format -
Constantes pour le paramètre formatConstante Description Exemple SUNFUNCS_RET_STRING Retourne le résultat en tant que chaîne de caractères 16:46 SUNFUNCS_RET_DOUBLE Retourne le résultat en tant que nombre décimal 16.78243132 SUNFUNCS_RET_TIMESTAMP Retourne le résultat en tant qu'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 -
zenithest l'angle entre le centre du soleil et la ligne perpendiculaire à la surface de la terre. Par défaut date.sunrise_zenithValeurs courantes de l'angle zenithAngle Description 90°50' Levé du soleil: le point où le soleil devient visible. 96° Crépuscule civil: conventionnellement utilisé pour signifier le début de l'aube. 102° Crépuscule nautique: le point où l'horizon commence à être visible en mer. 108° Crépuscule astronomique: le point où le soleil commence à être la source de toute illumination. -
gmtoffset -
Spécifié en heures. Le
gmtoffsetest ignoré siformatestSUNFUNCS_RET_TIMESTAMP.
Valeurs de retour
Retourne l'heure de lever du soleil dans le format
spécifié en cas de succès ou FALSE si une erreur survient.
Une raison possible de l'échec est que le soleil ne se lève
pas du tout, ce qui arrive à l'intérieur des cercles
polaires pendant une partie de l'année.
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()
Historique
| Version | Description |
|---|---|
| 5.1.0 |
Émet un message de type |
Exemples
Exemple #1 Exemple avec date_sunrise()
<?php
/* Calcule l'heure du lever du soleil pour Lisbonne, Portugal
Latitude: 38.4 North
Longitude: 9 West
Zenith ~= 90
offset: +1 GMT
*/
echo date("D M d Y"). ', sunrise time : ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
Mon Dec 20 2004, sunrise time : 08:54
Exemple #2 Pas de levé de soleil
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>
L'exemple ci-dessus va afficher :
bool(false)
Voir aussi
- date_sunset() - Retourne l'heure de coucher 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
Version en cache
21/11/2024 20:13:31 Cette version de la page est en cache (à la date du 21/11/2024 20:13:31) 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-function.date-sunrise.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
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.
