Calendar
extends AbstractProvider
in package
Провайдер даты и времени.
Все моменты детерминированы и выражены в UTC (через cloud-castle/support). Уникальная возможность self::dateInWords() выводит дату прописью на языке локали со склонением (cloud-castle/inflector) — «15 марта 2024 года».
Table of Contents
Methods
- __construct() : mixed
- amPm() : string
- Индикатор времени суток: `am` или `pm`.
- date() : string
- Случайная дата в заданном формате (по умолчанию `Y-m-d`).
- dateInWords() : string
- Дата прописью на языке локали (со склонением) — «15 марта 2024 года».
- dateTime() : DateTimeImmutable
- Случайные дата и время (UTC) в диапазоне по умолчанию.
- dateTimeBetween() : DateTimeImmutable
- Случайные дата и время в диапазоне меток [$startTimestamp, $endTimestamp] (UTC).
- dayOfMonth() : int
- День месяца случайной даты (1–31).
- dayOfWeek() : string
- Название дня недели случайной даты на языке локали.
- month() : int
- Месяц случайной даты (1–12).
- time() : string
- Случайное время в заданном формате (по умолчанию `H:i:s`).
- timezone() : string
- Случайный часовой пояс IANA.
- unixTime() : int
- Случайная метка времени Unix в диапазоне [$min, $max].
- year() : int
- Год случайной даты.
Methods
__construct()
public
__construct(Context $context) : mixed
Parameters
- $context : Context
-
разделяемый контекст провайдеров
amPm()
Индикатор времени суток: `am` или `pm`.
public
amPm() : string
Return values
string —am для первой половины суток, иначе pm
date()
Случайная дата в заданном формате (по умолчанию `Y-m-d`).
public
date([string $format = 'Y-m-d' ]) : string
Parameters
- $format : string = 'Y-m-d'
-
формат
date()
Return values
string —дата, отформатированная по $format
dateInWords()
Дата прописью на языке локали (со склонением) — «15 марта 2024 года».
public
dateInWords([GrammaticalCase|null $case = null ]) : string
Parameters
- $case : GrammaticalCase|null = null
-
падеж (null — именительный)
Return values
string —дата прописью в указанном падеже
dateTime()
Случайные дата и время (UTC) в диапазоне по умолчанию.
public
dateTime() : DateTimeImmutable
Return values
DateTimeImmutable —момент в интервале «эпоха…2100 год»
dateTimeBetween()
Случайные дата и время в диапазоне меток [$startTimestamp, $endTimestamp] (UTC).
public
dateTimeBetween(int $startTimestamp, int $endTimestamp) : DateTimeImmutable
Parameters
- $startTimestamp : int
-
начало диапазона (Unix)
- $endTimestamp : int
-
конец диапазона (Unix)
Tags
Return values
DateTimeImmutable —момент внутри заданного диапазона
dayOfMonth()
День месяца случайной даты (1–31).
public
dayOfMonth() : int
Return values
int —число месяца в [1, 31]
dayOfWeek()
Название дня недели случайной даты на языке локали.
public
dayOfWeek() : string
Return values
string —локализованное название дня недели
month()
Месяц случайной даты (1–12).
public
month() : int
Return values
int —номер месяца в [1, 12]
time()
Случайное время в заданном формате (по умолчанию `H:i:s`).
public
time([string $format = 'H:i:s' ]) : string
Parameters
- $format : string = 'H:i:s'
-
формат
date()
Return values
string —время, отформатированное по $format
timezone()
Случайный часовой пояс IANA.
public
timezone() : string
Return values
string —идентификатор пояса (UTC, Europe/Moscow…)
unixTime()
Случайная метка времени Unix в диапазоне [$min, $max].
public
unixTime([int $min = self::MIN_TIMESTAMP ][, int $max = self::MAX_TIMESTAMP ]) : int
Parameters
- $min : int = self::MIN_TIMESTAMP
-
нижняя граница (по умолчанию — эпоха)
- $max : int = self::MAX_TIMESTAMP
-
верхняя граница (по умолчанию — 2100 год)
Tags
Return values
int —метка времени Unix в секундах
year()
Год случайной даты.
public
year() : int
Return values
int —год (четырёхзначное число)