DateInterval

&reftitle.intro; Reprezentuje interwał daty. Interwał daty przechowuje albo stałą ilość czasu (w latach, miesiącach, dniach, godzinach itd.) lub względny ciąg czasu w formacie obsługiwanym przez konstruktory DateTimeImmutable i DateTime. Mówiąc dokładniej, informacja w obiekcie klasy DateInterval jest instrukcją przejścia z jednej daty/godziny do innej daty/godziny. Ten proces nie zawsze jest odwracalny. Powszechnym sposobem tworzenia obiektu DateInterval jest obliczanie różnicy między dwoma obiektami daty/czasu poprzez DateTimeInterface::diff. Ponieważ nie ma dobrze zdefiniowanego sposobu porównywania interwałów dat, instancje DateInterval są nieporównywalne.

&reftitle.classsynopsis; DateInterval &Properties; public int y public int m public int d public int h public int i public int s public float f public int invert public mixed days public bool from_string public string date_string &Methods;

&reftitle.properties; Dostępne właściwości wymienione poniżej zależą od wersji PHP i należy je traktować jako tylko do odczytu. y Liczba lat. m Liczba miesięcy. d Liczba dni. h Liczba godzin. i Liczba minut. s Liczba sekund. f Liczba mikrosekund jako ułamek sekundy. invert Wynosi 1, jeśli interwał reprezentuje ujemny okres czasu i 0 w przeciwnym razie. Zobacz DateInterval::format. days Jeśli obiekt DateInterval został utworzony przez DateTimeImmutable::diff lub DateTime::diff, to jest to całkowita liczba pełnych dni między datą początkową i końcową. W przeciwnym razie, days będzie miał wartość &false;. from_string Jeśli obiekt DateInterval został utworzony przez DateInterval::createFromDateString, to wartość tej właściwości będzie wynosić &true;, a właściwość date_string zostanie wypełniona. W przeciwnym razie, wartość będzie wynosić &false;, a właściwości y do f, invert, i days zostaną wypełnione. date_string Ciąg znaków używany jako argument dla DateInterval::createFromDateString.

&reftitle.changelog; &Version; &Description; 8.2.0 właściwości from_string i date_string zostały dodane dla instancji DateInterval utworzonych przy użyciu metody DateInterval::createFromDateString. 8.2.0 Widoczne będą tylko właściwości y to f, invert, and days. 7.4.0 Instancje DateInterval są teraz nieporównywalne; wcześniej wszystkie instancje DateInterval były uważane za równe. 7.1.0 Właściwość f została dodana.

&reference.datetime.entities.dateinterval;