array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.date-sunset.php', 1 => 'date_sunset', 2 => 'Liefert die Uhrzeit des Sonnenuntergangs für den angegebenen Tag und Ort', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Datum/Uhrzeit-Funktionen', ), 'prev' => array ( 0 => 'function.date-sunrise.php', 1 => 'date_sunrise', ), 'next' => array ( 0 => 'function.date-time-set.php', 1 => 'date_time_set', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/datetime/functions/date-sunset.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

date_sunset

(PHP 5, PHP 7, PHP 8)

date_sunset — Liefert die Uhrzeit des Sonnenuntergangs für den angegebenen Tag und Ort

Warnung

Diese Funktion ist seit PHP 8.1.0 als DEPRECATED (veraltet) markiert. Von der Verwendung dieser Funktion wird dringend abgeraten. Stattdessen sollte date_sun_info() verwendet werden.

Beschreibung

#[\Deprecated]
date_sunset(
    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-Konstanten
Konstante 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_zenith
Gebräuchliche zenith-Winkel
Winkel 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, wird utcOffset 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

Wenn die Zeitzone ungültig ist, wird bei jedem Aufruf einer Datums/Zeit-Funktion ein Fehler der Stufe E_WARNING erzeugt. 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:

Deprecated: Constant SUNFUNCS_RET_STRING is deprecated in script on line 10
Deprecated: Function date_sunset() is deprecated since 8.1, use date_sun_info() instead in script on line 10
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:

Deprecated: Constant SUNFUNCS_RET_STRING is deprecated in script on line 3
Deprecated: Function date_sunset() is deprecated since 8.1, use date_sun_info() instead in script on line 3
bool(false)

Siehe auch