Manuel PHP
Précédent |  | Suivant

# date_sunset

(PHP 5)

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

## Description

mixed date_sunset ( int timestamp [, int format [, float latitude [, float longitude [, float zenith [, float gmt_offset]]]]] )

date_sunset() retourne l'heure de couché du soleil pour un jour (spécifié en tant que timestamp Unix) et un endroit donnés.

## Liste de paramètres

timestamp

  Le timestamp Unix du jour pour lequel l'heure du couché du soleil est donnée.

format

  Tableau 1. 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 à virgule flottante | 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

  Par défaut : date.sunrise_zenith

gmtoffset

  Spécifié en heures.

## Valeurs de retour

Retourne l'heure de couché du soleil dans un format spécifié, `FALSE` en cas d'échec.

## 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` 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 `E_STRICT` et `E_NOTICE` lors d'erreurs de fuseaux horaires.

## Exemples

Exemple 1. Exemple avec date_sunset()

`<?php /* Calcul l'heure du couché 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_STRING, 38.4, -9, 90, 1); ?>`

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

    Mon Dec 20 2004, sunset time : 18:13

## Voir aussi

date_sunrise()

Précédent | Sommaire | Suivant
date_sunrise | Niveau supérieur | date