date_sunrise

    (PHP 5, PHP 7, PHP 8)

    date_sunrise — Liefert die Uhrzeit des Sonnenaufgangs 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

    date_sunrise(
        int$timestamp,
        int$returnFormat = SUNFUNCS_RET_STRING,
        ?float$latitude = null,
        ?float$longitude = null,
        ?float$zenith = null,
        ?float$utcOffset = null
    ): string|int|float|false

    date_sunrise() gibt die Uhrzeit des Sonnenaufgangs 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 Sonnenaufgangs ermittelt wird.

    returnFormat

    returnFormat-Konstanten
    KonstanteBeschreibungBeispiel
    SUNFUNCS_RET_STRINGGibt das Ergebnis als String zurück16:46
    SUNFUNCS_RET_DOUBLEGibt das Ergebnis als Float zurück16.78243132
    SUNFUNCS_RET_TIMESTAMPGibt 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.sunrise_zenith

    Gebräuchliche zenith-Winkel
    WinkelBeschreibung
    90°50'Sonnenaufgang: der Punkt, an dem die Sonne sichtbar wird.
    96°Bürgerliche Dämmerung: wird üblicherweise verwendet, um den Beginn der Morgendämmerung zu kennzeichnen.
    102°Nautische Dämmerung: der Punkt, an dem der Horizont auf See sichtbar wird.
    108°Astronomische Dämmerung: Der Punkt, an dem die Sonne beginnt, die Quelle von Licht zu sein.
    utcOffset

    Wird in Stunden angegeben. Wenn returnFormatSUNFUNCS_RET_TIMESTAMP ist, wird utcOffset ignoriert.

    Rückgabewerte

    Gibt bei Erfolg die Uhrzeit des Sonnenaufgangs 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 aufgeht, 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

    VersionBeschreibung
    8.1.0 Diese Funktion ist veraltet und wurde durch date_sun_info() ersetzt.
    8.0.0latitude, longitude, zenith und utcOffset sind nun nullable (akzeptieren den null-Wert).

    Beispiele

    Beispiel #1 date_sunrise()-Beispiel

    <?php



    echo date("D M d Y"). ', sunrise time : ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);

    ?>

    Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

    Mon Dec 20 2004, sunrise time : 08:54

    Beispiel #2 Kein Sonnenaufgang

    <?php
    $solstice     = strtotime('2017-12-21');
    var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    bool(false)

    Siehe auch

    • date_sun_info() - Liefert ein Array mit Informationen über Sonnenauf- und -untergang sowie Beginn und Ende der Dämmerung
    To Top