Funktion date

Die Funktion date gibt ein Datum in einem bestimmten Format aus. Der erste Parameter ist das Format, der zweite optionale Parameter - der Zeitpunkt im Timestamp-Format. Wenn der zweite Parameter nicht angegeben ist, wird der aktuelle Zeitpunkt verwendet, falls angegeben - der angegebene.

Das Format wird durch Steuerbefehle (englische Buchstaben) festgelegt, wobei beliebige Trennzeichen zwischen ihnen eingefügt werden können (Bindestriche, Doppelpunkt usw.).

Die Funktion akzeptiert die folgenden Befehle (Großbuchstaben unterscheiden sich von Kleinbuchstaben, bitte beachten):

Syntax

phpdate(string $format, ?int $timestamp = null): string

Beispiele für die Arbeit mit date

php<?php
  // Alle Beispiele gelten für das Datum 01.06.2013 um 12:23:59, Montag
  
  echo date('Y'); // gibt '2013' aus
  echo date('y'); // gibt '13' aus
  echo date('m'); // gibt '06' aus - Monatsnummer
  echo date('d'); // gibt '01' aus - Tag des Monats
  echo date('j'); // gibt '1'  aus - Tag des Monats (ohne vorangestellte Null)
  echo date('w'); // gibt '1'  aus - Montag
  echo date('H'); // gibt '12' aus - Stunden
  echo date('i'); // gibt '23' aus - Minuten
  echo date('s'); // gibt '59' aus - Sekunden
  
  echo date('d-m-Y'); // gibt '01-06-2013' aus
  echo date('d.m.Y'); // gibt '01.06.2013' aus
  echo date('H:i:s d.m.Y'); // gibt '12:23:59 01.06.2013' aus
?>

Zweiter Parameter der Funktion date

Die Funktion date hat einen zweiten optionalen Parameter, der einen Zeitpunkt im Timestamp-Format akzeptiert. Wenn dieser Parameter übergeben wird, formatiert die Funktion date nicht den aktuellen Zeitpunkt, sondern den, der als zweiter Parameter übergeben wurde. Diesen timestamp kann man z.B. mit mktime erhalten (muss aber nicht):

php<?php
  echo date('d-m-Y', mktime(0, 0, 0, 12, 29, 13)); // gibt '29-12-2013' aus
?>

Dies kann genutzt werden, um den Wochentag für ein bestimmtes Datum herauszufinden - einfach das Datum als zweiten Parameter mit der Funktion mktime übergeben und als ersten Parameter das Steuerzeichen 'w' setzen:

php<?php
  // Welcher Wochentag war der 29.12.2013:
  echo date('w', mktime(0, 0, 0, 12, 29, 13)); // gibt '0' aus - Sonntag
?>

Siehe auch

  • die Funktion mktime,
    die einen Zeitpunkt im Timestamp-Format zurückgibt