Раздел описывает разные форматы в BNF-подобном синтаксисе, которые принимает парсер:
DateTimeImmutable, DateTime,
date_create_immutable(),
date_create(), date_parse() и
strtotime(). Форматы сгруппированы
по разделам. В большинстве случаев форматы из разных разделов, разделённые
пробелом, запятой или точкой, могут использоваться в одной и той же строке даты и времени. Для каждого
из поддерживаемых форматов приведены один или несколько примеров, а также
описание формата. Символы в одинарных кавычках нечувствительны к регистру
('t'
эквивалентно как t
, так и T
),
символы в двойных кавычках чувствительны к регистру
("T"
означает только T
).
Чтобы отформатировать объекты DateTimeImmutable и DateTime, обратитесь к документации метода DateTimeInterface::format().
Следует принять во внимание общий свод правил.
false
, если какое-либо число находится вне диапазонов,
а конструктор DateTimeImmutable::__construct() выбрасывает исключение.
@1690388256
)
и дат недели в формате ISO (2008-W28-3
).
Существует дополнительная проверка, если указана недействительная дата:
<?php
$res = date_parse("2015-09-31");
var_dump($res["warnings"]);
?>
Результат выполнения приведённого примера:
array(1) { [11] => string(27) "The parsed date was invalid" }
Крайние случаи уже можно обработать, для этого необходимо вызывать метод DateTimeImmutable::createFromFormat(), предоставляя правильный формат.
<?php
$res = DateTimeImmutable::createFromFormat("Y-m-d", "2015-09-34");
var_dump($res);
?>
Результат выполнения приведённого примера:
object(DateTimeImmutable)#1 (3) { ["date"]=> string(26) "2015-10-04 17:24:43.000000" ["timezone_type"]=> int(3) ["timezone"]=> string(13) "Europe/London" }
Эта страница описывает форматы даты и времени в BNF-подобном синтаксисе, которые понимает парсер функций: DateTimeImmutable, DateTime, date_create(), date_create_immutable() и strtotime().
Чтобы отформатировать объекты DateTimeImmutable и DateTime, обратитесь к документации метода DateTimeInterface::format().
Описание | Формат | Примеры |
---|---|---|
frac (дробная часть) |
. [0-9]+ | ".21342", ".85" |
hh (часы в 12-часовом формате) |
"0"?[1-9] | "1"[0-2] | "04", "7", "12" |
HH (часы в 24-часовом формате) |
[01][0-9] | "2"[0-4] | "04", "07", "19" |
meridian (Ante meridiem или Post meridiem) |
[AaPp] .? [Mm] .? [\0\t ] | "A.m.", "pM", "am." |
MM (минуты) |
[0-5][0-9] | "00", "12", "59" |
II (секунды) |
[0-5][0-9] | "00", "12", "59" |
space (символ пробела или табуляции) |
[ \t] | |
tz (часовой пояс) |
"("? [A-Za-z]{1,6} ")"? | [A-Z][a-z]+([_/][A-Z][a-z]+)+ | "CEST", "Europe/Amsterdam", "America/Indiana/Knox" |
tzcorrection (числовое значение смещения часового пояса) |
"GMT"? [+-] hh ":"? MM ? |
"+0400", "GMT-07:00", "-07:00" |
Описание | Формат | Примеры |
---|---|---|
Только часы (с Ante meridiem или Post meridiem) | hh space ? meridian |
"4 am", "5PM" |
Часы и минуты (с Ante meridiem или Post meridiem ) |
hh [.:] MM space ? meridian |
"4:08 am", "7:19P.M." |
Часы, минуты и секунды (с Ante meridiem или Post meridiem ) |
hh [.:] MM [.:] II space ? meridian |
"4:08:37 am", "7:19:19P.M." |
MS SQL (Часы, минуты, секунды и дробная часть с Ante meridiem или Post meridiem) | hh ":" MM ":" II [.:] [0-9]+ meridian |
"4:08:39:12313am" |
Описание | Формат | Примеры |
---|---|---|
Часы и минуты | 't'? HH [.:] MM |
"04:08", "19.19", "T23:43" |
Часы и минуты (без двоеточия-разделителя) | 't'? HH MM |
"0408", "t1919", "T2343" |
Часы, минуты и секунды | 't'? HH [.:] MM [.:] II |
"04.08.37", "t19:19:19" |
Часы, минуты и секунды (без двоеточия-разделителя) | 't'? HH MM II |
"040837", "T191919" |
Часы, минуты, секунды и часовой пояс | 't'? HH [.:] MM [.:] II space ? ( tzcorrection | tz ) |
"040837CEST", "T191919-0700" |
Часы, минуты, секунды и дробная часть | 't'? HH [.:] MM [.:] II frac |
"04.08.37.81412", "19:19:19.532453" |
Сведения о часовом поясе | tz | tzcorrection |
"CEST", "Europe/Amsterdam", "+0430", "GMT-06:00" |
Эта страница описывает форматы даты в BNF-подобном синтаксисе, которые понимает парсер функций: DateTimeImmutable, DateTime, date_create(), date_create_immutable() и strtotime().
Чтобы отформатировать объекты DateTimeImmutable и DateTime, обратитесь к документации метода DateTimeInterface::format().
Описание | Формат | Примеры |
---|---|---|
daysuf (суффикс порядкового числительного дня месяца) |
"st" | "nd" | "rd" | "th" | |
dd (день месяца без ведущих нулей) |
([0-2]?[0-9] | "3"[01]) daysuf ? |
"7th", "22nd", "31" |
DD (день месяца, 2 цифры с ведущим нулём) |
"0" [0-9] | [1-2][0-9] | "3" [01] | "07", "31" |
m (полное или сокращённое название месяца) |
'january' | 'february' | 'march' | 'april' | 'may' | 'june' | 'july' | 'august' | 'september' | 'october' | 'november' | 'december' | 'jan' | 'feb' | 'mar' | 'apr' | 'may' | 'jun' | 'jul' | 'aug' | 'sep' | 'sept' | 'oct' | 'nov' | 'dec' | "I" | "II" | "III" | "IV" | "V" | "VI" | "VII" | "VIII" | "IX" | "X" | "XI" | "XII" | |
M (сокращённое название месяца) |
'jan' | 'feb' | 'mar' | 'apr' | 'may' | 'jun' | 'jul' | 'aug' | 'sep' | 'sept' | 'oct' | 'nov' | 'dec' | |
mm (порядковый номер месяца) |
"0"? [0-9] | "1"[0-2] | "0", "04", "7", "12" |
MM (порядковый номер месяца, 2 цифры с ведущим нулём) |
"0" [0-9] | "1"[0-2] | "00", "04", "07", "12" |
y (порядковый номер года) |
[0-9]{1,4} | "00", "78", "08", "8", "2008" |
yy (порядковый номер года, 2 цифры) |
[0-9]{2} | "00", "08", "78" |
YY (порядковый номер года, 4 цифры) |
[0-9]{4} | "2000", "2008", "1978" |
YYY |
[0-9]{5,19} | "81412", "20192" |
Описание | Формат | Примеры |
---|---|---|
Месяц и день в американской нотации | mm "/" dd |
"5/12", "10/27" |
Месяц, день и год в американской нотации | mm "/" dd "/" y |
"12/22/78", "1/17/2006", "1/17/6" |
4 цифры года, месяц и день со слешем-разделителем | YY "/" mm "/" dd |
"2008/6/30", "1978/12/22" |
4 цифры года и месяц (GNU) | YY "-" mm |
"2008-6", "2008-06", "1978-12" |
Год, месяц и день с дефисом-разделителем | y "-" mm "-" dd |
"2008-6-30", "78-12-22", "8-6-21" |
День, месяц и 4 цифры года с разделителем в виде точки, символа табуляции или дефиса | dd [.\t-] mm [.-] YY |
"30-6-2008", "22.12.1978" |
День, месяц и 2 цифры года с разделителем в виде точки или символа табуляции | dd [.\t] mm "." yy |
"30.6.08", "22.12.78" |
День, название месяца и год | dd ([ \t.-])* m ([ \t.-])* y |
"30-June 2008", "22DEC78", "14 III 1879" |
Название месяца и 4 цифры года (день месяца сбрасывается на 1) | m ([ \t.-])* YY |
"June 2008", "DEC1978", "March 1879" |
4 цифры года и название месяца (день месяца сбрасывается на 1) | YY ([ \t.-])* m |
"2008 June", "1978-XII", "1879.MArCH" |
Название месяца, день и год | m ([ .\t-])* dd [,.stndrh\t ]+ y |
"July 1st, 2008", "April 17, 1790", "May.9,78" |
Название месяца и день | m ([ .\t-])* dd [,.stndrh\t ]* |
"July 1st,", "Apr 17", "May.9" |
День и название месяца | dd ([ .\t-])* m |
"1 July", "17 Apr", "9.May" |
Сокращённое название месяца, день и год | M "-" DD "-" y |
"May-09-78", "Apr-17-1790" |
Год, сокращённое название месяца и день | y "-" M "-" DD |
"78-Dec-22", "1814-MAY-17" |
Только год | YY |
"1978", "2008" |
Год (расширенный, 5-19 цифр со знаком) | [+-] YYY |
"-81120", "+20192" |
Только название месяца | m |
"March", "jun", "DEC" |
Описание | Формат | Примеры |
---|---|---|
8 цифр (год, месяц и день) | YY MM DD |
"15810726", "19780417", "18140517" |
8 цифр (год, месяц и день) со слешем-разделителем | YY "/" MM "/" DD |
"2008/06/30", "1978/12/22" |
2 цифры года, месяц и день с дефисом-разделителем | yy "-" MM "-" DD |
"08-06-30", "78-12-22" |
4 цифры года с необязательным знаком, месяц и день | [+-]? YY "-" MM "-" DD |
"-0002-07-26", "+1978-04-17", "1814-05-17" |
Пятизначный год с обязательным знаком, месяцем и днём | [+-] YYY "-" MM "-" DD |
"-81120-02-26", "+20192-04-17" |
Замечание:
Форматы
y
иyy
для годов меньше 100 обрабатываются в исключительных случаях при использовании символовy
илиyy
. К году добавляется значение 2000, если год попадает в диапазон 0-69 (включительно). К году добавляется значение 1900, если год принадлежит диапазону 70-99 (включительно). Поэтому дата "00-01-01" интерпретируется как "2000-01-01".
Замечание:
Формат "День, месяц и 2 цифры года с разделителем в виде точки или символа табуляции" (
dd
[.\t]mm
"."yy
) работает только для годов из диапазона 61-99 (включительно). За пределами этого диапазона отдаётся предпочтение формату времени "HH
[.:]MM
[.:]SS
".
Замечание:
Формат «Год (и только год)» надёжно работает, только если метод уже нашёл строку времени, иначе, если четыре цифры года соответствуют формату
HH
MM
, вместо года устанавливаются эти два элемента даты.Для согласованного разбора только года вызывают метод DateTimeImmutable::createFromFormat() со спецификатором
Y
.
Возможен выход за границы диапазона форматов dd
и DD
.
День месяца с порядковым номером 0 подразумевает последний день предыдущего месяца
в результате выхода за границы диапазона. Согласно написанному, "2008-08-00" равносильно
"2008-07-31", а "2008-06-31" соответствует "2008-07-01" (в июне всего 30 дней).
Обратите внимание на ограничение диапазона дней: 0-31, как указывает регулярное выражение в предыдущих параграфах. Поэтому дата наподобие "2008-06-32" некорректна.
Допускается также выход за границы диапазона для форматов mm
и MM
со значением 0. Значение месяца 0 соответствует декабрю
предыдущего года. Например, дата "2008-00-22" равносильна "2007-12-22".
Если учесть два предыдущих замечания и выход за границы диапазона дней и месяцев, получим следующее: дата "2008-00-00" в первую очередь преобразуется в "2007-12-00", которая будет преобразована в "2007-11-30". То же случится с датой "0000-00-00", которая преобразуется к "-0001-11-30" (минус первый год в календаре ISO 8601 и 2 год до н. э. по григорианскому календарю).
Эта страница описывает разные составные форматы даты и времени в BNF-подобном синтаксисе, которые понимает парсер функций: DateTimeImmutable, DateTime, date_create(), date_create_immutable() и strtotime().
Чтобы отформатировать объекты DateTimeImmutable и DateTime, обратитесь к документации метода DateTimeInterface::format().
Описание | Форматы | Примеры |
---|---|---|
DD (день месяца с ведущим нулём) |
"0" [0-9] | [1-2][0-9] | "3" [01] | "02", "12", "31" |
doy (день в году) |
"00"[1-9] | "0"[1-9][0-9] | [1-2][0-9][0-9] | "3"[0-5][0-9] | "36"[0-6] | "001", "012", "180", "350", "366" |
frac (дробная часть) |
. [0-9]+ | ".21342", ".85" |
hh (часы) |
"0"?[1-9] | "1"[0-2] | "04", "7", "12" |
HH (часы с ведущим нулём) |
[01][0-9] | "2"[0-4] | "04", "07", "19" |
meridian (Ante meridiem или Post meridiem) |
[AaPp] .? [Mm] .? [\0\t ] | "A.m.", "pM", "am." |
ii (минуты) |
[0-5]?[0-9] | "04", "8", "59" |
II (минуты с ведущим нулём) |
[0-5][0-9] | "04", "08", "59" |
M (сокращённое наименование месяца) |
'jan' | 'feb' | 'mar' | 'apr' | 'may' | 'jun' | 'jul' | 'aug' | 'sep' | 'sept' | 'oct' | 'nov' | 'dec' | |
MM (месяц с ведущим нулём) |
[0-1][0-9] | "00", "12" |
space (символ пробела или табуляции) |
[ \t] | |
ss (секунды) |
([0-5]?[0-9])|60 | "04", "8", "59", "60" (дополнительная секунда) |
SS (секунды с ведущим нулём) |
[0-5][0-9] | "04", "08", "59" |
W (неделя в году) |
"0"[1-9] | [1-4][0-9] | "5"[0-3] | "05", "17", "53" |
tzcorrection (смещение часового пояса) |
"GMT"? [+-] hh ":"? II ? |
"+0400", "GMT-07:00", "-07:00" |
YY (4 цифры года) |
[0-9]{4} | "2000", "2008", "1978" |
Описание | Примеры |
---|---|
ATOM | "2022-06-02T16:58:35+00:00" |
COOKIE | "Thursday, 02-Jun-2022 16:58:35 UTC" |
ISO8601 | "2022-06-02T16:58:35+0000" |
» RFC 822 | "Thu, 02 Jun 22 16:58:35 +0000" |
» RFC 850 | "Thursday, 02-Jun-22 16:58:35 UTC" |
» RFC 1036 | "Thu, 02 Jun 22 16:58:35 +0000" |
» RFC 1123 | "Thu, 02 Jun 2022 16:58:35 +0000" |
» RFC 2822 | "Thu, 02 Jun 2022 16:58:35 +0000" |
» RFC 3339 | "2022-06-02T16:58:35+00:00" |
» RFC 3339 Extended | "2022-06-02T16:58:35.698+00:00" |
» RFC 7231 | "Thu, 02 Jun 2022 16:58:35 GMT" |
RSS | "Thu, 02 Jun 2022 16:58:35 +0000" |
W3C | "2022-06-02T16:58:35+00:00" |
Описание | Формат | Примеры |
---|---|---|
Общий формат log-записей | dd "/" M "/" YY : HH ":" II ":" SS space tzcorrection |
"10/Oct/2000:13:55:36 -0700" |
EXIF | YY ":" MM ":" DD " " HH ":" II ":" SS |
"2008:08:07 18:11:31" |
Год и неделя в формате ISO | YY "-"? "W" W |
"2008W27", "2008-W28" |
Год, неделя в формате ISO и день недели | YY "-"? "W" W "-"? [0-7] |
"2008W273", "2008-W28-3" |
MySQL | YY "-" MM "-" DD " " HH ":" II ":" SS |
"2008-08-07 18:11:31" |
PostgreSQL: год и день в году | YY "."? doy |
"2008.197", "2008197" |
SOAP | YY "-" MM "-" DD "T" HH ":" II ":" SS frac tzcorrection ? |
"2008-07-01T22:35:17.02", "2008-07-01T22:35:17.03+08:00" |
Unix Timestamp | "@" "-"? [0-9]+ | "@1215282385" |
Метка времени Unix с микросекундами | "@" "-"? [0-9]+ "." [0-9]{0,6} | "@1607974647.503686" |
XMLRPC | YY MM DD "T" hh ":" II ":" SS |
"20080701T22:38:07", "20080701T9:38:07" |
XMLRPC (Compact) | YY MM DD 't' hh II SS |
"20080701t223807", "20080701T093807" |
WDDX | YY "-" mm "-" dd "T" hh ":" ii ":" ss |
"2008-7-1T9:3:37" |
Замечание:
Символ "W" в форматах "Год и неделя в формате ISO" и "Год, неделя в формате ISO и день недели" чувствителен к регистру, допускается использование символа "W" только в верхнем регистре.
Символ "T" в форматах SOAP, XMLRPC и WDDX также чувствителен к регистру, допускается использование символа "T" только в верхнем регистре.
Формат "Unix Timestamp" устанавливает часовой пояс в UTC.
Эта страница описывает относительные форматы даты и времени в BNF-подобном синтаксисе, которые понимает парсер функций: DateTimeImmutable, DateTime, date_create(), date_create_immutable() и strtotime().
Чтобы отформатировать объекты DateTimeImmutable и DateTime, обратитесь к документации метода DateTimeInterface::format().
Описание | Формат |
---|---|
dayname (наименование дня недели) |
'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' |
daytext (интервалы в неделях) |
'weekday' | 'weekdays' |
number |
[+-]?[0-9]+ |
ordinal (порядковые числительные и указатели) |
'first' | 'second' | 'third' | 'fourth' | 'fifth' | 'sixth' | 'seventh' | 'eighth' | 'ninth' | 'tenth' | 'eleventh' | 'twelfth' | 'next' | 'last' | 'previous' | 'this' |
reltext (указатели) |
'next' | 'last' | 'previous' | 'this' |
space (символы пробела и табуляции) |
[ \t]+ |
unit (интервалы) |
'ms' | 'µs' | (( 'msec' | 'millisecond' | 'µsec' | 'microsecond'
| 'usec' | 'sec' | 'second' | 'min' | 'minute' | 'hour' | 'day' |
'fortnight' | 'forthnight' | 'month' | 'year') 's'?) | 'weeks' |
daytext
|
Формат | Описание | Примеры |
---|---|---|
'yesterday' | Полночь вчера | "yesterday 14:00" |
'midnight' | Время устанавливается в 00:00:00 | |
'today' | Время устанавливается в 00:00:00 | |
'now' | Текущее время | |
'noon' | Время устанавливается в 12:00:00 | "yesterday noon" |
'tomorrow' | Полночь завтра | |
'back of' hour |
15 минут заданного часа | "back of 7pm", "back of 15" |
'front of' hour |
Без 15 минут заданный час | "front of 5am", "front of 23" |
'first day of' | Устанавливает первый день текущего месяца. Обычно эту нотацию лучше использовать вместе с названием месяца, следующим за ней, иначе будет учитываться текущий месяц. | "first day of January 2008" |
'last day of' | Устанавливает последний день текущего месяца. Обычно эту нотацию лучше использовать вместе с названием месяца, следующим за ней, иначе будет учитываться текущий месяц. | "last day of next month" |
ordinal space dayname space 'of' |
Вычисляет x день недели текущего или заданного месяца. |
"first sat of July 2008" |
'last' space dayname space 'of' |
Вычисляет последний день недели текущего или заданного месяца. | "last sat of July 2008" |
number space ? (unit | 'week') |
Вычисляет относительное время при использовании числовых значений периода. | "+5 weeks", "12 day", "-7 weekdays" |
(ordinal | reltext ) space unit |
Вычисляет относительное время при использовании строковых значений периода.
last и previous то же, что и
-1 , this ни на что не влияет, а
next – +1 .
|
"fifth day", "second month", "last day", "previous year" |
'ago' | Вычитает все значения из последнего полученного момента времени. | "2 days ago", "8 days ago 14:00", "2 months 5 days ago", "2 months ago 5 days", "2 days ago ago" |
dayname |
Перемещается на следующий день указанного дня недели. (Смотрите замечание) | "Monday" |
reltext space 'week' |
Разбирает специфичный формат "weekday + last/this/next week". | "Monday next week" |
Замечание:
Относительные выражения всегда обрабатываются после не являющихся относительными. Например, "+1 week july 2008" эквивалентно "july 2008 +1 week".
Исключением этого правила являются: "yesterday", "midnight", "today", "noon" и "tomorrow". Записи "tomorrow 11:00" и "11:00 tomorrow" отличаются. Если принять сегодняшнюю дату за "July 23rd, 2008", то первая запись возвращает "2008-07-24 11:00", а вторая "2008-07-24 00:00". Причина такого поведения в том, что эти пять выражений влияют непосредственно на время.
Такие ключевые слова, как "first day of", зависят от контекста, в котором используется строка относительного формата. Если она используется в статическом методе или функции, то референтом является текущая системная метка времени. Однако при использовании в методе DateTime::modify() или DateTimeImmutable::modify(), референтом является объект, на котором вызывается метод
modify()
.
Замечание:
Следует обратить внимание на приведённые ниже замечания относительно текущего дня недели и дня недели, указанного в строке даты и времени. Текущий день недели может быть вычислен из независимой части строки даты и времени.
- "
dayname
" не сдвигает дату на другой день. (Например: "Wed July 23rd, 2008" означает "2008-07-23").- "
number
dayname
" не сдвигает дату на другой день. (Например: "1 wednesday july 23rd, 2008" означает "2008-07-23").- "
number
weekdayname
" добавляет соответствующее число недель, но не сдвигает дату на другой день. В этом случае имеют место два различных блока "number
week" и "dayname
". (Например: "+1 week wednesday july 23rd, 2008" означает "2008-07-30").- "
ordinal
dayname
" сдвигает дату на другой день. (Например: "last wednesday july 23rd, 2008" означает "2008-07-30").- "
number
weekordinal
dayname
" добавляет соответствующее число недель, а после сдвигает дату на другой день. В этом случае имеют место два различных блока "number
week" и "ordinal
dayname
". (Например: "+1 week first wednesday july 23rd, 2008" означает "2008-08-06").- "
ordinal
dayname
'of' " не сдвигает дату на другой день. (Например: "first wednesday of july 23rd, 2008" означает "2008-07-02", потому как определённые фразы с 'of' сбрасывают день месяца на '1' и в этом случае игнорируется '23rd').Также следует обратить внимание, что "of" в "
ordinal
space
dayname
space
'of' " и "'last'space
dayname
space
'of' " имеет особый смысл.
- Устанавливает день месяца в 1.
- "
ordinal
dayname
'of' "не сдвигает дату на другой день. (Например: "first tuesday of july 2008" означает "2008-07-01").- "
ordinal
dayname
" сдвигает дату на другой день. (Например: "first tuesday july 2008" означает "2008-07-08", смотрите также 4-й пункт предыдущего замечания).- "'last'
dayname
'of' " получает последний в месяцеdayname
. (Например: "last wed of july 2008" означает "2008-07-30")- "'last'
dayname
" получает последнийdayname
перед текущим днём. (Например: "last wed july 2008" означает "2008-06-25"; "july 2008" устанавливает дату в "2008-07-01", а после "last wed" смещает дату к предыдущей среде, а именно к "2008-06-25").
Замечание:
Относительные значения в месяцах рассчитываются исходя из их продолжительности. Например, из "+2 month 2011-11-30" получится "2012-01-30". Это связано с тем, что ноябрь состоит из 30 дней, а декабрь из 31 дня, что составляет 61 дней.
Замечание:
Под числом (
number
) подразумевается целое число (integer); Если будет указано десятичное число, то десятичная точка (или запятая) будет рассматриваться как разделитель. К примеру,'+1.5 hours'
будет считаться как'+1 5 hours'
, а не'+1 hour +30 minutes'
.
Версия | Описание |
---|---|
8.2.0 |
Символы number больше не принимают несколько знаков,
например, +-2 .
|
7.0.8 | Недели всегда начинаются с понедельника. Ранее можно было определять начало недели с воскресенья. |