Function.localtime

Aus PHP-Wiki

localtime — Ermittelt die lokale Zeit

Beschreibung

array localtime ([ int $timestamp [, bool $is_associative ]] )

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 "tm_min" - Minuten "tm_hour" - Stunde "tm_mday" - Tag des Monats Monate gehen von 0 (Jan) bis 11 (Dez) und Wochentage von 0 (So) bis 6 (Sa). "tm_mon" - Monat des Jahres, beginnt bei 0 für Januar "tm_year" - Jahre seit 1900 "tm_wday" - Tag der Woche "tm_yday" - Tag des Jahres "tm_isdst" - für das Datum ist die Sommerzeit zu berücksichtigen

Fehler/Exceptions

Every call to a date/time function will generate a E_NOTICE if the time zone is not valid, and/or a E_STRICT message if using the system settings or the TZ environment variable. See also date_default_timezone_set()

ChangeLog

Version Beschreibung 5.1.0 Erzeugt nun E_STRICT und E_NOTICE Zeitzohnenfehler.

Beispiele

#1 localtime()

<?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
)