localtime

(PHP 4, PHP 5, PHP 7, PHP 8)

localtime — Ermittelt die lokale Zeit

Beschreibung

localtime(?int $timestamp = null, bool $associative = false): array

Die Funktion localtime() gibt ein Array zurück, welches hinsichtlich seiner Struktur identisch ist mit der des Funktionsaufrufs in C.

Parameter-Liste

timestamp: Der optionale Parameter timestamp ist ein Unix-Timestamp als int oder die aktuelle lokale Zeit, wenn timestamp nicht übergeben wurde oder null ist. Er entspricht dann also dem Ergebnis der Funktion time().
associative: Bestimmt, ob die Funktion ein gewöhnliches numerisch indiziertes Array zurückgeben soll, oder ein assoziatives.

Rückgabewerte

Ist associative nicht angegeben oder false, ist das zurückgegebene Array ein gewöhnliches numerisch indiziertes Array. Hat associative den Wert true, gibt localtime() ein assoziatives Array zurück, das die Strukturelemente enthält, die beim Aufruf der C-Funktion an localtime zurückgegeben werden. Die Namen der Schlüssel des assoziativen Arrays lauten:

"tm_sec" - Sekunden, 0 bis 59
"tm_min" - Minuten, 0 bis 59
"tm_hour" - Stunden, 0 bis 23
"tm_mday" - Tag des Monats, 1 bis 31
"tm_mon" - Monat des Jahres, 0 (Jan) bis 11 (Dez)
"tm_year" - Jahre seit 1900
"tm_wday" - Tag der Woche, 0 (Son) bis 6 (Sam)
"tm_yday" - Tag des Jahres, 0 bis 365
"tm_isdst" - ist für das Datum die Sommerzeit zu berücksichtigen? Positiv wenn ja, 0 wenn nein, negativ wenn unbekannt.

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.0.0	`timestamp` ist nun nullable (akzeptiert den `null`-Wert).

Beispiele

Beispiel #1 localtime()-Beispiel


<?php
$localtime = localtime();
$localtime_assoc = localtime(time(), true);
print_r($localtime);
print_r($localtime_assoc);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Array
(
    [0] => 24
    [1] => 3
    [2] => 19
    [3] => 3
    [4] => 3
    [5] => 105
    [6] => 0
    [7] => 92
    [8] => 1
)

Array
(
    [tm_sec] => 24
    [tm_min] => 3
    [tm_hour] => 19
    [tm_mday] => 3
    [tm_mon] => 3
    [tm_year] => 105
    [tm_wday] => 0
    [tm_yday] => 92
    [tm_isdst] => 1
)