Класс Date

Расширяет класс Date, предоставленный Chronos.

Добавляет удобные методы и помощники для форматирования с учетом локали.

Пространство имен: 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
```
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

IntlDateFormatter[]

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

string|int|int[]Closure

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

array

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

string|int|int[]

Формат, используемый при форматировании времени с помощью Cake\I18n\Date::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

Включена ли щадящая обработка 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

string|int|int[]

Формат, используемый при форматировании времени с помощью Cake\I18n\Date::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

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

string
$toStringFormat protected static

string

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

DateTimeZone

Псевдоним timezone
$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

string[]

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

string

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

string|int|int[]

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

int
$yearIso public @property-read

int

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

__construct() public

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

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

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

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

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

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

Добавить интервал к дате.
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 не указан, изменить на последний день текущего месяца. Используйте предоставленные константы для указания желаемого дня недели, например, static::MONDAY.
lastOfQuarter() public

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

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

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

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

Определяет, является ли экземпляр меньше (раньше) или равен другому
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 не указан, изменить на следующее вхождение текущего дня недели. Используйте предоставленные константы для указания желаемого дня недели, например, static::MONDAY.
nice() public

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

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

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

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

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

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

Изменить время на дате.
setTimeFromTimeString() public

Установить время по строке времени
setTimestamp() 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
stripRelativeTime() protected

Удалить компоненты времени из относительных строк strtotime.
stripTime() protected

Удаляет компоненты времени из входной строки.
sub() public

Вычесть интервал из даты.
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 = 'now', DateTimeZone|string|null $tz = null)

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

Вы можете указать часовой пояс для параметра $time. Этот часовой пояс не будет использоваться в будущих изменениях экземпляра Date.

Параметр $timezone игнорируется, если $time является экземпляром DateTimeInterface.

Экземпляры Date не имеют компонентов времени, однако из-за ограничений во внутреннем объекте Datetime PHP время всегда будет установлено на 00:00:00, а часовой пояс всегда будет местным временем сервера. Нормализация часового пояса позволяет вычитанию/сложению иметь детерминированные результаты.

Параметры

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

__debugInfo() public

__debugInfo(): array

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

Возвращает

array

__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, string|int|int[] $format, string|null $locale): string

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

Параметры

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

Возвращает

string

add() public

add(DateInterval $interval): static

Добавить интервал к дате

Любые изменения времени будут игнорироваться и сбрасываться до 00:00:00

Параметры

DateInterval $interval: Интервал, на который нужно изменить эту дату.

Возвращает

static

addDay() public

addDay(int $value = 1): static

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

Параметры

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

Возвращает

static

addDays() public

addDays(int $value): static

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

Параметры

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

Возвращает

static

addHour() public

addHour(int $value = 1): static

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

Параметры

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

Возвращает

static

addHours() public

addHours(int $value): static

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

Параметры

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

Возвращает

static

addMinute() public

addMinute(int $value = 1): static

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

Параметры

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

Возвращает

static

addMinutes() public

addMinutes(int $value): static

Добавить минуты к экземпляру. Положительное значение $value перемещается вперед, а отрицательное $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 перемещается вперед, а отрицательное $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 перемещается вперед, а отрицательное $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 перемещается вперед, а отрицательное $value перемещается в прошлое.

Параметры

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

Возвращает

static

addWeek() public

addWeek(int $value = 1): static

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

Параметры

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

Возвращает

static

addWeekday() public

addWeekday(int $value = 1): static

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

Parameters

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

Returns

static

addWeekdays() public

addWeekdays(int $value): static

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

Parameters

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

Returns

static

addWeeks() public

addWeeks(int $value): static

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

Parameters

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

Returns

static

addYear() public

addYear(int $value = 1): static

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

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

Parameters

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

Returns

static

addYearWithOverflow() public

addYearWithOverflow(int $value = 1): static

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

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

Parameters

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

Returns

static

addYears() public

addYears(int $value): static

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

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

Example:

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

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

Parameters

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

Returns

static

addYearsWithOverflow() public

addYearsWithOverflow(int $value): static

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

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

Example:

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

Parameters

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

Returns

static

average() public

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

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

Parameters

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

Returns

static

between() public

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

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

Parameters

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

Returns

bool

closest() public

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

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

Parameters

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

Returns

static

copy() public

copy(): static

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

Returns

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.

Parameters

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

Returns

static

createFromArray() public static

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

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

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

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

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

year
month
day
hour
minute
second
microsecond
meridian ('am' or 'pm')
timezone

Parameters

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

Returns

static

createFromDate() public static

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

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

Parameters

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

Returns

static

createFromFormat() public static

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

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

Parameters

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

Returns

static

Throws

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: Вызываемый для фильтрации.
Cake\Chronos\ChronosInterface|null $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 optional: Экземпляр для сравнения.
bool $abs optional: Получить абсолютное значение разницы.

Возвращает

int

diffInWeekendDays() public

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

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

Параметры

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

Возвращает

int

diffInWeeks() public

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

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

Параметры

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

Возвращает

int

diffInYears() public

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

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

Параметры

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

Возвращает

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 optional: День недели для изменения.

Возвращает

mixed

firstOfQuarter() public

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

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

Параметры

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

Возвращает

mixed

firstOfYear() public

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

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

Параметры

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

Возвращает

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, stringDateTimeZone|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, без изменения его внутреннего состояния, вы можете передать строку часового пояса или объект DateTimeZone в качестве второго параметра.

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

Примеры

$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: Строка формата.
stringDateTimeZone|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

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

Параметры

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

Возвращает

mixed

lastOfQuarter() public

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

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

Параметры

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

Возвращает

mixed

lastOfYear() public

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

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

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

Перегружен для игнорирования изменений времени.

Изменение любого аспекта времени будет проигнорировано, и результирующий объект будет иметь время, замороженное до 00:00:00.

Параметры

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(stringDateTimeZone|null $timezone = null, string|null $locale = null): string

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

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

Параметры

stringDateTimeZone|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, string|int|array|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: Строка даты для парсинга.
string|int|array|null $format optional: Любой формат, принимаемый IntlDateFormatter.

Возвращает

static|null

parseDateTime() public static

parseDateTime(string $time, string|int[]|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: Строка времени для разбора.
string|int[]|null $format optional: Любой формат, принятый IntlDateFormatter.
DateTimeZone|string|null $tz optional: Часовой пояс для экземпляра

Возвращает

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 optional: Любой формат, принятый IntlDateFormatter.

Возвращает

static|null

previous() public

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

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

Параметры

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

Возвращает

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 optional: Секунда для установки.

Возвращает

static

setDefaultLocale() public static

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

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

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

Параметры

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

Возвращает

void

setDiffFormatter() public static

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

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

Параметры

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

Возвращает

void

setJsonEncodeFormat() public static

setJsonEncodeFormat(string|array|intClosure $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 и вернуть отформатированную строку.

Параметры

string|array|intClosure $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 optional: Экземпляр для использования всеми будущими экземплярами.

Возвращает

void

См. также

\Cake\Chronos\Chronos::setTestNow()

setTime() public

setTime(int $hours, int $minutes, int $seconds = null, int $microseconds = null): static

Изменение времени даты.

Этот метод игнорирует все вводимые данные и устанавливает все значения в 0.

Параметры

int $hours: Часы для установки (игнорируется)
int $minutes: Минуты для установки (игнорируется)
int $seconds optional: Секунды для установки (игнорируется)
int $microseconds optional: Микросекунды для установки (игнорируется)

Возвращает

static

setTimeFromTimeString() public

setTimeFromTimeString(string $time): static

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

Параметры

string $time: Время как строка.

Возвращает

static

setTimestamp() public

setTimestamp(int $value): static

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

Этот метод отбросит временные аспекты метки времени и применит только части даты

Parameters

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

Returns

static

setTimezone() public

setTimezone(DateTimeZone|string $value): static

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

Часовые пояса не влияют на календарные даты.

Parameters

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

Returns

static

setToStringFormat() public static

setToStringFormat(string $format): void

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

Можно указать массив из 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

stripRelativeTime() protected

stripRelativeTime(string $time): string

Удалить компоненты времени из относительных строк strtotime.

Parameters

string $time: Входное выражение

Returns

string

stripTime() protected

stripTime(DateTimeDateTimeImmutable|string|int|null $time, DateTimeZone|null $tz): string

Удаляет компоненты времени из входной строки.

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

Parameters

DateTimeDateTimeImmutable|string|int|null $time: Входное время. Целочисленные значения будут считаться в UTC. Значения 'now' и '' будут использовать текущее локальное время.
DateTimeZone|null $tz: Часовой пояс, в котором берется дата

Returns

string

sub() public

sub(DateInterval $interval): static

Вычесть интервал из даты.

Любые изменения времени будут игнорироваться и сбрасываться до 00:00:00

Parameters

DateInterval $interval: Интервал, на который нужно изменить эту дату.

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

Параметры

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

Возвращает

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

Возвращает

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 $options = []): string

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

Опции:

from => другой объект Date, представляющий текущую дату
format => формат по умолчанию, если относительное время больше, чем указанный период
accuracy => Указывает, насколько точно должна быть описана дата (массив)
- year => Формат, если годы > 0 (по умолчанию "день")
- month => Формат, если месяцы > 0 (по умолчанию "день")
- week => Формат, если недели > 0 (по умолчанию "день")
- day => Формат, если недели > 0 (по умолчанию "день")
end => Конец отсчёта относительной даты
relativeString => Строка для вывода относительной даты, совместимая с printf
absoluteString => Строка для вывода абсолютной даты, совместимая с printf
timezone => Часовой пояс пользователя, в котором должен быть отформатирован отметка времени.

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

3 недели, 4 дня назад
1 день назад

Форматирование даты по умолчанию - d/M/YY, например: 18/2/09. Форматирование выполняется внутри с использованием i18nFormat, см. метод для допустимых строк форматирования.

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

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

Параметры

array $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\Date

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

Возвращает

Cake\Chronos\Date

toIso8601String() public

toIso8601String(): string

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

Возвращает

string

toQuarter() public

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

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

Параметры

bool $range optional: Диапазон.

Возвращает

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

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

Тип

IntlDateFormatter[]

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

`$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.2/class-Cake.I18n.Date.html