Die Klasse DateInterval
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
Einführung
Repräsentiert eine Zeitspanne.
Eine Zeitspanne wird entweder als feste Zeitspanne (in Jahren, Monaten, Tagen, Stunden etc.) oder als relative Zeitangabe in einem Format dargestellt, das vom Konstruktor der Klassen DateTimeImmutable und DateTime unterstützt wird.
Genauer gesagt ist die Information in einem Objekt der Klasse DateInterval eine Anweisung, um von einem Datum/Zeit-Wert zu einem anderen Datum/Zeit-Wert zu kommen. Dieser Prozess ist nicht immer umkehrbar.
Eine übliche Methode, um ein DateInterval-Objekt zu erzeugen, ist die Berechnung des Unterschieds zwischen zwei Datum/Zeit-Objekten durch DateTimeInterface::diff().
Da es keine eindeutig definierte Möglichkeit gibt, Zeitspannen zu vergleichen, sind DateInterval-Instanzen nicht vergleichbar.
Klassenbeschreibung
Eigenschaften
- y
-
Anzahl der Jahre.
- m
-
Anzahl der Monate.
- d
-
Anzahl der Tage.
- h
-
Anzahl der Stunden.
- i
-
Anzahl der Minuten.
- s
-
Anzahl der Sekunden.
- f
-
Anzahl der Mikrosekunden als Bruchteil einer Sekunde.
- invert
-
Ist
1
, wenn die Zeitspanne negativ ist, und sonst0
. Siehe DateInterval::format(). - days
-
Wenn das DateInterval-Objekt durch DateTimeImmutable::diff() oder DateTime::diff() erstellt wurde, dann enthält diese Eigenschaft die Gesamtanzahl der Tage zwischen dem Start- und Enddatum. Ansonsten enthält days den Wert
false
. - from_string
-
Wenn das DateInterval-Objekt durch DateInterval::createFromDateString() erstellt wurde, dann ist der Wert dieser Eigenschaft
true
und die Eigenschaft date_string wird mit Daten belegt. Andernfalls ist der Wertfalse
und die Eigenschaften y bis f, invert, und Tage werden mit Daten belegt. - date_string
-
Die Zeichenkette, die als Parameter für DateInterval::createFromDateString() verwendet wird.
Changelog
Version | Beschreibung |
---|---|
8.2.0 | Die Eigenschaften from_string und date_string wurden für DateInterval-Instanzen hinzugefügt, die mit der Methode DateInterval::createFromDateString() erstellt wurden. |
7.4.0 | DateInterval-Instanzen sind nun nicht mehr vergleichbar; bisher wurden alle DateInterval-Instanzen als gleich angesehen. |
7.1.0 | Die Eigenschaft f wurde hinzugefügt. |
Inhaltsverzeichnis
- DateInterval::__construct — Erstellt ein neues DateInterval-Objekt
- DateInterval::createFromDateString — Bildet ein DateInterval aus relativen Teilen eines Strings
- DateInterval::format — Formatiert ein Intervall