Раздел описывает разные форматы в 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) | hhspace? meridian | "4 am", "5PM" |
Часы и минуты (с Ante meridiem или Post meridiem) | hh [.:] MMspace? meridian | "4:08 am", "7:19P.M." |
Часы, минуты и секунды (с Ante meridiem или Post meridiem) | hh [.:] MM [.:] IIspace? 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'? HHMM | "0408", "t1919", "T2343" |
| Часы, минуты и секунды | 't'? HH [.:] MM [.:] II | "04.08.37", "t19:19:19" |
| Часы, минуты и секунды (без двоеточия-разделителя) | 't'? HHMMII | "040837", "T191919" |
| Часы, минуты, секунды и часовой пояс | 't'? HH [.:] MM [.:] IIspace? ( tzcorrection | tz ) | "040837CEST", "T191919-0700" |
| Часы, минуты, секунды и дробная часть | 't'? HH [.:] MM [.:] IIfrac | "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 цифр (год, месяц и день) | YYMMDD | "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. Если год попадает в диапазон 0-69 (включительно), то к нему добавляется 2000. Если же год принадлежит диапазону 70-99 (включительно), то к нему добавляется 1900. Это означает, что дата "00-01-01" интерпретируется как "2000-01-01".
Замечание:
Формат "День, месяц и 2 цифры года с разделителем в виде точки или символа табуляции" (
dd[.\t]mm"."yy) работает только для годов из диапазона 61-99 (включительно). За пределами этого диапазона отдаётся предпочтение формату времени "HH[.:]MM[.:]SS".
Замечание:
Формат "Только год" задействуется, только если строка времени была найдена. В противном случае отдаётся предпочтению формату
HHMM.
Возможен выход за границы диапазона форматов 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 ":" SSspacetzcorrection | "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 ":" SSfractzcorrection? | "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 | YYMMDD "T" hh ":" II ":" SS | "20080701T22:38:07", "20080701T9:38:07" |
| XMLRPC (Compact) | YYMMDD 't' hhIISS | "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" |
ordinalspacedaynamespace 'of' | Вычисляет x день недели текущего или заданного месяца. | "first sat of July 2008" |
'last' spacedaynamespace 'of' | Вычисляет последний день недели текущего или заданного месяца. | "last sat of July 2008" |
numberspace? (unit | 'week') | Вычисляет относительное время при использовании числовых значений периода. | "+5 weeks", "12 day", "-7 weekdays" |
(ordinal | reltext) spaceunit | Вычисляет относительное время при использовании строковых значений периода. 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" |
reltextspace '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").- "
numberdayname" не сдвигает дату на другой день. (Например: "1 wednesday july 23rd, 2008" означает "2008-07-23").- "
numberweekdayname" добавляет соответствующее число недель, но не сдвигает дату на другой день. В этом случае имеют место два различных блока "numberweek" и "dayname". (Например: "+1 week wednesday july 23rd, 2008" означает "2008-07-30").- "
ordinaldayname" сдвигает дату на другой день. (Например: "last wednesday july 23rd, 2008" означает "2008-07-30").- "
numberweekordinaldayname" добавляет соответствующее число недель, а после сдвигает дату на другой день. В этом случае имеют место два различных блока "numberweek" и "ordinaldayname". (Например: "+1 week first wednesday july 23rd, 2008" означает "2008-08-06").- "
ordinaldayname'of' " не сдвигает дату на другой день. (Например: "first wednesday of july 23rd, 2008" означает "2008-07-02", потому как определённые фразы с 'of' сбрасывают день месяца на '1' и в этом случае игнорируется '23rd').Также следует обратить внимание, что "of" в "
ordinalspacedaynamespace'of' " и "'last'spacedaynamespace'of' " имеет особый смысл.
- Устанавливает день месяца в 1.
- "
ordinaldayname'of' "не сдвигает дату на другой день. (Например: "first tuesday of july 2008" означает "2008-07-01").- "
ordinaldayname" сдвигает дату на другой день. (Например: "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 | Недели всегда начинаются с понедельника. Ранее можно было определять начало недели с воскресенья. |