(PHP 5, PHP 7)
date_sunrise — Retourne l'heure de lever du soleil pour un jour et un endroit donnés
$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
]]]]] )
date_sunrise() retourne l'heure de lever du soleil pour un jour
(spécifié par le paramètre timestamp) et un endroit donnés.
timestampLe timestamp Unix du jour pour lequel l'heure de lever du soleil est donnée.
format
| Constante | 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 |
latitudePar défaut, c'est le Nord. Passez une valeur négative pour le Sud. Voir aussi date.default_latitude.
longitudePar 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.sunrise_zenith
| Angle | 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 gmtoffset est ignoré si
format est
SUNFUNCS_RET_TIMESTAMP.
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.
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()
| Version | Description |
|---|---|
| 5.1.0 |
Émet un message de type |
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)