date_sunset()

Einführung

Willkommen zu unserem umfassenden Leitfaden zur PHP-Funktion date_sunset(). In diesem Leitfaden behandeln wir alle Aspekte von date_sunset() und ihre Verwendung. Unser Ziel ist es, Ihnen möglichst ausführliche und hilfreiche Informationen zu bieten, damit Sie besser verstehen, wie Sie diese Funktion in Ihren PHP-Projekten einsetzen.

Hinweis: date_sunset() wurde in PHP 8.0 als veraltet markiert und in PHP 8.1 entfernt. Für moderne PHP-Anwendungen sollten Sie die DateTime-Klasse mit Zeitzonenberechnungen oder externe Wetter-APIs in Betracht ziehen.

Was ist die PHP-Funktion Date Sunset?

Die PHP-Funktion date_sunset() ist eine integrierte Funktion, die die Sonnenuntergangszeit für ein bestimmtes Datum und einen bestimmten Ort zurückgibt. Diese Funktion berechnet die Sonnenuntergangszeit anhand des angegebenen Datums, des Breitengrads und Längengrads des Standorts sowie des Zenits. Der Zenit ist der Winkel, gemessen von der Vertikalen (gerade nach oben). Der Standardwert 90.83 berücksichtigt atmosphärische Refraktion und die zivile Dämmerung.

Die Funktion date_sunset() gibt die Sonnenuntergangszeit im Unix-Zeitstempel-Format zurück, also als Anzahl der Sekunden seit dem 1. Januar 1970. Dieses Format ist nützlich, da es sich mit anderen PHP-Datums- und Zeitfunktionen leicht in andere Datums- und Zeitformate umwandeln lässt.

Syntax der PHP-Funktion Date Sunset

Die Syntax der PHP-Funktion date_sunset() lautet wie folgt:

Syntax der PHP-Funktion Date Sunset

date_sunset ( time [, format [, latitude [, longitude [, zenith [, gmt_offset ]]]]] )

Parameter:

• time: Der Unix-Zeitstempel, der das Datum darstellt, für das die Sonnenuntergangszeit berechnet werden soll. Wenn dieser Parameter nicht angegeben wird, wird die aktuelle Zeit verwendet.
• format: Das Format, in dem die Sonnenuntergangszeit zurückgegeben werden soll. Dieser Parameter ist optional und hat standardmäßig den Wert "H:i".
• latitude: Der Breitengrad des Standorts, für den die Sonnenuntergangszeit berechnet werden soll. Dieser Parameter ist optional und hat standardmäßig den Wert 0.
• longitude: Der Längengrad des Standorts, für den die Sonnenuntergangszeit berechnet werden soll. Dieser Parameter ist optional und hat standardmäßig den Wert 0.
• zenith: Der Zenitwinkel, für den die Sonnenuntergangszeit berechnet werden soll. Dieser Parameter ist optional und hat standardmäßig den Wert 90.83, was dem Zenit für die zivile Dämmerung entspricht.
• gmt_offset: Der GMT-Offset für den Standort, für den die Sonnenuntergangszeit berechnet werden soll. Dieser Parameter ist optional und hat standardmäßig den Wert 0.

Beispielverwendung der PHP-Funktion Date Sunset

Das folgende Beispiel demonstriert die Funktion für ältere PHP-Umgebungen (PHP 7.x und früher):

Beispielverwendung der PHP-Funktion Date Sunset

<‌?php
date_default_timezone_set('UTC');
$date = strtotime("2023-03-03");
$sunset_time = date_sunset($date, SUNFUNCS_RET_TIMESTAMP, 37.7749, -122.4194, 90.83);
echo "The sunset time on March 3, 2023, in San Francisco is ".date("H:i", $sunset_time);
?>

Try it Yourself »

Ausgabe:

---

The sunset time on March 3, 2023, in San Francisco is 18:12

Migration zu modernem PHP

Da date_sunset() in PHP 8.1 entfernt wurde, sollten moderne Anwendungen zu einer spezialisierten astronomischen Bibliothek oder einer externen API migrieren. Die integrierte DateTime-Klasse von PHP verarbeitet Zeitzonen und Formatierung, berechnet jedoch keine Sonnenpositionen. Für eine eigenständige Lösung verwenden Sie ein Composer-Paket wie sunrise-sunset oder geo-sun. Alternativ können Sie eine zuverlässige Sunrise/Sunset-API abfragen und die Antwort parsen.

Beispiel für ein Migrationsmuster mit einer spezialisierten Bibliothek:

// Requires: composer require sunrise-sunset/sunrise-sunset
use SunriseSunset\SunriseSunset;
use SunriseSunset\Location;

$location = new Location(37.7749, -122.4194);
$date = new DateTime('2023-03-03', new DateTimeZone('UTC'));
$sun = new SunriseSunset($location, $date);

echo "Sunset: " . $sun->getSunset()->format('H:i');

Wie Sie die PHP-Funktion Date Sunset in Ihren Projekten verwenden

Die PHP-Funktion date_sunset() ist ein leistungsstarkes Werkzeug, das in einer Vielzahl von PHP-Projekten eingesetzt werden kann. Hier sind einige Beispiele, wie sie verwendet werden kann:

1. Wetter-Apps: Wenn Sie eine Wetter-App entwickeln, können Sie die PHP-Funktion date_sunset() verwenden, um die Sonnenuntergangszeit für einen bestimmten Ort anzuzeigen.
2. Foto-Apps: Wenn Sie eine Foto-App entwickeln, können Sie die PHP-Funktion date_sunset() verwenden, um die „goldene Stunde“ für einen bestimmten Ort zu berechnen. Die „goldene Stunde“ ist der Zeitraum kurz nach Sonnenaufgang oder kurz vor Sonnenuntergang, in dem das Licht für die Fotografie optimal ist.
3. Event-Apps: Wenn Sie eine Event-App entwickeln, können Sie die PHP-Funktion date_sunset() verwenden, um die Sonnenuntergangszeit für ein bestimmtes Datum und einen bestimmten Ort anzuzeigen. Dies kann für Veranstaltungen im Freien nützlich sein, die bei Sonnenuntergang enden sollen.

Fazit

Obwohl date_sunset() in älteren PHP-Versionen seinen Zweck erfüllt hat, setzt die moderne Entwicklung für genaue Berechnungen der Sonnenposition auf spezialisierte astronomische Bibliotheken oder externe APIs. Die Migration zu diesen Ansätzen gewährleistet die Kompatibilität mit PHP 8.1+ und liefert zuverlässigere Ergebnisse für Wetter-, Foto- und Event-Anwendungen.

Übung

Was macht die date_sunset-Funktion in PHP?

Sie gibt die Sonnenuntergangszeit für einen angegebenen Tag und Ort zurück.Sie gibt die Sonnenaufgangszeit für einen angegebenen Tag und Ort zurück.Sie berechnet die Differenz zwischen zwei Datumsangaben.Sie formatiert ein lokales Datum und eine Uhrzeit und gibt den formatierten String zurück.Sie liefert eine textuelle Darstellung eines Tages, die sich zum Ausdrucken eignet.