DatePoint
extends DateTimeImmutable
in package
FinalYes
Момент времени, привязанный к часам приложения (аналог symfony DatePoint).
Отличия от голого DateTimeImmutable:
new DatePoint()берёт «сейчас» из глобальных часов (ClockHolder), поэтому моменты в тестах управляемы без правки кода;- ошибки разбора строк и модификаторов — типизированные исключения пакета
вместо
falseс warning-ом.
Table of Contents
Methods
- __construct() : mixed
- Момент от часов приложения с необязательным модификатором.
- createFromFormat() : static
- Разбор по формату с исключением вместо `false`.
- fromInterface() : static
- Снимок момента из любого источника даты.
- modify() : static
- Сдвиг с типизированным исключением вместо `false` + warning.
Methods
__construct()
Момент от часов приложения с необязательным модификатором.
public
__construct([non-empty-string $datetime = 'now' ][, DateTimeZone|non-empty-string|null $timezone = null ]) : mixed
Parameters
- $datetime : non-empty-string = 'now'
-
«now», строка даты либо модификатор («+1 hour»)
- $timezone : DateTimeZone|non-empty-string|null = null
-
таймзона результата;
null— зона часов/строки
Tags
createFromFormat()
Разбор по формату с исключением вместо `false`.
public
static createFromFormat(string $format, string $datetime[, DateTimeZone|null $timezone = null ]) : static
Parameters
- $format : string
-
формат DateTimeImmutable::createFromFormat()
- $datetime : string
-
входная строка
- $timezone : DateTimeZone|null = null
Tags
Attributes
- #[Override]
Return values
staticfromInterface()
Снимок момента из любого источника даты.
public
static fromInterface(DateTimeInterface $moment) : static
Parameters
- $moment : DateTimeInterface
-
исходный момент времени
Return values
static —точка даты с тем же моментом
modify()
Сдвиг с типизированным исключением вместо `false` + warning.
public
modify(string $modifier) : static
Parameters
- $modifier : string
-
модификатор формата
modify()
Tags
Attributes
- #[Override]