localtime

(PHP 4, PHP 5, PHP 7)

localtime — Ermittelt die lokale Zeit

Beschreibung

localtime ([ int $timestamp = time() [, bool $is_associative = FALSE ]] ) : array

Die localtime()-Funktion 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 integer oder die aktuelle lokale Zeit wenn kein timestamp übergeben wurde. Er entspricht dann also dem Ergebnis der Funktion time().

is_associative

Ist der Wert nicht angegeben oder FALSE, ist das zurückgegebene Array ein normales numerisch indiziertes Array. Hat das Argument den Wert TRUE, gibt localtime() ein assoziatives Array zurück, das alle unterschiedlichen Strukturelemente enthält, die vom Aufruf der C-Funktion localtime zurückgegeben werden. Die Namen der unterschiedlichen Schlüssel des assoziativen Arrays lauten:

  • "tm_sec" - Sekunden, 0 bis 59
  • "tm_min" - Minuten, 0 bis 59
  • "tm_hour" - Stunde, 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" - Ob für das Datum die Sommerzeit zu berücksichtigen ist Positiv wenn Ja, 0 wenn Nein, negativ wenn unbekannt.

Fehler/Exceptions

Jeder Aufruf der Datums- und Zeitfunktionen generiert eine E_NOTICE-Warnung, wenn die Zeitzone ungültig ist und eine E_STRICT-Nachricht oder eine E_WARNING-Warnung, wenn die Systemeinstellung oder die TZ-Umgebungsvariable genutzt wird. Siehe auch date_default_timezone_set()

Changelog

Version Beschreibung
5.1.0

Erzeugt nun E_STRICT- und E_NOTICE-Zeitzonenfehler.

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
)

Siehe auch

  • getdate() - Gibt Datums- und Zeitinformationen zurück