Класс FrozenTime

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

Этот объект предоставляет неизменяемый вариант {@link \Cake\I18n\Time}

Пространство имён: Cake\I18n

Константы

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
```

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

$_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\FrozenTime::i18nFormat() и __toString. Этот формат также используется parseDateTime().
$age public @property-read

int

Вычисляет разницу в годах с использованием параметров по умолчанию.
$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

Включено ли мягкое разбор для 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\FrozenTime::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
$testNow protected static

Cake\Chronos\ChronosInterface|null

Экземпляр ChronosInterface для тестирования, возвращаемый при создании экземпляров now
$timestamp public @property-read

int

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

DateTimeZone

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

string
$toStringFormat protected static

string

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

DateTimeZone

Псевдоним часового пояса
$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\FrozenTime::timeAgoInWords() и разница больше Cake\I18n\FrozenTime::$wordEnd
$year public @property-read

int
$yearIso public @property-read

int

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

__construct() public

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

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

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

Проверить, существует ли атрибут в объекте.
__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

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

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

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

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

Получить локаль по умолчанию.
getDiffFormatter() public static

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

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

Получить экземпляр ChronosInterface (реальный или эмулированный), который будет возвращен при создании экземпляра "now".
getWeekEndsAt() public static

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

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

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

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

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

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

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

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

Определяет, установлен ли действительный тестовый экземпляр. Действительный тестовый экземпляр — это любой экземпляр, который не равен null.
hour() public

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

Возвращает отформатированную строку для этого объекта времени, используя предпочтительный формат и язык для указанной локали.
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

Получить, установлено ли для парсинга формата локали значение lenient.
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 для текущей даты и времени
nthOfMonth() public

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

END_OF_DOCUMENT_MARKER

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
Установить экземпляр ChronosInterface (реальный или имитационный), который будет возвращаться при создании экземпляра "текущее время". Предоставленный экземпляр будет возвращен в следующих условиях:
- Вызов статического метода now(), например ChronosInterface::now()
- При передаче null (или пустой строки) в конструктор или parse(), например new Chronos(null)
- При передаче строки "now" в конструктор или parse(), например new Chronos('now')
- При передаче строки с желаемым временем в ChronosInterface::parse()
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

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

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

Создать новый изменяемый экземпляр из текущего неизменяемого экземпляра.
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

__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 необязательно: Количество лет для добавления.

Возвращает

static

addYearWithOverflow() public

addYearWithOverflow(int $value = 1): static

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

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

Параметры

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

Возвращает

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 необязательно: Экземпляр для сравнения.

Возвращает

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 необязательно: Указывает, следует ли использовать сравнение > и < или <= и >=.

Возвращает

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

Возвращает

static

createFromTimestamp() public static

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

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

Parameters

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

Returns

static

createFromTimestampUTC() public static

createFromTimestampUTC(int $timestamp): static

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

Parameters

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

Returns

static

day() public

day(int $value): static

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

Parameters

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

Returns

static

diffFiltered() public

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

Получить разницу по заданному интервалу, используя вызываемый объект фильтра

Parameters

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

Returns

int

diffForHumans() public

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

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

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

При сравнении значения в будущем со значением по умолчанию (сейчас): через 1 час через 5 месяцев

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

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

Parameters

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

Returns

string

diffFormatter() public static

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

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

Parameters

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

Returns

Cake\Chronos\DifferenceFormatterInterface

diffInDays() public

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

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

Parameters

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

Returns

int

diffInDaysFiltered() public

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

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

Parameters

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

Returns

int

diffInHours() public

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

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

Parameters

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

Returns

int

diffInHoursFiltered() public

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

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

Parameters

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

Returns

int

diffInMinutes() public

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

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

Parameters

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

Returns

int

diffInMonths() public

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

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

Parameters

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

Returns

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().

Parameters

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

Returns

int

diffInSeconds() public

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

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

Parameters

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

Returns

int

diffInWeekdays() public

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

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

Parameters

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

Returns

int

diffInWeekendDays() public

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

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

Parameters

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

Returns

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

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

Параметры

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

Возвращает

mixed

firstOfQuarter() public

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

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

Параметры

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

Возвращает

mixed

firstOfYear() public

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

Изменить на первое число данного дня недели в текущем году. Если dayOfWeek не указан, изменить на первое число текущего года. Используйте заданные константы для указания желаемого dayOfWeek, например, 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

Получить экземпляр ChronosInterface (реальный или эмулированный), который будет возвращаться при создании экземпляра "now".

Возвращает

Cake\Chronos\ChronosInterface|null

getWeekEndsAt() public static

getWeekEndsAt(): int

Получить последний день недели

Возвращает

int

getWeekStartsAt() public static

getWeekStartsAt(): int

Получить первый день недели

Возвращает

int

getWeekendDays() public static

getWeekendDays(): array

Получить выходные дни

Возвращает

array

greaterThan() public

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

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

Параметры

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

Возвращает

bool

hasTestNow() public static

hasTestNow(): bool

Определяет, установлен ли допустимый тестовый экземпляр. Допустимый тестовый экземпляр — это любой, который не равен null.

Возвращает

bool

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: Экземпляр datetime для преобразования.

Возвращает

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

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

Параметры

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

Возвращает

mixed

lastOfQuarter() public

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

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

Параметры

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

Возвращает

mixed

lastOfYear() public

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

Изменяет на последнее вхождение заданного дня недели в текущем году. Если день недели не указан, изменяет на последний день текущего года. Используйте предоставленные константы для указания желаемого дня недели, например 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 группирует результаты и добавляет сокращение часового пояса в значение отображения. Установите 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

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

Параметры

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

Возвращает

bool

См. также

lessThanOrEquals

max() public

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

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

Параметры

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

Возвращает

static

maxValue() public static

maxValue(): Cake\Chronos\ChronosInterface

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

Возвращает

Cake\Chronos\ChronosInterface

microsecond() public

microsecond(int $value): static

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

Параметры

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

Возвращает

static

min() public

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

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

Параметры

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

Возвращает

static

minValue() public static

minValue(): Cake\Chronos\ChronosInterface

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

Возвращает

Cake\Chronos\ChronosInterface

minute() public

minute(int $value): static

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

Параметры

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

Возвращает

static

modify() public @method

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

Параметры

string $relative

Возвращает

Cake\Chronos\ChronosInterface

month() public

month(int $value): static

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

Параметры

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

Возвращает

static

ne() public

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

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

Параметры

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

Возвращает

bool

См. также

notEquals

next() public

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

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

Параметры

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

Возвращает

mixed

nice() public

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

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

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

Параметры

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

Возвращает

string

notEquals() public

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

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

Параметры

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

Возвращает

bool

now() public static

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

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

Параметры

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

Возвращает

static

nthOfMonth() public

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

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

Параметры

int $nth: Смещение для использования.
int $dayOfWeek: День недели для перехода.

Возвращает

mixed

nthOfQuarter() public

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

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

Параметры

int $nth: Смещение для использования.
int $dayOfWeek: День недели для перехода.

Возвращает

mixed

nthOfYear() public

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

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

Параметры

int $nth: Смещение для использования.
int $dayOfWeek: День недели для перехода.

Возвращает

mixed

parse() public static

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

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

Параметры

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

Возвращает

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 optional: Любой формат, принимаемый 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), либо шаблоном, как указано в (https://unicode-org.github.io/icu-docs/apidoc/released/icu4c/classSimpleDateFormat.html#details)

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

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

Параметры

Closure|array|string|int $format

Возвращает

void

setTestNow() public static

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

Устанавливает экземпляр ChronosInterface (реальный или поддельный) для возврата при создании экземпляра "now". Переданный экземпляр будет возвращен при следующих условиях:

Вызов статического метода now(), например, ChronosInterface::now()
При передаче null (или пустой строки) в конструктор или parse(), например, new Chronos(null)
При передаче строки "now" в конструктор или parse(), например, new Chronos('now')
При передаче строки с желаемым временем в ChronosInterface::parse()

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

Чтобы очистить тестовый экземпляр, вызовите этот метод с параметром по умолчанию null.

Параметры

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

Возвращает

void

setTimeFromTimeString() public

setTimeFromTimeString(string $time): static

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

Параметры

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

Возвращает

static

setTimezone() public

setTimezone(DateTimeZone|string $value): static

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

Parameters

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

Returns

static

setToStringFormat() public static

setToStringFormat(string $format): void

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

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

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

Parameters

string $format: Формат.

Returns

void

setWeekEndsAt() public static

setWeekEndsAt(int $day): void

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

Parameters

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

Returns

void

setWeekStartsAt() public static

setWeekStartsAt(int $day): void

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

Parameters

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

Returns

void

setWeekendDays() public static

setWeekendDays(array $days): void

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

Parameters

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

Returns

void

startOfCentury() public

startOfCentury(): static

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

Returns

static

startOfDay() public

startOfDay(): static

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

Returns

static

startOfDecade() public

startOfDecade(): static

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

Returns

static

startOfMonth() public

startOfMonth(): static

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

Returns

static

startOfWeek() public

startOfWeek(): static

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

Returns

static

startOfYear() public

startOfYear(): static

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

Returns

static

subDay() public

subDay(int $value = 1): static

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

Parameters

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

Returns

static

subDays() public

subDays(int $value): static

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

Parameters

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

Returns

static

subHour() public

subHour(int $value = 1): static

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

Parameters

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

Returns

static

subHours() public

subHours(int $value): static

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

Parameters

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

Returns

static

subMinute() public

subMinute(int $value = 1): static

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

Parameters

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

Returns

static

subMinutes() public

subMinutes(int $value): static

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

Parameters

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

Returns

static

subMonth() public

subMonth(int $value = 1): static

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

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

Parameters

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

Returns

static

subMonthWithOverflow() public

subMonthWithOverflow(int $value = 1): static

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

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

Parameters

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

Returns

static

subMonths() public

subMonths(int $value): static

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

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

Parameters

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

Returns

static

subMonthsWithOverflow() public

subMonthsWithOverflow(int $value): static

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

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

Parameters

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

Returns

static

subSecond() public

subSecond(int $value = 1): static

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

Parameters

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

Returns

static

subSeconds() public

subSeconds(int $value): static

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

Parameters

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

Returns

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 => Формат, если годы > 0 (по умолчанию "день")
- month => Формат, если месяцы > 0 (по умолчанию "день")
- week => Формат, если недели > 0 (по умолчанию "день")
- day => Формат, если недели > 0 (по умолчанию "час")
- hour => Формат, если часы > 0 (по умолчанию "минута")
- minute => Формат, если минуты > 0 (по умолчанию "минута")
- second => Формат, если секунды > 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

toIso8601String() public

toIso8601String(): string

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

Возвращает

string

toMutable() public

toMutable(): Cake\Chronos\MutableDateTime

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

Возвращает

Cake\Chronos\MutableDateTime

toQuarter() public

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

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

Параметры

bool $range необязательно: Диапазон.

Возвращает

int|array

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 необязательно: Часовой пояс для использования.

Возвращает

static

tomorrow() public static

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

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

Параметры

DateTimeZone|string|null $tz необязательно: Объект 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 необязательно: Объект 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

`$testNow` protected static

Экземпляр интерфейса ChronosInterface для тестирования, который возвращается при создании новых экземпляров

Тип

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.4/class-Cake.I18n.FrozenTime.html