Класс
Time

Расширяет встроенный класс DateTime, предоставляя удобные методы и помощники для форматирования с учетом локали

Пространство имён: Cake\I18n
Устаревший: 4.3.0 Используйте неизменяемую альтернативу `FrozenTime` вместо этого.

Константы

int

DAYS_PER_WEEK
```
7
```
string

DEFAULT_TO_STRING_FORMAT
```
'Y-m-d H:i:s'
```
Формат по умолчанию для использования в методе __toString при преобразовании типов.
int

FRIDAY
```
5
```
int

HOURS_PER_DAY
```
24
```
int

MINUTES_PER_HOUR
```
60
```
int

MONDAY
```
1
```
int

MONTHS_PER_QUARTER
```
3
```
int

MONTHS_PER_YEAR
```
12
```
int

SATURDAY
```
6
```
int

SECONDS_PER_MINUTE
```
60
```
int

SUNDAY
```
7
```
int

THURSDAY
```
4
```
int

TUESDAY
```
2
```
string

UNIX_TIMESTAMP_FORMAT
```
'unixTimestampFormat'
```
сериализует значение как Unix Timestamp
int

WEDNESDAY
```
3
```
int

WEEKS_PER_YEAR
```
52
```
int

YEARS_PER_CENTURY
```
100
```
int

YEARS_PER_DECADE
```
10
```

END_OF_DOCUMENT_MARKER

Краткое описание свойств

$_formatters protected static

arrayIntlDateFormatter>

Кэш форматировщиков дат в памяти
$_jsonEncodeFormat protected static

Closure|array<int>|string|int

Формат, используемый при преобразовании этого объекта в JSON.
$_lastErrors protected static

array

Содержит последнюю ошибку, сгенерированную createFromFormat
$_toStringFormat protected static

array<int>|string|int

Формат, используемый при форматировании времени с помощью Cake\I18n\Time::i18nFormat() и __toString. Этот формат также используется parseDateTime().
$age public @property-read

int

выполняет diffInYears() с параметрами по умолчанию
$day public @property-read

int
$dayOfWeek public @property-read

int

От 1 (понедельник) до 7 (воскресенье)
$dayOfWeekName public @property-read

string
$dayOfYear public @property-read

int

От 0 до 365
$days protected static

array

Названия дней недели.
$daysInMonth public @property-read

int

Количество дней в данном месяце
$defaultLocale protected static

string|null

Локаль по умолчанию для отображения отформатированных строк дат.
$diffFormatter protected static

Cake\Chronos\DifferenceFormatterInterface

Экземпляр объекта форматирования разницы.
$dst public @property-read

bool

Индикатор летнего времени, true, если DST, иначе false
$hour public @property-read

int
$lenientParsing protected static

bool

Включено ли нестрогое (lenient) разбор для IntlDateFormatter.
$local public @property-read

bool

Проверяет, является ли часовой пояс локальным, true если локальный, иначе false
$micro public @property-read

int
$microsecond public @property-read

int
$minute public @property-read

int
$month public @property-read

int
$niceFormat public static

array<int>|string|int

Формат, используемый при форматировании времени с помощью Cake\I18n\Time::nice()
$offset public @property-read

int

Смещение часового пояса от UTC в секундах.
$offsetHours public @property-read

int

Смещение часового пояса от UTC в часах.
$quarter public @property-read

int

Квартал года (1-4).
$relativePattern protected static

string

Регулярное выражение для относительного периода.
$second public @property-read

int
$timestamp public @property-read

int

Секунды с момента эпохи Unix.
$timezone public @property-read

DateTimeZone|string

Текущий часовой пояс.
$timezoneName public @property-read

string
$toStringFormat protected static

string

Формат для метода __toString при выполнении преобразования типов.
$tz public @property-read

DateTimeZone|string

Псевдоним часового пояса.
$tzName public @property-read

string
$utc public @property-read

bool

Проверяет, является ли часовой пояс UTC, true если UTC, иначе false.
$weekEndsAt protected static

int

Последний день недели.
$weekOfMonth public @property-read

int

От 1 до 5

$weekOfYear public @property-read

int

Номер недели ISO-8601 года, недели начинаются с понедельника
$weekStartsAt protected static

int

Первый день недели
$weekendDays protected static

array

Дни выходных
$wordAccuracy public static

array<string>

Формат для форматирования времени, если Time::timeAgoInWords() и разница меньше Time::$wordEnd
$wordEnd public static

string

Конец интервала для описания временного отрезка
$wordFormat public static

array<int>|string|int

Формат для форматирования времени, если Cake\I18n\Time::timeAgoInWords() и разница больше Cake\I18n\Time::$wordEnd
$year public @property-read

int
$yearIso public @property-read

int

Краткое описание методов

__construct() public

Создать новую изменяемую временную метку.
__debugInfo() public

Возвращает данные, которые должны отображаться при отладке этого объекта
__get() public

Получить часть объекта ChronosInterface
__isset() public

Проверить, существует ли атрибут в объекте
__set() public

Установить часть объекта ChronosInterface
__toString() public

Отформатировать экземпляр в строку с использованием установленного формата
_formatObject() protected

Возвращает переведенную и локализованную строку даты. Реализует то, что IntlDateFormatter::formatObject() делает в PHP 5.5+
addDay() public

Добавить день к экземпляру
addDays() public

Добавить дни к экземпляру. Положительное значение $value перемещает вперёд, а отрицательное — назад.
addHour() public

Добавить час к экземпляру
addHours() public

Добавить часы к экземпляру. Положительное значение $value перемещает вперёд, а отрицательное — назад.
addMinute() public

Добавить минуту к экземпляру
addMinutes() public

Добавить минуты к экземпляру. Положительное значение $value перемещает вперёд, а отрицательное — назад.
addMonth() public

Добавить месяц к экземпляру.
addMonthWithOverflow() public

Добавить месяц с переполнением к экземпляру.
addMonths() public

Добавить месяцы к экземпляру. Положительное значение $value перемещает вперёд, а отрицательное — назад.
addMonthsWithOverflow() public

Добавить месяцы с переполнением к экземпляру. Положительное значение $value перемещает вперёд, а отрицательное — назад.
addSecond() public

Добавить секунду к экземпляру
addSeconds() public

Добавить секунды к экземпляру. Положительное значение $value перемещает вперёд, а отрицательное — назад.
addWeek() public

Добавить неделю к экземпляру
addWeekday() public

Добавить день недели к экземпляру
addWeekdays() public

Добавить дни недели к экземпляру. Положительное значение $value перемещает вперёд, а отрицательное — назад.
addWeeks() public

Добавить недели к экземпляру. Положительное значение $value перемещает вперёд, а отрицательное — назад.
addYear() public

Добавить год к экземпляру
addYearWithOverflow() public

Добавить год с переполнением к экземпляру
addYears() public

Добавить годы к экземпляру. Положительное значение $value перемещает вперёд, а отрицательное — назад.
addYearsWithOverflow() public

Добавить годы с переполнением к экземпляру. Положительное значение $value перемещает вперёд, а отрицательное — назад.
average() public

Изменить текущий экземпляр на среднее значение заданного экземпляра (по умолчанию — текущее время) и текущего экземпляра.
between() public

Определяет, находится ли экземпляр между двумя другими.
closest() public

Получить ближайшую дату от экземпляра.
copy() public

Получить копию экземпляра
create() public static

Создать новый экземпляр ChronosInterface по определенной дате и времени.
createFromArray() public static

Создаёт экземпляр ChronosInterface из массива значений даты и времени.
createFromDate() public static

Создать экземпляр ChronosInterface только по дате. Часть времени устанавливается на текущее время.
createFromFormat() public static

Создать экземпляр ChronosInterface по определённому формату
createFromTime() public static

Создать экземпляр ChronosInterface только по времени. Часть даты устанавливается на сегодняшнюю.
createFromTimestamp() public static

Создать экземпляр ChronosInterface из метки времени
createFromTimestampUTC() public static

Создать экземпляр ChronosInterface из UTC метки времени
day() public

Установить день экземпляра
diffFiltered() public

Получить разницу по заданному интервалу, используя вызываемую функцию фильтра.
diffForHumans() public

Получить разницу в удобочитаемом для человека формате в текущей локали.
diffFormatter() public static

Получить или переопределить текущий экземпляр форматера разницы.
diffInDays() public

Получить разницу в днях
diffInDaysFiltered() public

Получить разницу в днях, используя вызываемую функцию фильтра.
diffInHours() public

Получить разницу в часах
diffInHoursFiltered() public

Получить разницу в часах, используя вызываемую функцию фильтра.

diffInMinutes() public

Получить разницу в минутах
diffInMonths() public

Получить разницу в месяцах
diffInMonthsIgnoreTimezone() public

Получить разницу в месяцах, игнорируя часовой пояс. Это означает, что месяцы вычисляются в указанном часовом поясе без предварительного преобразования в UTC. Это предотвращает изменение дня, что может изменить месяц.
diffInSeconds() public

Получить разницу во секундах
diffInWeekdays() public

Получить разницу в рабочих днях
diffInWeekendDays() public

Получить разницу в выходные дни, используя фильтр
diffInWeeks() public

Получить разницу в неделях
diffInYears() public

Получить разницу в годах
disableLenientParsing() public static

Включает строгий разбор для локальных форматов.
enableLenientParsing() public static

Включает строгий разбор для локальных форматов.
endOfCentury() public

Сбрасывает дату до конца века, а время до 23:59:59
endOfDay() public

Сбрасывает время до 23:59:59
endOfDecade() public

Сбрасывает дату до конца десятилетия, а время до 23:59:59
endOfMonth() public

Сбрасывает дату до конца месяца, а время до 23:59:59
endOfWeek() public

Сбрасывает дату до конца недели (определяется в $weekEndsAt), а время до 23:59:59
endOfYear() public

Сбрасывает дату до конца года, а время до 23:59:59
eq() public

Определяет, равна ли текущая инстанция другой
equals() public

Определяет, равна ли текущая инстанция другой
farthest() public

Получить самую дальнюю дату от текущей инстанции.
firstOfMonth() public

Изменить на первое вхождение заданного дня недели в текущем месяце. Если dayOfWeek не указан, изменить на первый день текущего месяца. Используйте предоставленные константы для указания желаемого dayOfWeek, например, static::MONDAY.
firstOfQuarter() public

Изменить на первое вхождение заданного дня недели в текущем квартале. Если dayOfWeek не указан, изменить на первый день текущего квартала. Используйте предоставленные константы для указания желаемого dayOfWeek, например, static::MONDAY.
firstOfYear() public

Изменить на первое вхождение заданного дня недели в текущем году. Если dayOfWeek не указан, изменить на первый день текущего года. Используйте предоставленные константы для указания желаемого dayOfWeek, например, static::MONDAY.
fromNow() public static

Удобный метод для получения оставшегося времени от заданного времени.
getDefaultLocale() public static

Получить значение по умолчанию для locale.
getDiffFormatter() public static

Получить экземпляр форматировщика разницы.
getLastErrors() public static

Возвращает любые ошибки или предупреждения, найденные во время разбора последнего объекта, созданного этим классом.
getTestNow() public static

Получить тестовый экземпляр, хранящийся в Chronos
getWeekEndsAt() public static

Получить последний день недели
getWeekStartsAt() public static

Получить первый день недели
getWeekendDays() public static

Получить выходные дни
greaterThan() public

Определяет, является ли экземпляр больше (после) другого
greaterThanOrEquals() public

Определяет, является ли экземпляр больше (после) или равен другому
gt() public

Определяет, является ли экземпляр больше (после) другого
gte() public

Определяет, является ли экземпляр больше (после) или равен другому
hasRelativeKeywords() public static

Определяет, есть ли относительные ключевые слова в строке времени, это необходимо для создания дат, относящихся к текущему времени для тестовых экземпляров. Например: следующая вторник
hasTestNow() public static

Получить, установлен ли в Chronos тестовый экземпляр.
hour() public

Установить час экземпляра
i18nFormat() public

Возвращает отформатированную строку для этого объекта времени, используя предпочтительный формат и язык для указанного locale.
instance() public static

Создать экземпляр ChronosInterface из DateTimeInterface
isBirthday() public

Проверить, является ли это днём рождения. Сравнивает значения даты/месяца двух дат.
isFriday() public

Проверяет, является ли этот день пятницей.
isFuture() public

Определяет, находится ли экземпляр в будущем, т.е. больше (после) текущего времени
isLastMonth() public

Определяет, находится ли экземпляр в прошлом месяце
isLastWeek() public

Определяет, находится ли экземпляр в прошлой неделе

isLastYear() public

Определяет, находится ли экземпляр в прошлом году
isLeapYear() public

Определяет, является ли экземпляр високосным годом
isMonday() public

Проверяет, является ли этот день понедельником.
isMutable() public

Проверка, является ли экземпляр ChronosInterface изменяемым.
isNextMonth() public

Определяет, находится ли экземпляр в следующем месяце
isNextWeek() public

Определяет, находится ли экземпляр в следующей неделе
isNextYear() public

Определяет, находится ли экземпляр в следующем году
isPast() public

Определяет, находится ли экземпляр в прошлом, т.е. меньше (раньше), чем сейчас
isSameDay() public

Проверяет, является ли переданная дата тем же днем, что и текущий день экземпляра.
isSaturday() public

Проверяет, является ли этот день субботой.
isSunday() public

Проверяет, является ли этот день воскресеньем.
isThisMonth() public

Возвращает true, если этот объект представляет дату текущего месяца
isThisWeek() public

Возвращает true, если этот объект представляет дату текущей недели
isThisYear() public

Возвращает true, если этот объект представляет дату текущего года
isThursday() public

Проверяет, является ли этот день четвергом.
isToday() public

Определяет, является ли экземпляр сегодняшним днем
isTomorrow() public

Определяет, является ли экземпляр завтрашним днем
isTuesday() public

Проверяет, является ли этот день вторником.
isWednesday() public

Проверяет, является ли этот день средой.
isWeekday() public

Определяет, является ли экземпляр будним днем
isWeekend() public

Определяет, является ли экземпляр выходным днем
isWithinNext() public

Возвращает true, если этот экземпляр произойдет в указанном интервале
isYesterday() public

Определяет, является ли экземпляр вчерашним днем
jsonSerialize() public

Возвращает строку, которая должна быть сериализована при преобразовании этого объекта в JSON
lastOfMonth() public

Изменить на последнее вхождение заданного дня недели в текущем месяце. Если dayOfWeek не указан, изменить на последний день текущего месяца. Используйте предоставленные константы для указания желаемого dayOfWeek, например, static::MONDAY.
lastOfQuarter() public

Изменить на последнее вхождение заданного дня недели в текущем квартале. Если dayOfWeek не указан, изменить на последний день текущего квартала. Используйте предоставленные константы для указания желаемого dayOfWeek, например, static::MONDAY.
lastOfYear() public

Изменить на последнее вхождение заданного дня недели в текущем году. Если dayOfWeek не указан, изменить на последний день текущего года. Используйте предоставленные константы для указания желаемого dayOfWeek, например, static::MONDAY.
lenientParsingEnabled() public static

Получение значения, указывающего, установлена ли нестрогая обработка локального формата.
lessThan() public

Определяет, является ли экземпляр меньше (раньше) другого
lessThanOrEquals() public

Определяет, является ли экземпляр меньше (раньше) или равен другому
listTimezones() public static

Получение списка идентификаторов часовых поясов
lt() public

Определяет, является ли экземпляр меньше (раньше) другого
lte() public

Определяет, является ли экземпляр меньше (раньше) или равен другому
max() public

Получение максимального экземпляра между заданным экземпляром (по умолчанию сейчас) и текущим экземпляром.
maxValue() public static

Создание экземпляра ChronosInterface для наибольшей поддерживаемой даты.
microsecond() public

Установка микросекунд экземпляра
min() public

Получение минимального экземпляра между заданным экземпляром (по умолчанию сейчас) и текущим экземпляром.
minValue() public static

Создание экземпляра ChronosInterface для самой низкой поддерживаемой даты.
minute() public

Установка минут экземпляра
modify() public @method
month() public

Установка месяца экземпляра
ne() public

Определяет, не равен ли экземпляр другому
next() public

Изменить на следующее вхождение заданного дня недели. Если dayOfWeek не указан, изменить на следующее вхождение текущего дня недели. Используйте предоставленные константы для указания желаемого dayOfWeek, например, static::MONDAY.
nice() public

Возвращает отформатированную строку даты для этого объекта.
notEquals() public

Определяет, не равен ли экземпляр другому
now() public static

Получение экземпляра ChronosInterface для текущей даты и времени

END_OF_DOCUMENT_MARKER

nthOfMonth() public

Изменить на заданное вхождение заданного дня недели в текущем месяце. Если вычисленное вхождение находится за пределами текущего месяца, вернуть false и не производить никаких изменений. Используйте предоставленные константы для указания желаемого дня недели, например, static::MONDAY.
nthOfQuarter() public

Изменить на заданное вхождение заданного дня недели в текущем квартале. Если вычисленное вхождение находится за пределами текущего квартала, вернуть false и не производить никаких изменений. Используйте предоставленные константы для указания желаемого дня недели, например, static::MONDAY.
nthOfYear() public

Изменить на заданное вхождение заданного дня недели в текущем году. Если вычисленное вхождение находится за пределами текущего года, вернуть false и не производить никаких изменений. Используйте предоставленные константы для указания желаемого дня недели, например, static::MONDAY.
parse() public static

Создать экземпляр ChronosInterface из строки. Это псевдоним для конструктора, который позволяет использовать более удобный синтаксис, так как позволяет сделать ChronosInterface::parse('Понедельник следующей недели')->fn() вместо (new Chronos('Понедельник следующей недели'))->fn().
parseDate() public static

Возвращает новый объект Time после анализа предоставленной строки $date в соответствии с переданным или настроенным форматом даты и времени. Этот метод зависит от локали. Любая строка, переданная в эту функцию, будет интерпретироваться как строка, зависящая от локали.
parseDateTime() public static

Возвращает новый объект Time после анализа предоставленной строки времени в соответствии с переданным или настроенным форматом даты и времени. Этот метод зависит от локали. Любая строка, переданная в эту функцию, будет интерпретироваться как строка, зависящая от локали.
parseTime() public static

Возвращает новый объект Time после анализа предоставленной строки $time в соответствии с переданным или настроенным форматом даты и времени. Этот метод зависит от локали. Любая строка, переданная в эту функцию, будет интерпретироваться как строка, зависящая от локали.
previous() public

Изменить на предыдущее вхождение заданного дня недели. Если день недели не указан, изменить на предыдущее вхождение текущего дня недели. Используйте предоставленные константы для указания желаемого дня недели, например, static::MONDAY.
resetToStringFormat() public static

Сбрасывает формат до значения по умолчанию при преобразовании экземпляра этого типа в строку
safeCreateDateTimeZone() protected static

Создает DateTimeZone из строки или DateTimeZone
second() public

Установить секунды экземпляра
secondsSinceMidnight() public

Количество секунд с полуночи.
secondsUntilEndOfDay() public

Количество секунд до 23:59:59.
setDate() public

Установить дату на другую дату.
setDateTime() public

Установить дату и время вместе.
setDefaultLocale() public static

Устанавливает локаль по умолчанию.
setDiffFormatter() public static

Установить экземпляр форматировщика разницы.
setJsonEncodeFormat() public static

Устанавливает формат по умолчанию, используемый при преобразовании этого объекта в JSON
setTestNow() public static

Установить текущее время для тестирования, используемое классами Date и Time, предоставляемыми Chronos
setTimeFromTimeString() public

Установить время по строке времени
setTimezone() public

Установить часовой пояс экземпляра из строки или объекта
setToStringFormat() public static

Устанавливает формат по умолчанию, используемый при преобразовании экземпляров этого типа в строку
setWeekEndsAt() public static

Установить последний день недели
setWeekStartsAt() public static

Установить первый день недели
setWeekendDays() public static

Установить выходные дни
startOfCentury() public

Сбрасывает дату до первого дня века, а время до 00:00:00
startOfDay() public

Сбрасывает время до 00:00:00
startOfDecade() public

Сбрасывает дату до первого дня десятилетия, а время до 00:00:00
startOfMonth() public

Сбрасывает дату до первого дня месяца, а время до 00:00:00
startOfWeek() public

Сбрасывает дату до первого дня недели (определенного в $weekStartsAt), а время до 00:00:00
startOfYear() public

Сбрасывает дату до первого дня года, а время до 00:00:00
subDay() public

Удалить день из экземпляра
subDays() public

Удалить дни из экземпляра
subHour() public

Удалить час из экземпляра
subHours() public

Удалить часы из экземпляра
subMinute() public

Удалить минуту из экземпляра
subMinutes() public

Удалить минуты из экземпляра
subMonth() public

Удалить месяц из экземпляра
subMonthWithOverflow() public

Удалить месяц с переполнением из экземпляра.
subMonths() public

Удалить месяцы из экземпляра.
subMonthsWithOverflow() public

Удалить месяцы с переполнением из экземпляра.

subSecond() public

Удалить секунду из экземпляра
subSeconds() public

Удалить секунды из экземпляра
subWeek() public

Удалить неделю из экземпляра
subWeekday() public

Удалить день недели из экземпляра
subWeekdays() public

Удалить дни недели из экземпляра
subWeeks() public

Удалить недели из экземпляра
subYear() public

Удалить год из экземпляра.
subYearWithOverflow() public

Удалить год с переполнением из экземпляра
subYears() public

Удалить годы из экземпляра.
subYearsWithOverflow() public

Удалить годы с переполнением из экземпляра
timeAgoInWords() public

Возвращает относительную или отформатированную абсолютную дату в зависимости от разницы между текущим временем и этим объектом.
timestamp() public

Установить метку времени экземпляра
timezone() public

Псевдоним для setTimezone()
toAtomString() public

Отформатировать экземпляр как ATOM
toCookieString() public

Отформатировать экземпляр как COOKIE
toDateString() public

Отформатировать экземпляр как дату
toDateTimeString() public

Отформатировать экземпляр как дату и время
toDayDateTimeString() public

Отформатировать экземпляр с днём, датой и временем
toFormattedDateString() public

Отформатировать экземпляр как удобочитаемую дату
toImmutable() public

Создать новый неизменяемый экземпляр из текущего изменяемого экземпляра.
toIso8601String() public

Отформатировать экземпляр как ISO8601
toQuarter() public

Возвращает квартал
toRfc1036String() public

Отформатировать экземпляр как RFC1036
toRfc1123String() public

Отформатировать экземпляр как RFC1123
toRfc2822String() public

Отформатировать экземпляр как RFC2822
toRfc3339String() public

Отформатировать экземпляр как RFC3339
toRfc822String() public

Отформатировать экземпляр как RFC822
toRfc850String() public

Отформатировать экземпляр как RFC850
toRssString() public

Отформатировать экземпляр как RSS
toTimeString() public

Отформатировать экземпляр как время
toUnixString() public

Возвращает метку времени UNIX.
toW3cString() public

Отформатировать экземпляр как W3C
toWeek() public
today() public static

Создать экземпляр ChronosInterface для сегодня
tomorrow() public static

Создать экземпляр ChronosInterface для завтра
tz() public

Псевдоним для setTimezone()
wasWithinLast() public

Возвращает true, если этот экземпляр произошёл в указанном интервале
year() public

Установить год экземпляра
yesterday() public static

Создать экземпляр ChronosInterface для вчера

Подробное описание методов

__construct() public

__construct(DateTimeInterface|string|int|null $time = null, DateTimeZone|string|null $tz = null)

Создать новый изменяемый экземпляр времени.

См. раздел о средствах тестирования (в частности, static::setTestNow()) для получения дополнительной информации о возможности возвращения этим конструктором тестового экземпляра.

Параметры

DateTimeInterface|string|int|null $time optional: Фиксированное или относительное время
DateTimeZone|string|null $tz optional: Часовой пояс для экземпляра

__debugInfo() public

__debugInfo(): array<string, mixed>

Возвращает данные, которые должны отображаться при отладке этого объекта

Возвращает

array<string, mixed>

__get() public

__get(string $name): string|int|boolDateTimeZone

Получить часть объекта ChronosInterface

Параметры

string $name: Имя свойства для чтения.

Возвращает

string|int|boolDateTimeZone

Вызывает исключение

InvalidArgumentException

__isset() public

__isset(string $name): bool

Проверить, существует ли атрибут в объекте

Параметры

string $name: Имя свойства для проверки.

Возвращает

bool

__set() public

__set(string $name, string|intDateTimeZone $value): void

Установить часть объекта ChronosInterface

Параметры

string $name: Свойство для установки.
string|intDateTimeZone $value: Значение для установки.

Возвращает

void

Вызывает исключение

InvalidArgumentException

__toString() public

__toString(): string

Форматирует экземпляр как строку, используя установленный формат

Возвращает

string

_formatObject() protected

_formatObject(DateTimeDateTimeImmutable $date, array<int>|string|int $format, string|null $locale): string

Возвращает переведенную и локализованную строку даты. Реализует то, что IntlDateFormatter::formatObject() делает в PHP 5.5+

Параметры

DateTimeDateTimeImmutable $date: Дата.
array<int>|string|int $format: Формат.
string|null $locale: Имя локали, в которой должна отображаться дата.

Возвращает

string

addDay() public

addDay(int $value = 1): static

Добавить день к экземпляру

Параметры

int $value optional: Количество дней для добавления.

Возвращает

static

addDays() public

addDays(int $value): static

Добавить дни к экземпляру. Положительное значение $value перемещается вперед, а отрицательное — в прошлое.

Параметры

int $value: Количество дней для добавления.

Возвращает

static

addHour() public

addHour(int $value = 1): static

Добавить час к экземпляру

Параметры

int $value optional: Количество часов для добавления.

Возвращает

static

addHours() public

addHours(int $value): static

Добавить часы к экземпляру. Положительное значение $value перемещается вперед, а отрицательное — в прошлое.

Параметры

int $value: Количество часов для добавления.

Возвращает

static

addMinute() public

addMinute(int $value = 1): static

Добавить минуту к экземпляру

Параметры

int $value optional: Количество минут для добавления.

Возвращает

static

addMinutes() public

addMinutes(int $value): static

Добавить минуты к экземпляру. Положительное значение $value перемещается вперед, а отрицательное — в прошлое.

Параметры

int $value: Количество минут для добавления.

Возвращает

static

addMonth() public

addMonth(int $value = 1): static

Добавить месяц к экземпляру.

Имеет такое же поведение, как addMonths().

Параметры

int $value optional: Количество месяцев для добавления.

Возвращает

static

addMonthWithOverflow() public

addMonthWithOverflow(int $value = 1): static

Добавить месяц с переполнением к экземпляру.

Имеет такое же поведение, как addMonthsWithOverflow().

Параметры

int $value optional: Количество месяцев для добавления.

Возвращает

static

addMonths() public

addMonths(int $value): static

Добавить месяцы к экземпляру. Положительное значение $value перемещается вперед, а отрицательное — в прошлое.

Если новая дата не существует, вместо переполнения в следующий месяц используется последний день месяца.

Пример:

(new Chronos('2015-01-03'))->addMonths(1); // Results in 2015-02-03

(new Chronos('2015-01-31'))->addMonths(1); // Results in 2015-02-28

Параметры

int $value: Количество месяцев для добавления.

Возвращает

static

addMonthsWithOverflow() public

addMonthsWithOverflow(int $value): static

Добавить месяцы с переполнением к экземпляру. Положительное значение $value перемещается вперед, а отрицательное — в прошлое.

Если новая дата не существует, дни переполняются в следующий месяц.

Пример:

(new Chronos('2012-01-30'))->addMonthsWithOverflow(1); // Results in 2013-03-01

Параметры

int $value: Количество месяцев для добавления.

Возвращает

static

addSecond() public

addSecond(int $value = 1): static

Добавить секунду к экземпляру

Параметры

int $value optional: Количество секунд для добавления.

Возвращает

static

addSeconds() public

addSeconds(int $value): static

Добавить секунды к экземпляру. Положительное значение $value перемещается вперед, а отрицательное — в прошлое.

Параметры

int $value: Количество секунд для добавления.

Возвращает

static

addWeek() public

addWeek(int $value = 1): static

Добавить неделю к экземпляру

Параметры

int $value optional: Количество недель для добавления.

Возвращает

static

addWeekday() public

addWeekday(int $value = 1): static

Добавить будний день к экземпляру

Параметры

int $value optional: Количество будних дней для добавления.

Возвращает

static

addWeekdays() public

addWeekdays(int $value): static

Добавить рабочие дни к экземпляру. Положительное значение $value перемещает дату вперёд, а отрицательное — назад.

Параметры

int $value: Количество рабочих дней для добавления.

Возвращаемое значение

static

addWeeks() public

addWeeks(int $value): static

Добавить недели к экземпляру. Положительное значение $value перемещает дату вперёд, а отрицательное — назад.

Параметры

int $value: Количество недель для добавления.

Возвращаемое значение

static

addYear() public

addYear(int $value = 1): static

Добавить год к экземпляру

Имеет такое же поведение, как addYears().

Параметры

int $value optional: Количество лет для добавления.

Возвращаемое значение

static

addYearWithOverflow() public

addYearWithOverflow(int $value = 1): static

Добавить год с переполнением к экземпляру

Имеет такое же поведение, как addYearsWithOverflow().

Параметры

int $value optional: Количество лет для добавления.

Возвращаемое значение

static

addYears() public

addYears(int $value): static

Добавить годы к экземпляру. Положительное значение $value перемещает дату вперёд, а отрицательное — назад.

Если новая дата не существует, используется последний день месяца вместо переполнения на следующий месяц.

Пример:

(new Chronos('2015-01-03'))->addYears(1); // Results in 2016-01-03

(new Chronos('2012-02-29'))->addYears(1); // Results in 2013-02-28

Параметры

int $value: Количество лет для добавления.

Возвращаемое значение

static

addYearsWithOverflow() public

addYearsWithOverflow(int $value): static

Добавить годы с переполнением к экземпляру. Положительное значение $value перемещает дату вперёд, а отрицательное — назад.

Если новая дата не существует, дни переполняются на следующий месяц.

Пример:

(new Chronos('2012-02-29'))->addYearsWithOverflow(1); // Results in 2013-03-01

Параметры

int $value: Количество лет для добавления.

Возвращаемое значение

static

average() public

average(Cake\Chronos\ChronosInterface $dt = null): static

Изменить текущий экземпляр на среднее значение между заданным экземпляром (по умолчанию сейчас) и текущим экземпляром.

Параметры

Cake\Chronos\ChronosInterface $dt optional: Экземпляр для сравнения.

Возвращаемое значение

static

between() public

between(Cake\Chronos\ChronosInterface $dt1, Cake\Chronos\ChronosInterface $dt2, bool $equal = true): bool

Определяет, находится ли экземпляр между двумя другими.

Параметры

Cake\Chronos\ChronosInterface $dt1: Экземпляр для сравнения.
Cake\Chronos\ChronosInterface $dt2: Экземпляр для сравнения.
bool $equal optional: Указывает, следует ли использовать сравнение > и < или <= и >=.

Возвращаемое значение

bool

closest() public

closest(Cake\Chronos\ChronosInterface $dt1, Cake\Chronos\ChronosInterface $dt2): static

Получить ближайшую дату от экземпляра.

Параметры

Cake\Chronos\ChronosInterface $dt1: Экземпляр для сравнения.
Cake\Chronos\ChronosInterface $dt2: Экземпляр для сравнения.

Возвращаемое значение

static

copy() public

copy(): static

Получить копию экземпляра

Возвращаемое значение

static

create() public static

create(int|null $year = null, int|null $month = null, int|null $day = null, int|null $hour = null, int|null $minute = null, int|null $second = null, int|null $microsecond = null, DateTimeZone|string|null $tz = null): static

Создать новый экземпляр ChronosInterface из указанной даты и времени.

Если какие-либо из $year, $month или $day установлены в null, будут использованы значения now().

Если $hour равен null, он будет установлен в значение now(), а значения по умолчанию для $minute, $second и $microsecond будут значениями now(). Если $hour не равен null, значения по умолчанию для $minute, $second и $microsecond будут 0.

Параметры

int|null $year optional: Год для создания экземпляра.
int|null $month optional: Месяц для создания экземпляра.
int|null $day optional: День для создания экземпляра.
int|null $hour optional: Час для создания экземпляра.
int|null $minute optional: Минута для создания экземпляра.
int|null $second optional: Секунда для создания экземпляра.
int|null $microsecond optional: Микросекунда для создания экземпляра.
DateTimeZone|string|null $tz optional: Объект DateTimeZone или имя часового пояса, который должен использовать новый экземпляр.

Возвращаемое значение

static

createFromArray() public static

createFromArray((int|string)[] $values): static

Создаёт экземпляр ChronosInterface из массива значений даты и времени.

Значения 'year', 'month' и 'day' должны быть заданы для даты. Значения времени по умолчанию равны 0.

Значение 'timezone' может быть в любом формате, поддерживаемом \DateTimeZone.

Допустимые значения:

год
месяц
день
час
минута
секунда
микросекунда
меридиан ('am' или 'pm')
часовой пояс

Параметры

(int|string)[] $values: Массив значений даты и времени.

Возвращаемое значение

static

createFromDate() public static

createFromDate(int|null $year = null, int|null $month = null, int|null $day = null, DateTimeZone|string|null $tz = null): static

Создаёт экземпляр ChronosInterface только из даты. Часть времени устанавливается в текущее время.

Параметры

int|null $year optional: Год для создания экземпляра.
int|null $month optional: Месяц для создания экземпляра.
int|null $day optional: День для создания экземпляра.
DateTimeZone|string|null $tz optional: Объект DateTimeZone или имя часового пояса, который должен использовать новый экземпляр.

Возвращаемое значение

static

createFromFormat() public static

createFromFormat(string $format, string $time, DateTimeZone|string|null $tz = null): static

Создаёт экземпляр ChronosInterface из указанного формата

Параметры

string $format: Строка формата, совместимая с date().
string $time: Форматированная строка даты для интерпретации.
DateTimeZone|string|null $tz optional: Объект DateTimeZone или имя часового пояса, который должен использовать новый экземпляр.

Возвращаемое значение

static

Исключения

InvalidArgumentException

createFromTime() public static

createFromTime(int|null $hour = null, int|null $minute = null, int|null $second = null, int|null $microsecond = null, DateTimeZone|string|null $tz = null): static

Создать экземпляр ChronosInterface только по времени. Часть даты установлена на сегодня.

Параметры

int|null $hour optional: Час для создания экземпляра.
int|null $minute optional: Минута для создания экземпляра.
int|null $second optional: Секунда для создания экземпляра.
int|null $microsecond optional: Микросекунда для создания экземпляра.
DateTimeZone|string|null $tz optional: Объект DateTimeZone или имя часового пояса, который должен использовать новый экземпляр.

Возвращает

static

createFromTimestamp() public static

createFromTimestamp(int $timestamp, DateTimeZone|string|null $tz = null): static

Создать экземпляр ChronosInterface из метки времени

Параметры

int $timestamp: Метка времени для создания экземпляра.
DateTimeZone|string|null $tz optional: Объект DateTimeZone или имя часового пояса, который должен использовать новый экземпляр.

Возвращает

static

createFromTimestampUTC() public static

createFromTimestampUTC(int $timestamp): static

Создать экземпляр ChronosInterface из UTC метки времени

Параметры

int $timestamp: UTC метка времени для создания экземпляра.

Возвращает

static

day() public

day(int $value): static

Установить день экземпляра

Параметры

int $value: Значение дня.

Возвращает

static

diffFiltered() public

diffFiltered(Cake\Chronos\ChronosInterval $ci, callable $callback, Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу по заданному интервалу с помощью вызываемой фильтрации

Параметры

Cake\Chronos\ChronosInterval $ci: Интервал для обхода.
callable $callback: Функция обратного вызова для фильтрации.
callable $dt optional: Экземпляр для получения разницы.
bool $abs optional: Получить абсолютное значение разницы.

Возвращает

int

diffForHumans() public

diffForHumans(Cake\Chronos\ChronosInterface|null $other = null, bool $absolute = false): string

Получить разницу в удобочитаемом формате в текущем локали.

При сравнении значения в прошлом с текущим значением: 1 час назад 5 месяцев назад

При сравнении значения в будущем с текущим значением: 1 час отныне 5 месяцев отныне

При сравнении значения в прошлом с другим значением: 1 час до 5 месяцев до

При сравнении значения в будущем с другим значением: 1 час спустя 5 месяцев спустя

Параметры

Cake\Chronos\ChronosInterface|null $other optional: Дата и время для сравнения.
bool $absolute optional: Удаляет модификаторы временных различий назад, после и т.д.

Возвращает

string

diffFormatter() public static

diffFormatter(Cake\Chronos\DifferenceFormatterInterface|null $formatter = null): Cake\Chronos\DifferenceFormatterInterface

Получить экземпляр форматировщика разницы или перезаписать текущий.

Параметры

Cake\Chronos\DifferenceFormatterInterface|null $formatter optional: Экземпляр форматировщика при установке.

Возвращает

Cake\Chronos\DifferenceFormatterInterface

diffInDays() public

diffInDays(Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в днях

Параметры

Cake\Chronos\ChronosInterface|null $dt optional: Экземпляр для получения разницы.
bool $abs optional: Получить абсолютное значение разницы.

Возвращает

int

diffInDaysFiltered() public

diffInDaysFiltered(callable $callback, Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в днях с помощью вызываемой фильтрации

Параметры

callable $callback: Функция обратного вызова для фильтрации.
Cake\Chronos\ChronosInterface|null $dt optional: Экземпляр для получения разницы.
bool $abs optional: Получить абсолютное значение разницы.

Возвращает

int

diffInHours() public

diffInHours(Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в часах

Параметры

Cake\Chronos\ChronosInterface|null $dt optional: Экземпляр для получения разницы.
bool $abs optional: Получить абсолютное значение разницы.

Возвращает

int

diffInHoursFiltered() public

diffInHoursFiltered(callable $callback, Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в часах с помощью вызываемой фильтрации

Параметры

callable $callback: Функция обратного вызова для фильтрации.
Cake\Chronos\ChronosInterface|null $dt optional: Экземпляр для получения разницы.
bool $abs optional: Получить абсолютное значение разницы.

Возвращает

int

diffInMinutes() public

diffInMinutes(Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в минутах

Параметры

Cake\Chronos\ChronosInterface|null $dt optional: Экземпляр для получения разницы.
bool $abs optional: Получить абсолютное значение разницы.

Возвращает

int

diffInMonths() public

diffInMonths(Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в месяцах

Параметры

Cake\Chronos\ChronosInterface|null $dt optional: Экземпляр для получения разницы.
bool $abs optional: Получить абсолютное значение разницы.

Возвращает

int

diffInMonthsIgnoreTimezone() public

diffInMonthsIgnoreTimezone(Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в месяцах, игнорируя часовой пояс. Это означает, что месяцы рассчитываются в указанном часовом поясе без предварительного преобразования в UTC. Это предотвращает изменение дня, что может изменить месяц.

Например, при сравнении 2019-06-01 Asia/Tokyo и 2019-10-01 Asia/Tokyo, результат будет 4 месяца, а не 3 при использовании обычного DateTime::diff().

Параметры

Cake\Chronos\ChronosInterface|null $dt optional: Экземпляр для получения разницы.
bool $abs optional: Получить абсолютное значение разницы.

Возвращает

int

diffInSeconds() public

diffInSeconds(Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в секундах

Параметры

Cake\Chronos\ChronosInterface|null $dt optional: Экземпляр для получения разницы.
bool $abs optional: Получить абсолютное значение разницы.

Возвращает

int

diffInWeekdays() public

diffInWeekdays(Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в рабочих днях

Параметры

Cake\Chronos\ChronosInterface|null $dt необязательно: Экземпляр для вычисления разницы.
bool $abs необязательно: Получить абсолютное значение разницы

Возвращает

int

diffInWeekendDays() public

diffInWeekendDays(Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в выходные дни с применением фильтра

Параметры

Cake\Chronos\ChronosInterface|null $dt необязательно: Экземпляр для вычисления разницы.
bool $abs необязательно: Получить абсолютное значение разницы

Возвращает

int

diffInWeeks() public

diffInWeeks(Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в неделях

Параметры

Cake\Chronos\ChronosInterface|null $dt необязательно: Экземпляр для вычисления разницы.
bool $abs необязательно: Получить абсолютное значение разницы

Возвращает

int

diffInYears() public

diffInYears(Cake\Chronos\ChronosInterface|null $dt = null, bool $abs = true): int

Получить разницу в годах

Параметры

Cake\Chronos\ChronosInterface|null $dt необязательно: Экземпляр для вычисления разницы.
bool $abs необязательно: Получить абсолютное значение разницы

Возвращает

int

disableLenientParsing() public static

disableLenientParsing(): void

Включает строгий парсинг для форматов локали.

Возвращает

void

enableLenientParsing() public static

enableLenientParsing(): void

Включает строгий парсинг для форматов локали.

Возвращает

void

endOfCentury() public

endOfCentury(): static

Сбрасывает дату до конца века, а время до 23:59:59

Возвращает

static

endOfDay() public

endOfDay(): static

Сбрасывает время до 23:59:59

Возвращает

static

endOfDecade() public

endOfDecade(): static

Сбрасывает дату до конца десятилетия, а время до 23:59:59

Возвращает

static

endOfMonth() public

endOfMonth(): static

Сбрасывает дату до конца месяца, а время до 23:59:59

Возвращает

static

endOfWeek() public

endOfWeek(): static

Сбрасывает дату до конца недели (определено в $weekEndsAt), а время до 23:59:59

Возвращает

static

endOfYear() public

endOfYear(): static

Сбрасывает дату до конца года, а время до 23:59:59

Возвращает

static

eq() public

eq(Cake\Chronos\ChronosInterface $dt): bool

Определяет, равен ли экземпляр другому

Параметры

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Возвращает

bool

См. также

equals

equals() public

equals(Cake\Chronos\ChronosInterface $dt): bool

Определяет, равен ли экземпляр другому

Параметры

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Возвращает

bool

farthest() public

farthest(Cake\Chronos\ChronosInterface $dt1, Cake\Chronos\ChronosInterface $dt2): static

Получить самую удаленную дату от экземпляра.

Параметры

Cake\Chronos\ChronosInterface $dt1: Экземпляр для сравнения.
Cake\Chronos\ChronosInterface $dt2: Экземпляр для сравнения.

Возвращает

static

firstOfMonth() public

firstOfMonth(int|null $dayOfWeek = null): mixed

Изменяет дату на первое вхождение заданного дня недели в текущем месяце. Если день недели не указан, изменяет на первый день текущего месяца. Используйте предоставленные константы для указания желаемого дня недели, например, static::MONDAY.

Параметры

int|null $dayOfWeek необязательно: День недели для перехода.

Возвращает

mixed

firstOfQuarter() public

firstOfQuarter(int|null $dayOfWeek = null): mixed

Изменяет дату на первое вхождение заданного дня недели в текущем квартале. Если день недели не указан, изменяет на первый день текущего квартала. Используйте предоставленные константы для указания желаемого дня недели, например, static::MONDAY.

Параметры

int|null $dayOfWeek необязательно: День недели для перехода.

Возвращает

mixed

firstOfYear() public

firstOfYear(int|null $dayOfWeek = null): mixed

Изменяет дату на первое вхождение заданного дня недели в текущем году. Если день недели не указан, изменяет на первый день текущего года. Используйте предоставленные константы для указания желаемого дня недели, например, static::MONDAY.

Параметры

int|null $dayOfWeek необязательно: День недели для перехода.

Возвращает

mixed

fromNow() public static

fromNow(DateTimeDateTimeImmutable $datetime): DateInterval|bool

Удобный метод для получения оставшегося времени от заданного времени.

Параметры

DateTimeDateTimeImmutable $datetime: Дата, для которой нужно получить оставшееся время.

Возвращает

DateInterval|bool

getDefaultLocale() public static

getDefaultLocale(): string|null

Получает значение по умолчанию для локали.

Возвращает

string|null

getDiffFormatter() public static

getDiffFormatter(): Cake\Chronos\DifferenceFormatterInterface

Получает экземпляр форматировщика разницы.

Возвращает

Cake\Chronos\DifferenceFormatterInterface

getLastErrors() public static

getLastErrors(): array

Возвращает любые ошибки или предупреждения, которые были обнаружены во время парсинга последнего объекта, созданного этим классом.

Возвращает

array

getTestNow() public static

getTestNow(): Cake\Chronos\ChronosInterface|null

Получает тестовый экземпляр, хранящийся в Chronos

greaterThan(Cake\Chronos\ChronosInterface $dt): bool

Определяет, больше ли экземпляр (после) другого

Параметры

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Возвращает

bool

greaterThanOrEquals() public

greaterThanOrEquals(Cake\Chronos\ChronosInterface $dt): bool

Определяет, больше ли или равно экземпляр (после) другому

Параметры

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Возвращает

bool

gt() public

gt(Cake\Chronos\ChronosInterface $dt): bool

Определяет, больше ли экземпляр (после) другого

Параметры

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Возвращает

bool

См. также

greaterThan

gte() public

gte(Cake\Chronos\ChronosInterface $dt): bool

Определяет, больше ли или равно экземпляр (после) другому

Параметры

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Возвращает

bool

См. также

greaterThanOrEquals

hasRelativeKeywords() public static

hasRelativeKeywords(string|null $time): bool

Определить, есть ли относительное ключевое слово в строке времени, это для создания дат, относящихся к текущему моменту для тестовых экземпляров. Пример: следующая среда

Параметры

string|null $time: Строка времени для проверки.

Возвращает

bool

hasTestNow() public static

hasTestNow(): bool

Получить, установлен ли в Chronos тестовый экземпляр.

Возвращает

bool

См. также

\Cake\Chronos\Chronos::hasTestNow()

hour() public

hour(int $value): static

Установить час экземпляра

Параметры

int $value: Значение часа.

Возвращает

static

i18nFormat() public

i18nFormat(string|int|null $format = null, DateTimeZone|string|null $timezone = null, string|null $locale = null): string|int

Возвращает отформатированную строку для этого объекта времени с использованием предпочтительного формата и языка для указанного региона.

Можно указать желаемый формат отображаемой строки. Можно передать константы IntlDateFormatter в качестве первого аргумента этой функции или передать полную строку форматирования даты ICU, как указано в следующих ресурсах: https://unicode-org.github.io/icu/userguide/format_parse/datetime/#datetime-format-syntax.

В дополнение к константам IntlDateFormatter и строке форматирования даты можно использовать Time::UNIX_TIMESTAMP_FORMAT для получения отметки времени Unix

Примеры

$time = new Time('2014-04-20 22:10');
$time->i18nFormat(); // outputs '4/20/14, 10:10 PM' for the en-US locale
$time->i18nFormat(\IntlDateFormatter::FULL); // Use the full date and time format
$time->i18nFormat([\IntlDateFormatter::FULL, \IntlDateFormatter::SHORT]); // Use full date but short time format
$time->i18nFormat('yyyy-MM-dd HH:mm:ss'); // outputs '2014-04-20 22:10'
$time->i18nFormat(Time::UNIX_TIMESTAMP_FORMAT); // outputs '1398031800'

Можно управлять используемым по умолчанию форматом с помощью Time::setToStringFormat().

Можно узнать о доступных константах IntlDateFormatter на https://secure.php.net/manual/en/class.intldateformatter.php

Если вам нужно отобразить дату в часовом поясе, отличном от используемого для этого объекта Time, без изменения его внутреннего состояния, можно передать строку или объект часового пояса в качестве второго параметра.

Наконец, если вам нужно использовать другой регион для отображения этого объекта времени, передайте строку региона в качестве третьего параметра этой функции.

Примеры

$time = new Time('2014-04-20 22:10');
$time->i18nFormat(null, null, 'de-DE');
$time->i18nFormat(\IntlDateFormatter::FULL, 'Europe/Berlin', 'de-DE');

Можно управлять используемым по умолчанию регионом с помощью Time::setDefaultLocale(). Если он пуст, он будет взят из ini-конфигурации intl.default_locale.

Параметры

string|int|null $format optional: Строка формата.
DateTimeZone|string|null $timezone optional: Строка часового пояса или объект DateTimeZone, в котором будет отображаться дата. Часовой пояс, сохраненный для этого объекта, не будет изменён.
string|null $locale optional: Имя региона, в котором должна отображаться дата (например, pt-BR).

Возвращает

string|int

instance() public static

instance(DateTimeInterface $dt): static

Создать экземпляр ChronosInterface из экземпляра DateTimeInterface

Параметры

DateTimeInterface $dt: Экземпляр даты и времени для преобразования.

Возвращает

static

isBirthday() public

isBirthday(Cake\Chronos\ChronosInterface $dt): bool

Проверить, день ли рождения. Сравнивает значения даты/месяца двух дат.

Параметры

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Возвращает

bool

isFriday() public

isFriday(): bool

Проверяет, является ли этот день пятницей.

Возвращает

bool

isFuture() public

isFuture(): bool

Определяет, находится ли экземпляр в будущем, то есть больше (после) текущего момента

Возвращает

bool

isLastMonth() public

isLastMonth(): bool

Определяет, находится ли экземпляр в прошлом месяце

Возвращает

bool

isLastWeek() public

isLastWeek(): bool

Определяет, находится ли экземпляр в прошлой неделе

Возвращает

bool

isLastYear() public

isLastYear(): bool

Определяет, находится ли экземпляр в прошлом году

Возвращает

bool

isLeapYear() public

isLeapYear(): bool

Определяет, является ли экземпляр високосным годом

Возвращает

bool

isMonday() public

isMonday(): bool

Проверяет, является ли этот день понедельником.

Возвращает

bool

isMutable() public

isMutable(): bool

Проверить, является ли экземпляр ChronosInterface изменяемым.

Возвращает

bool

isNextMonth() public

isNextMonth(): bool

Определяет, находится ли экземпляр в следующем месяце

Возвращает

bool

isNextWeek() public

isNextWeek(): bool

Определяет, находится ли экземпляр в следующей неделе

Возвращает

bool

isNextYear() public

isNextYear(): bool

Определяет, находится ли экземпляр в следующем году

Возвращает

bool

isPast() public

isPast(): bool

Определяет, находится ли экземпляр в прошлом, т.е. меньше (раньше), чем сейчас

Возвращает

bool

isSameDay() public

isSameDay(Cake\Chronos\ChronosInterface $dt): bool

Проверяет, является ли переданная дата тем же днем, что и текущий день экземпляра.

Параметры

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Возвращает

bool

isSaturday() public

isSaturday(): bool

Проверяет, является ли этот день субботой.

Возвращает

bool

isSunday() public

isSunday(): bool

Проверяет, является ли этот день воскресеньем.

Возвращает

bool

isThisMonth() public

isThisMonth(): bool

Возвращает true, если этот объект представляет дату текущего месяца

Возвращает

bool

isThisWeek() public

isThisWeek(): bool

Возвращает true, если этот объект представляет дату текущей недели

Возвращает

bool

isThisYear() public

isThisYear(): bool

Возвращает true, если этот объект представляет дату текущего года

Возвращает

bool

isThursday() public

isThursday(): bool

Проверяет, является ли этот день четвергом.

Возвращает

bool

isToday() public

isToday(): bool

Определяет, является ли экземпляр сегодняшним днем

Возвращает

bool

isTomorrow() public

isTomorrow(): bool

Определяет, является ли экземпляр завтрашним днем

Возвращает

bool

isTuesday() public

isTuesday(): bool

Проверяет, является ли этот день вторником.

Возвращает

bool

isWednesday() public

isWednesday(): bool

Проверяет, является ли этот день средой.

Возвращает

bool

isWeekday() public

isWeekday(): bool

Определяет, является ли экземпляр будним днем

Возвращает

bool

isWeekend() public

isWeekend(): bool

Определяет, является ли экземпляр выходным днем

Возвращает

bool

isWithinNext() public

isWithinNext(string|int $timeInterval): bool

Возвращает true, если этот экземпляр произойдёт в течение указанного интервала

Параметры

string|int $timeInterval: числовое значение со временем. Примеры допустимых типов: 6 часов, 2 дня, 1 минута.

Возвращает

bool

isYesterday() public

isYesterday(): bool

Определяет, является ли экземпляр вчерашним днём

Возвращает

bool

jsonSerialize() public

jsonSerialize(): string|int

Возвращает строку, которая должна быть сериализована при преобразовании этого объекта в JSON

Возвращает

string|int

lastOfMonth() public

lastOfMonth(int|null $dayOfWeek = null): mixed

Изменяет на последнее вхождение заданного дня недели в текущем месяце. Если dayOfWeek не указан, меняет на последний день текущего месяца. Используйте предоставленные константы для указания желаемого дня недели, например static::MONDAY.

Параметры

int|null $dayOfWeek optional: День недели для изменения.

Возвращает

mixed

lastOfQuarter() public

lastOfQuarter(int|null $dayOfWeek = null): mixed

Изменяет на последнее вхождение заданного дня недели в текущем квартале. Если dayOfWeek не указан, меняет на последний день текущего квартала. Используйте предоставленные константы для указания желаемого дня недели, например static::MONDAY.

Параметры

int|null $dayOfWeek optional: День недели для изменения.

Возвращает

mixed

lastOfYear() public

lastOfYear(int|null $dayOfWeek = null): mixed

Изменяет на последнее вхождение заданного дня недели в текущем году. Если dayOfWeek не указан, меняет на последний день текущего года. Используйте предоставленные константы для указания желаемого дня недели, например static::MONDAY.

Параметры

int|null $dayOfWeek optional: День недели для изменения.

Возвращает

mixed

lenientParsingEnabled() public static

lenientParsingEnabled(): bool

Получает, установлена ли распарсивание форматов в режиме lenient.

Возвращает

bool

lessThan() public

lessThan(Cake\Chronos\ChronosInterface $dt): bool

Определяет, является ли экземпляр меньше (раньше), чем другой

Параметры

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Возвращает

bool

lessThanOrEquals() public

lessThanOrEquals(Cake\Chronos\ChronosInterface $dt): bool

Определяет, является ли экземпляр меньше (раньше) или равен другому

Параметры

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Возвращает

bool

listTimezones() public static

listTimezones(string|int|null $filter = null, string|null $country = null, array<string, mixed>|bool $options = []): array

Получение списка идентификаторов часовых поясов

Параметры

string|int|null $filter optional: Регулярное выражение для фильтрации идентификатора или одна из констант класса DateTimeZone
string|null $country optional: Двухбуквенный код страны, совместимый с ISO 3166-1. Этот параметр используется только при $filter установлено в DateTimeZone::PER_COUNTRY
array<string, mixed>|bool $options optional: Если true (значение по умолчанию), группирует идентификаторы по основному региону. В противном случае массив, содержащий ключи group, abbr, before, и after. Установка group и abbr в true сгруппирует результаты и добавит аббревиатуру часового пояса в значение отображения. Установка before и after позволит настроить обертывание аббревиатуры.

Возвращает

array

lt() public

lt(Cake\Chronos\ChronosInterface $dt): bool

Определяет, является ли экземпляр меньше (раньше), чем другой

Параметры

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Возвращает

bool

См. также

lessThan

lte() public

lte(Cake\Chronos\ChronosInterface $dt): bool

Определяет, меньше ли экземпляр (раньше) или равен другому

Parameters

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Returns

bool

max() public

max(Cake\Chronos\ChronosInterface|null $dt = null): static

Получить максимальный экземпляр между заданным экземпляром (по умолчанию сейчас) и текущим экземпляром.

Parameters

Cake\Chronos\ChronosInterface|null $dt optional: Экземпляр для сравнения.

Returns

static

maxValue() public static

maxValue(): Cake\Chronos\ChronosInterface

Создать экземпляр ChronosInterface для наибольшей поддерживаемой даты.

Returns

Cake\Chronos\ChronosInterface

microsecond() public

microsecond(int $value): static

Установить микросекунды экземпляра

Parameters

int $value: Значение микросекунд.

Returns

static

min() public

min(Cake\Chronos\ChronosInterface|null $dt = null): static

Получить минимальный экземпляр между заданным экземпляром (по умолчанию сейчас) и текущим экземпляром.

Parameters

Cake\Chronos\ChronosInterface|null $dt optional: Экземпляр для сравнения.

Returns

static

minValue() public static

minValue(): Cake\Chronos\ChronosInterface

Создать экземпляр ChronosInterface для наименьшей поддерживаемой даты.

Returns

Cake\Chronos\ChronosInterface

minute() public

minute(int $value): static

Установить минуты экземпляра

Parameters

int $value: Значение минут.

Returns

static

modify() public @method

modify(string $relative): Cake\Chronos\ChronosInterface

Parameters

string $relative

Returns

Cake\Chronos\ChronosInterface

month() public

month(int $value): static

Установить месяц экземпляра

Parameters

int $value: Значение месяца.

Returns

static

ne() public

ne(Cake\Chronos\ChronosInterface $dt): bool

Определяет, не равен ли экземпляр другому

Parameters

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Returns

bool

next() public

next(int|null $dayOfWeek = null): mixed

Изменить на следующее вхождение заданного дня недели. Если dayOfWeek не указан, изменить на следующее вхождение текущего дня недели. Используйте предоставленные константы для указания желаемого dayOfWeek, например, static::MONDAY.

Parameters

int|null $dayOfWeek optional: День недели, на который нужно перейти.

Returns

mixed

nice() public

nice(DateTimeZone|string|null $timezone = null, string|null $locale = null): string

Возвращает строку даты в удобном формате для этого объекта.

Используемый формат хранится в статическом свойстве Time::niceFormat.

Parameters

DateTimeZone|string|null $timezone optional: Строка часового пояса или объект DateTimeZone, в котором будет отображаться дата. Часовой пояс, сохранённый для этого объекта, не будет изменён.
string|null $locale optional: Имя локали, в которой должна отображаться дата (например, pt-BR)

Returns

string

notEquals() public

notEquals(Cake\Chronos\ChronosInterface $dt): bool

Определяет, не равен ли экземпляр другому

Parameters

Cake\Chronos\ChronosInterface $dt: Экземпляр для сравнения.

Returns

bool

now() public static

now(DateTimeZone|string|null $tz): static

Получить экземпляр ChronosInterface для текущей даты и времени

Parameters

DateTimeZone|string|null $tz: Объект DateTimeZone или имя часового пояса.

Returns

static

nthOfMonth() public

nthOfMonth(int $nth, int $dayOfWeek): mixed

Изменить на заданное вхождение заданного дня недели в текущем месяце. Если вычисленное вхождение выходит за пределы текущего месяца, то вернуть false и никаких изменений не будет внесено. Используйте предоставленные константы для указания желаемого dayOfWeek, например, static::MONDAY.

Parameters

int $nth: Смещение для использования.
int $dayOfWeek: День недели, на который нужно перейти.

Returns

mixed

nthOfQuarter() public

nthOfQuarter(int $nth, int $dayOfWeek): mixed

Изменить на заданное вхождение заданного дня недели в текущем квартале. Если вычисленное вхождение выходит за пределы текущего квартала, то вернуть false и никаких изменений не будет внесено. Используйте предоставленные константы для указания желаемого dayOfWeek, например, static::MONDAY.

Parameters

int $nth: Смещение для использования.
int $dayOfWeek: День недели, на который нужно перейти.

Returns

mixed

nthOfYear() public

nthOfYear(int $nth, int $dayOfWeek): mixed

Изменить на заданное вхождение заданного дня недели в текущем году. Если вычисленное вхождение выходит за пределы текущего года, то вернуть false и никаких изменений не будет внесено. Используйте предоставленные константы для указания желаемого dayOfWeek, например, static::MONDAY.

Parameters

int $nth: Смещение для использования.
int $dayOfWeek: День недели, на который нужно перейти.

Returns

mixed

parse() public static

parse(DateTimeInterface|string|int $time = 'now', DateTimeZone|string|null $tz = null): static

Создать экземпляр ChronosInterface из строки. Это псевдоним для конструктора, который позволяет лучше использовать флуентный синтаксис, так как позволяет вам сделать ChronosInterface::parse('Monday next week')->fn() вместо (new Chronos('Monday next week'))->fn()

Parameters

DateTimeInterface|string|int $time optional: Строка, совместимая с strtotime, для парсинга
DateTimeZone|string|null $tz optional: Объект DateTimeZone или имя часового пояса.

Returns

static

parseDate() public static

parseDate(string $date, array|string|int|null $format = null): static|null

Возвращает новый объект Time после разбора предоставленной строки $date, основываясь на переданном или настроенном формате даты и времени. Этот метод зависит от локали; любая строка, переданная этой функции, будет интерпретироваться как строка, зависящая от локали.

Если $format не указан, используется формат wordFormat.

Если предоставленное время невозможно разобрать, будет возвращено null.

Пример:

$time = Time::parseDate('10/13/2013');
 $time = Time::parseDate('13 Oct, 2013', 'dd MMM, y');
 $time = Time::parseDate('13 Oct, 2013', IntlDateFormatter::SHORT);

Параметры

string $date: Строка даты для разбора.
array|string|int|null $format необязательно: Любой формат, принимаемый IntlDateFormatter.

Возвращает

static|null

parseDateTime() public static

parseDateTime(string $time, array<int>|string|null $format = null, DateTimeZone|string|null $tz = null): static|null

Возвращает новый объект Time после разбора переданной строки времени, основываясь на переданном или настроенном формате даты и времени. Этот метод зависит от локали; любая строка, переданная этой функции, будет интерпретироваться как строка, зависящая от локали.

Если $format не указан, используется формат toString.

В отличие от DateTime, часовой пояс возвращаемого экземпляра всегда преобразуется в $tz (по умолчанию, если null), даже если в строке $time был указан часовой пояс. Это ограничение IntlDateFormatter.

Если предоставленное время невозможно разобрать, будет возвращено null.

Пример:

$time = Time::parseDateTime('10/13/2013 12:54am');
 $time = Time::parseDateTime('13 Oct, 2013 13:54', 'dd MMM, y H:mm');
 $time = Time::parseDateTime('10/10/2015', [IntlDateFormatter::SHORT, IntlDateFormatter::NONE]);

Параметры

string $time: Строка времени для разбора.
array<int>|string|null $format необязательно: Любой формат, принимаемый IntlDateFormatter.
DateTimeZone|string|null $tz необязательно: Часовой пояс для экземпляра

Возвращает

static|null

parseTime() public static

parseTime(string $time, string|int|null $format = null): static|null

Возвращает новый объект Time после разбора предоставленной строки $time, основываясь на переданном или настроенном формате даты и времени. Этот метод зависит от локали; любая строка, переданная этой функции, будет интерпретироваться как строка, зависящая от локали.

Если $format не указан, используется формат IntlDateFormatter::SHORT.

Если предоставленное время невозможно разобрать, будет возвращено null.

Пример:

$time = Time::parseTime('11:23pm');

Параметры

string $time: Строка времени для разбора.
string|int|null $format необязательно: Любой формат, принимаемый IntlDateFormatter.

Возвращает

static|null

previous() public

previous(int|null $dayOfWeek = null): mixed

Изменяет на предыдущее вхождение заданного дня недели. Если dayOfWeek не указан, изменяется на предыдущее вхождение текущего дня недели. Используйте предоставленные константы для указания желаемого дня недели, например, static::MONDAY.

Параметры

int|null $dayOfWeek необязательно: День недели, на который нужно переместиться.

Возвращает

mixed

resetToStringFormat() public static

resetToStringFormat(): void

Сбрасывает формат до значения по умолчанию при преобразовании экземпляра этого типа в строку

Возвращает

void

safeCreateDateTimeZone() protected static

safeCreateDateTimeZone(DateTimeZone|string|null $object): DateTimeZone

Создает DateTimeZone из строки или DateTimeZone

Параметры

DateTimeZone|string|null $object: Значение для преобразования.

Возвращает

DateTimeZone

Исключения

InvalidArgumentException

second() public

second(int $value): static

Устанавливает секунды экземпляра.

Параметры

int $value: Значение секунд.

Возвращает

static

secondsSinceMidnight() public

secondsSinceMidnight(): int

Количество секунд с полуночи.

Возвращает

int

secondsUntilEndOfDay() public

secondsUntilEndOfDay(): int

Количество секунд до 23:59:59.

Возвращает

int

setDate() public

setDate(int $year, int $month, int $day): static

Устанавливает дату на другую.

Обходной путь для ошибки PHP, связанной с первым днем месяца.

Параметры

int $year: Год для установки.
int $month: Месяц для установки.
int $day: День для установки.

Возвращает

static

setDateTime() public

setDateTime(int $year, int $month, int $day, int $hour, int $minute, int $second = 0): static

Устанавливает дату и время вместе.

Параметры

int $year: Год для установки.
int $month: Месяц для установки.
int $day: День для установки.
int $hour: Час для установки.
int $minute: Минута для установки.
int $second необязательно: Секунда для установки.

Возвращает

static

setDefaultLocale() public static

setDefaultLocale(string|null $locale = null): void

Устанавливает локаль по умолчанию.

Установите в null, чтобы использовать значение по умолчанию IntlDateFormatter.

Параметры

string|null $locale необязательно: Строка локали по умолчанию для использования.

Возвращает

void

setDiffFormatter() public static

setDiffFormatter(Cake\Chronos\DifferenceFormatterInterface $formatter): void

Устанавливает экземпляр форматировщика разницы.

Параметры

Cake\Chronos\DifferenceFormatterInterface $formatter: Экземпляр форматировщика при установке.

Возвращает

void

setJsonEncodeFormat() public static

setJsonEncodeFormat(Closure|array|string|int $format): void

Устанавливает формат по умолчанию, используемый при преобразовании этого объекта в JSON

Формат должен быть либо константами форматирования из IntlDateFormatter, как описано в (https://secure.php.net/manual/en/class.intldateformatter.php), либо шаблоном, как указано в (http://www.icu-project.org/apiref/icu4c/classSimpleDateFormat.html#details)

Можно указать массив из 2 констант. В этом случае первая позиция будет использоваться для форматирования части даты объекта, а вторая позиция - для форматирования части времени.

В качестве альтернативы, формат может содержать коллбек. В этом случае коллбек может принять этот объект datetime и вернуть отформатированную строку.

Параметры

Closure|array|string|int $format

Возвращает

void

setTestNow() public static

setTestNow(Cake\Chronos\ChronosInterface|string|null $testNow = null): void

Устанавливает test now, используемый классами Date и Time, предоставляемыми Chronos

Параметры

Cake\Chronos\ChronosInterface|string|null $testNow необязательно: Экземпляр для использования во всех будущих экземплярах.

Возвращает

void

См. также

\Cake\Chronos\Chronos::setTestNow()

setTimeFromTimeString() public

setTimeFromTimeString(string $time): static

Установить время по строке

Параметры

string $time: Время в виде строки.

Возвращаемое значение

static

setTimezone() public

setTimezone(DateTimeZone|string $value): static

Установить часовой пояс экземпляра из строки или объекта

Параметры

DateTimeZone|string $value: Объект DateTimeZone или имя часового пояса для использования.

Возвращаемое значение

static

setToStringFormat() public static

setToStringFormat(string $format): void

Устанавливает формат по умолчанию, используемый при преобразовании экземпляров этого типа в строку

Можно указать массив из 2 констант. В этом случае, первая позиция будет использоваться для форматирования даты объекта, а вторая — для форматирования времени.

Параметры

string $format: Формат.

Возвращаемое значение

void

setWeekEndsAt() public static

setWeekEndsAt(int $day): void

Установить последний день недели

Параметры

int $day: День, на котором заканчивается неделя.

Возвращаемое значение

void

setWeekStartsAt() public static

setWeekStartsAt(int $day): void

Установить первый день недели

Параметры

int $day: День, на котором начинается неделя.

Возвращаемое значение

void

setWeekendDays() public static

setWeekendDays(array $days): void

Установить выходные дни

Параметры

array $days: Какие дни являются выходными.

Возвращаемое значение

void

startOfCentury() public

startOfCentury(): static

Сбрасывает дату на первый день столетия, а время — на 00:00:00

Возвращаемое значение

static

startOfDay() public

startOfDay(): static

Сбрасывает время на 00:00:00

Возвращаемое значение

static

startOfDecade() public

startOfDecade(): static

Сбрасывает дату на первый день десятилетия, а время — на 00:00:00

Возвращаемое значение

static

startOfMonth() public

startOfMonth(): static

Сбрасывает дату на первый день месяца, а время — на 00:00:00

Возвращаемое значение

static

startOfWeek() public

startOfWeek(): static

Сбрасывает дату на первый день недели (определенный в $weekStartsAt), а время — на 00:00:00

Возвращаемое значение

static

startOfYear() public

startOfYear(): static

Сбрасывает дату на первый день года, а время — на 00:00:00

Возвращаемое значение

static

subDay() public

subDay(int $value = 1): static

Удалить день из экземпляра

Параметры

int $value optional: Количество дней для удаления.

Возвращаемое значение

static

subDays() public

subDays(int $value): static

Удалить дни из экземпляра

Параметры

int $value: Количество дней для удаления.

Возвращаемое значение

static

subHour() public

subHour(int $value = 1): static

Удалить час из экземпляра

Параметры

int $value optional: Количество часов для удаления.

Возвращаемое значение

static

subHours() public

subHours(int $value): static

Удалить часы из экземпляра

Параметры

int $value: Количество часов для удаления.

Возвращаемое значение

static

subMinute() public

subMinute(int $value = 1): static

Удалить минуту из экземпляра

Параметры

int $value optional: Количество минут для удаления.

Возвращаемое значение

static

subMinutes() public

subMinutes(int $value): static

Удалить минуты из экземпляра

Параметры

int $value: Количество минут для удаления.

Возвращаемое значение

static

subMonth() public

subMonth(int $value = 1): static

Удалить месяц из экземпляра

Имеет такое же поведение, как addMonths().

Параметры

int $value optional: Количество месяцев для удаления.

Возвращаемое значение

static

subMonthWithOverflow() public

subMonthWithOverflow(int $value = 1): static

Удалить месяц с переполнением из экземпляра.

Имеет такое же поведение, как addMonthsWithOverflow().

Параметры

int $value optional: Количество месяцев для удаления.

Возвращаемое значение

static

subMonths() public

subMonths(int $value): static

Удалить месяцы из экземпляра.

Имеет такое же поведение, как addMonths().

Параметры

int $value: Количество месяцев для удаления.

Возвращаемое значение

static

subMonthsWithOverflow() public

subMonthsWithOverflow(int $value): static

Удалить месяцы с переполнением из экземпляра.

Имеет такое же поведение, как addMonthsWithOverflow().

Параметры

int $value: Количество месяцев для удаления.

Возвращаемое значение

static

subSecond() public

subSecond(int $value = 1): static

Удалить секунду из экземпляра

Параметры

int $value optional: Количество секунд для удаления.

Возвращаемое значение

static

subSeconds() public

subSeconds(int $value): static

Удалить секунды из экземпляра

Параметры

int $value: Количество секунд для удаления.

Возвращает

static

subWeek() public

subWeek(int $value = 1): static

Удалить неделю из экземпляра

Параметры

int $value опционально: Количество недель для удаления.

Возвращает

static

subWeekday() public

subWeekday(int $value = 1): static

Удалить рабочий день из экземпляра

Параметры

int $value опционально: Количество рабочих дней для удаления.

Возвращает

static

subWeekdays() public

subWeekdays(int $value): static

Удалить рабочие дни из экземпляра

Параметры

int $value: Количество рабочих дней для удаления.

Возвращает

static

subWeeks() public

subWeeks(int $value): static

Удалить недели из экземпляра

Параметры

int $value: Количество недель для удаления.

Возвращает

static

subYear() public

subYear(int $value = 1): static

Удалить год из экземпляра.

Имеет такое же поведение, как addYears().

Параметры

int $value опционально: Количество лет для удаления.

Возвращает

static

subYearWithOverflow() public

subYearWithOverflow(int $value = 1): static

Удалить год с переполнением из экземпляра

Имеет такое же поведение, как addYearsWithOverflow().

Параметры

int $value опционально: Количество лет для удаления.

Возвращает

static

subYears() public

subYears(int $value): static

Удалить годы из экземпляра.

Имеет такое же поведение, как addYears().

Параметры

int $value: Количество лет для удаления.

Возвращает

static

subYearsWithOverflow() public

subYearsWithOverflow(int $value): static

Удалить годы с переполнением из экземпляра

Имеет такое же поведение, как addYearsWithOverflow().

Параметры

int $value: Количество лет для удаления.

Возвращает

static

timeAgoInWords() public

timeAgoInWords(array<string, mixed> $options = []): string

Возвращает относительную или отформатированную абсолютную дату в зависимости от разницы между текущим временем и этим объектом.

Параметры:

from => другой объект Time, представляющий текущее время
format => формат по умолчанию, если относительное время больше, чем указано в end
accuracy => Указывает, насколько точно должна описываться дата (массив)
- year => Формат, если years > 0 (по умолчанию "день")
- month => Формат, если months > 0 (по умолчанию "день")
- week => Формат, если weeks > 0 (по умолчанию "день")
- day => Формат, если weeks > 0 (по умолчанию "час")
- hour => Формат, если hours > 0 (по умолчанию "минута")
- minute => Формат, если minutes > 0 (по умолчанию "минута")
- second => Формат, если seconds > 0 (по умолчанию "секунда")
end => Конец относительного времени
relativeString => Строка, совместимая с printf, при выводе относительного времени
absoluteString => Строка, совместимая с printf, при выводе абсолютного времени
timezone => Временная зона пользователя, в которой должен быть отформатирован отметка времени.

Относительные даты выглядят примерно так:

3 недели, 4 дня назад
15 секунд назад

Форматирование даты по умолчанию - дд/мм/гггг, например: 18/02/2009. Форматирование выполняется внутри с помощью i18nFormat, см. метод для допустимых строк форматирования

Возвращаемая строка включает 'назад' или 'в' и предполагает, что вы правильно добавите слово, например, 'Опубликовано ' перед результатом функции.

ПРИМЕЧАНИЕ: Если разница составляет одну неделю или больше, то точность отображения будет минимальной - день.

Параметры

array<string, mixed> $options опционально: Массив параметров.

Возвращает

string

timestamp() public

timestamp(int $value): static

Установить метку времени экземпляра

Параметры

int $value: Значение отметки времени для установки.

Возвращает

static

timezone() public

timezone(DateTimeZone|string $value): static

Псевдоним для setTimezone()

Параметры

DateTimeZone|string $value: Объект DateTimeZone или имя временной зоны для использования.

Возвращает

static

toAtomString() public

toAtomString(): string

Отформатировать экземпляр как ATOM

Возвращает

string

toCookieString() public

toCookieString(): string

Отформатировать экземпляр как COOKIE

Возвращает

string

toDateString() public

toDateString(): string

Отформатировать экземпляр как дату

Возвращает

string

toDateTimeString() public

toDateTimeString(): string

Отформатировать экземпляр как дату и время

Возвращает

string

toDayDateTimeString() public

toDayDateTimeString(): string

Отформатировать экземпляр с днём, датой и временем

Возвращает

string

toFormattedDateString() public

toFormattedDateString(): string

Отформатировать экземпляр как читаемую дату

Возвращает

string

toImmutable() public

toImmutable(): Cake\Chronos\Chronos

Создать новый неизменяемый экземпляр из текущего изменяемого экземпляра.

Возвращает

Cake\Chronos\Chronos

toIso8601String() public

toIso8601String(): string

Отформатировать экземпляр как ISO8601

Возвращает

string

toQuarter() public

toQuarter(bool $range = false): array<string>|int

Возвращает квартал

Параметры

bool $range опционально: Диапазон.

Возвращает

array<string>|int

toRfc1036String() public

toRfc1036String(): string

Отформатировать экземпляр как RFC1036

Возвращает

string

toRfc1123String() public

toRfc1123String(): string

Форматировать экземпляр как RFC1123

Возвращает

string

toRfc2822String() public

toRfc2822String(): string

Форматировать экземпляр как RFC2822

Возвращает

string

toRfc3339String() public

toRfc3339String(): string

Форматировать экземпляр как RFC3339

Возвращает

string

toRfc822String() public

toRfc822String(): string

Форматировать экземпляр как RFC822

Возвращает

string

toRfc850String() public

toRfc850String(): string

Форматировать экземпляр как RFC850

Возвращает

string

toRssString() public

toRssString(): string

Форматировать экземпляр как RSS

Возвращает

string

toTimeString() public

toTimeString(): string

Форматировать экземпляр как время

Возвращает

string

toUnixString() public

toUnixString(): string

Возвращает метку времени UNIX.

Возвращает

string

toW3cString() public

toW3cString(): string

Форматировать экземпляр как W3C

Возвращает

string

toWeek() public

toWeek(): int

Возвращает

int

today() public static

today(DateTimeZone|string|null $tz = null): static

Создать экземпляр ChronosInterface для текущего дня

Параметры

DateTimeZone|string|null $tz optional: Часовой пояс для использования.

Возвращает

static

tomorrow() public static

tomorrow(DateTimeZone|string|null $tz = null): static

Создать экземпляр ChronosInterface для завтрашнего дня

Параметры

DateTimeZone|string|null $tz optional: Объект DateTimeZone или имя часового пояса, который должен использоваться новым экземпляром.

Возвращает

static

tz() public

tz(DateTimeZone|string $value): static

Псевдоним для setTimezone()

Параметры

DateTimeZone|string $value: Объект DateTimeZone или имя часового пояса для использования.

Возвращает

static

wasWithinLast() public

wasWithinLast(string|int $timeInterval): bool

Возвращает true, если этот экземпляр произошел в указанном интервале

Параметры

string|int $timeInterval: Числовое значение со временем. Пример допустимых типов: 6 часов, 2 дня, 1 минута.

Возвращает

bool

year() public

year(int $value): static

Установить год экземпляра

Параметры

int $value: Значение года.

Возвращает

static

yesterday() public static

yesterday(DateTimeZone|string|null $tz = null): static

Создать экземпляр ChronosInterface для вчерашнего дня

Параметры

DateTimeZone|string|null $tz optional: Объект DateTimeZone или имя часового пояса, который должен использоваться новым экземпляром.

Возвращает

static

Подробное описание свойства

`$_formatters` protected static

Кэш форматировщиков дат в памяти

Тип

arrayIntlDateFormatter>

`$_jsonEncodeFormat` protected static

Формат, используемый при преобразовании этого объекта в JSON.

Тип

int

`$dayOfWeek` public @property-read

от 1 (понедельник) до 7 (воскресенье)

Тип

int

`$dayOfWeekName` public @property-read

Тип

int

`$lenientParsing` protected static

Включено ли нестрогое разбор IntlDateFormatter.

По умолчанию true, что соответствует значению по умолчанию для IntlDateFormatter.

Тип

bool

`$local` public @property-read

Проверяет, является ли часовой пояс локальным, true, если локальный, иначе false

Тип

bool

`$micro` public @property-read

Тип

int

`$microsecond` public @property-read

Тип

int

`$minute` public @property-read

Тип

int

`$month` public @property-read

int

`$timestamp` public @property-read

секунды, прошедшие с эпохи Unix

Тип

int

`$timezone` public @property-read

текущая часовая зона

Тип

DateTimeZone|string

`$timezoneName` public @property-read

Тип

int

`$yearIso` public @property-read

Тип

int

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.3/class-Cake.I18n.Time.html

Класс Time

Константы

Краткое описание свойств

Краткое описание методов

__construct() public

__debugInfo() public

__get() public

__isset() public

__set() public

__toString() public

_formatObject() protected

addDay() public

addDays() public

addHour() public

addHours() public

addMinute() public

addMinutes() public

addMonth() public

addMonthWithOverflow() public

addMonths() public

addMonthsWithOverflow() public

addSecond() public

addSeconds() public

addWeek() public

addWeekday() public

addWeekdays() public

addWeeks() public

addYear() public

addYearWithOverflow() public

addYears() public

addYearsWithOverflow() public

average() public

between() public

closest() public

copy() public

create() public static

createFromArray() public static

createFromDate() public static

createFromFormat() public static

createFromTime() public static

createFromTimestamp() public static

createFromTimestampUTC() public static

day() public

diffFiltered() public

diffForHumans() public

diffFormatter() public static

diffInDays() public

diffInDaysFiltered() public

diffInHours() public

diffInHoursFiltered() public

diffInMinutes() public

diffInMonths() public

diffInMonthsIgnoreTimezone() public

diffInSeconds() public

diffInWeekdays() public

diffInWeekendDays() public

diffInWeeks() public

diffInYears() public

disableLenientParsing() public static

enableLenientParsing() public static

endOfCentury() public

endOfDay() public

endOfDecade() public

endOfMonth() public

endOfWeek() public

endOfYear() public

eq() public

equals() public

farthest() public

firstOfMonth() public

firstOfQuarter() public

firstOfYear() public

fromNow() public static

getDefaultLocale() public static

getDiffFormatter() public static

getLastErrors() public static

getTestNow() public static

getWeekEndsAt() public static

getWeekStartsAt() public static

getWeekendDays() public static

Класс
Time