# 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

#[\Deprecated]
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
  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.sunrise_zenith

  Gebräuchliche `zenith`-Winkel
  Winkel | Beschreibung
  --- | ---
  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 `returnFormat` `SUNFUNCS_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

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_sunrise()-Beispiel

`<?php
/* Berechnung der Uhrzeit des Sonnenaufgangs für Lissabon, Portugal
Breitengrad: 38.4 Nord
Längengrad: 9 West
Zenit ~= 90
Zeitverschiebung: +1 GMT
*/
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:

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

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

### Siehe auch

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open