Rechercher une fonction PHP

date_sun_info

(PHP 5 >= 5.1.2, PHP 7)

date_sun_infoRetourne un tableau avec les informations sur le lever/coucher du soleil ainsi que le début et la fin de l'aube

Description

date_sun_info ( int $time , float $latitude , float $longitude ) : array

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

Liste de paramètres

time

Timestamp.

latitude

Latitude, en degrés.

longitude

Longitude, en degrés.

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

Valeurs de retour

Retourne un tableau en cas de succès ou FALSE si une erreur survient. La structure du tableau est détaillé dans la liste suivante :

sunrise
L'heure du levé du soleil (angle de zenith = 90°35').
sunset
L'heure du coucher du soleil (angle de zenith = 90°35').
transit
Le moment où le soleil est à son zénith, c'est-à-dire a atteint son point le plus haut.
civil_twilight_begin
Le début de l'aube civile (angle de zenith = 96°). Il termine au sunrise.
civil_twilight_end
La fin du crépuscule civil (angle de zenith = 96°). Elle commence au sunset.
nautical_twilight_begin
Le début de l'aube nautique (angle de zenith = 102°). Il termine au civil_twilight_begin.
nautical_twilight_end
La fin du crépuscule nautique (angle de zenith = 102°). Elle commence a civil_twilight_end.
astronomical_twilight_begin
Le début de l'aube astronomique (angle de zenith = 108°). Il termine au nautical_twilight_begin.
astronomical_twilight_end
La fin du crépuscule astronomique (angle de zenith = 108°). Elle commence a nautical_twilight_end.

Les valeurs des éléments du tableau sont soit des timestamps UNIX, FALSE, si le soleil est sous le zenith respectif pour la journée entière, ou TRUE, si le soleil est au dessus du zenith respectif pour toute la journée.

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

Historique

Version Description
5.2.2 L'ordre de latitude et longitude ont été échangés.

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

Exemples

Exemple #1 Exemple avec date_sun_info()

<?php
$sun_info 
date_sun_info(strtotime("2006-12-12"), 31.766735.2333);
foreach (
$sun_info as $key => $val) {
  echo 
"$key: " date("H:i:s"$val) . "\n";
}
?>

L'exemple ci-dessus va afficher :

sunrise: 05:52:11
sunset: 15:41:21
transit: 10:46:46
civil_twilight_begin: 05:24:08
civil_twilight_end: 16:09:24
nautical_twilight_begin: 04:52:25
nautical_twilight_end: 16:41:06
astronomical_twilight_begin: 04:21:32
astronomical_twilight_end: 17:12:00

Exemple #2 Nuit polaire

<?php
var_dump
(date_sun_info(strtotime("2017-12-21"), 900));
?>

L'exemple ci-dessus va afficher :

array(9) {
  ["sunrise"]=>
  bool(false)
  ["sunset"]=>
  bool(false)
  ["transit"]=>
  int(1513857490)
  ["civil_twilight_begin"]=>
  bool(false)
  ["civil_twilight_end"]=>
  bool(false)
  ["nautical_twilight_begin"]=>
  bool(false)
  ["nautical_twilight_end"]=>
  bool(false)
  ["astronomical_twilight_begin"]=>
  bool(false)
  ["astronomical_twilight_end"]=>
  bool(false)
}

Exemple #3 Soleil de minuit

<?php
var_dump
(date_sun_info(strtotime("2017-06-21"), 900));
?>

L'exemple ci-dessus va afficher :

array(9) {
  ["sunrise"]=>
  bool(true)
  ["sunset"]=>
  bool(true)
  ["transit"]=>
  int(1498046510)
  ["civil_twilight_begin"]=>
  bool(true)
  ["civil_twilight_end"]=>
  bool(true)
  ["nautical_twilight_begin"]=>
  bool(true)
  ["nautical_twilight_end"]=>
  bool(true)
  ["astronomical_twilight_begin"]=>
  bool(true)
  ["astronomical_twilight_end"]=>
  bool(true)
}

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_sunset() - Retourne l'heure de coucher du soleil pour un jour et un endroit donnés

Rechercher une fonction PHP

Version en cache

25/11/2024 19:44:16 Cette version de la page est en cache (à la date du 25/11/2024 19:44:16) 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-sun-info.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