date_sunset
(PHP 5, PHP 7, PHP 8)
date_sunset — Liefert die Uhrzeit des Sonnenuntergangs für den angegebenen Tag und Ort
Diese Funktion ist seit PHP 8.1.0 DEPRECATED (veraltet). Von der Verwendung dieser Funktion wird dringend abgeraten.
Beschreibung
int
$timestamp
,int
$returnFormat
= SUNFUNCS_RET_STRING
,?float
$latitude
= null
,?float
$longitude
= null
,?float
$zenith
= null
,?float
$utcOffset
= null
): string|int|float|false
date_sunset() gibt die Uhrzeit des Sonnenuntergangs für
den angegebenen Tag (angegeben als timestamp
) und
Ort zurück.
Parameter-Liste
-
timestamp
-
Der Zeitstempel des Tages, für den die Uhrzeit des Sonnenuntergangs ermittelt wird.
-
returnFormat
-
returnFormat
-KonstantenKonstante Beschreibung Beispiel SUNFUNCS_RET_STRING Gibt das Ergebnis als String zurück 16:46 SUNFUNCS_RET_DOUBLE Gibt das Ergebnis als Float zurück 16.78243132 SUNFUNCS_RET_TIMESTAMP Gibt das Ergebnis als Int zurück (Zeitstempel) 1095034606 -
latitude
-
Voreingestellt ist Nord, für Süd muss ein negativer Wert übergeben werden. Siehe auch: date.default_latitude
-
longitude
-
Voreingestellt ist Ost, für West muss ein negativer Wert übergeben werden. Siehe auch: date.default_longitude
-
zenith
-
zenith
ist der Winkel zwischen dem Mittelpunkt der Sonne und einer Linie senkrecht zur Erdoberfläche. Voreingestellt ist date.sunset_zenithGebräuchliche zenith
-WinkelWinkel Beschreibung 90°50' Sonnenuntergang: der Punkt, an dem die Sonne aus dem Blickfeld verschwindet. 96° Bürgerliche Dämmerung: wird üblicherweise verwendet, um das Ende der Abenddämmerung zu kennzeichnen. 102° Nautische Dämmerung: der Punkt, an dem der Horizont auf See nicht mehr sichtbar ist. 108° Astronomische Dämmerung: Der Punkt, an dem die Sonne aufhört, die Quelle von Licht zu sein. -
utcOffset
-
Wird in Stunden angegeben. Wenn
returnFormat
SUNFUNCS_RET_TIMESTAMP
ist, wirdutcOffset
ignoriert.
Rückgabewerte
Gibt bei Erfolg die Uhrzeit des Sonnenuntergangs im angegebenen
returnFormat
zurück. Bei einem Fehler wird false
zurückgegeben. Ein
möglicher Grund für einen Fehler ist, dass die Sonne überhaupt nicht
untergeht, was innerhalb der Polargebiete während eines Teils des Jahres
der Fall ist.
Fehler/Exceptions
Jeder Aufruf der Datums- und Zeitfunktionen generiert einen Fehler der Stufe
E_WARNING
, wenn die Zeitzone ungültig ist. Siehe auch
date_default_timezone_set()
Changelog
Version | Beschreibung |
---|---|
8.1.0 | Diese Funktion ist veraltet und wurde durch date_sun_info() ersetzt. |
8.0.0 |
latitude , longitude ,
zenith und utcOffset
sind nun nullable (akzeptieren den null -Wert).
|
Beispiele
Beispiel #1 date_sunset()-Beispiel
<?php
/* Berechnung der Uhrzeit des Sonnenuntergangs für Lissabon, Portugal
Breitengrad: 38.4 Nord
Längengrad: 9 West
Zenit ~= 90
Zeitverschiebung: +1 GMT
*/
echo date("D M d Y"). ', sunset time : ' .date_sunset(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Mon Dec 20 2004, sunset time : 18:13
Beispiel #2 Kein Sonnenuntergang
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunset($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
bool(false)
Siehe auch
- date_sunrise() - Liefert die Uhrzeit des Sonnenaufgangs für den angegebenen Tag und Ort
- date_sun_info() - Liefert ein Array mit Informationen über Sonnenauf- und -untergang sowie Beginn und Ende der Dämmerung