Шаблон результирующей строки ( string ) с датой. См. параметры форматирования ниже. Также существует несколько предопределенных констант даты/времени, которые могут быть использованы вместо этих параметров. Например: DATE_RSS заменяет шаблон ‘D, d M Y H:i:s’.
Возвращаемые значения
Ошибки
Список изменений
Версия
Описание
5.1.0
Допустимым диапазоном дат для временных меток обычно являются даты с 13 декабря 1901, 20:45:54 GMT по 19 января 2038, 03:14:07 GMT. (Они соответствуют минимальному и максимальному значению 32-битного целого числа со знаком). Однако для PHP версии ниже 5.1.0 в некоторых операционных системах (например, Windows) этот диапазон был ограничен датами 01-01-1970 до 19-01-2038.
5.1.0
Примеры
Пример #1 Примеры использования функции date()
// установка временной зоны по умолчанию. Доступно начиная с версии PHP 5.1 date_default_timezone_set ( ‘UTC’ );
// выведет примерно следующее: Monday echo date ( «l» );
// выведет примерно следующее: Monday 8th of August 2005 03:12:46 PM echo date ( ‘l jS \of F Y h:i:s A’ );
Чтобы запретить распознавание символа как форматирующего, следует экранировать его с помощью обратного слеша. Если экранированный символ также является форматирующей последовательностью, то следует экранировать его повторно.
Пример #2 Экранирование символов в функции date()
Пример #3 Пример совместного использования функций date() и mktime()
Данный способ более надежен, чем простое вычитание и прибавление секунд к метке времени, поскольку позволяет при необходимости гибко осуществить переход на летнее/зимнее время.
Пример #4 Форматирование с использованием date()
// Предположим, что текущей датой является 10 марта 2001, 5:16:18 вечера, // и мы находимся во временной зоне Mountain Standard Time (MST)
$today = date ( «F j, Y, g:i a» ); // March 10, 2001, 5:16 pm $today = date ( «m.d.y» ); // 03.10.01 $today = date ( «j, n, Y» ); // 10, 3, 2001 $today = date ( «Ymd» ); // 20010310 $today = date ( ‘h-i-s, j-m-y, it is w Day’ ); // 05-16-18, 10-03-01, 1631 1618 6 Satpm01 $today = date ( ‘\i\t \i\s \t\h\e jS \d\a\y.’ ); // it is the 10th day. $today = date ( «D M j G:i:s T Y» ); // Sat Mar 10 17:16:18 MST 2001 $today = date ( ‘H:m:s \m \i\s\ \m\o\n\t\h’ ); // 17:03:18 m is month $today = date ( «H:i:s» ); // 17:16:18 $today = date ( «Y-m-d H:i:s» ); // 2001-03-10 17:16:18 (формат MySQL DATETIME) ?>
Создает и возвращает экземпляр класса DateTime, соответствующий заданному формату.
Список параметров
Список возможных символов для составления строки format
Символ в строке format
Описание
Возможные значения
День
—
—
d и j
День месяца, 2 цифры с нулем в начале или без него
От 01 до 31 либо от 1 до 31
D и l
Текстовое представление дня месяца
От Mon до Sun либо от Sunday до Saturday
S
Суффикс для числа в английской нумерации, 2 буквы. Эти буквы будут пропущены при разборе строки.
st, nd, rd или th.
z
Номер дня с начала года (начиная с нуля)
C 0 по 365
Месяц
—
—
F и M
Текстовое представление месяца, например January или Sept
С January по December либо с Jan по Dec
m и n
Числовое представление месяца с первым нулем или без него
С 01 по 12 либо с 1 по 12
Год
—
—
Y
Полное числовое представление года, 4 цифры
Примеры: 1999 или 2003
y
2 цифры в представлении года (в диапазоне 1970-2069 включительно)
Примеры: 99 или 03 (будет расшифровано как 1999 и 2003 соответственно)
Время
—
—
a и A
До полудня и После полудня
am или pm
g и h
12-ти часовой формат времени с первым нулем или без него
С 1 по 12 либо с 01 по 12
G и H
24-х часовой формат времени с нулем в начале или без него
С 0 по 23 или с 00 по 23
i
Минуты с нулем в начале
С 00 по 59
s
Секунды с нулем в начале
От 00 до 59
u
Микросекунды (до 6 цифр)
Примеры: 45, 654321
Временная зона
—
—
e, O, P и T
Идентификатор временной зоны, либо разница в часах относительно UTC, либо разница относительно UTC с запятой между часами и минутами, либо аббревиатура временной зоны
Примеры: UTC, GMT, Atlantic/Azores или +0200 или +02:00 или EST, MDT
Дата/Время полностью
—
—
U
Количество секунд с начала Эпохи Unix (January 1 1970 00:00:00 GMT)
Пример: 1292177455
Пробел и Разделители
—
—
(пробел)
Один пробел или один отступ табулатуры
Пример:
#
Один из следующих символов: ;, :, /, ., ,, —, ( или )
Пример: /
;, :, /, ., ,, —, ( или )
Символ разделитель.
Пример: —
?
Один случайный (любой) символ
Пример: ^ (Будьте внимательны: в UTF-8 кодировке вам может потребоваться более одного ?, так как там один символ может занимать более одного байта. В таких случаях может помочь использование *.
*
Любое количество любых символов до следующего разделителя
Пример: * в Y-*-d для строки 2009-aWord-08 будет соответствовать aWord
!
Приводит значения всех полей (год, месяц, день, час, минута, секунда, временная зона) ко времени начала Эпохи Unix.
Без !, все поля будут соответствовать текущему времени.
|
Приводит значения незаданных полей (год, месяц, день, час, минута, секунда, временная зона) ко времени начала Эпохи Unix.
Y-m-d| установит год, месяц и день в соответствии с данными в строке, а часы, минуты и секунды установит в 0.
+
Если задан этот спецификатор, данные, завершающие строку (нуль байт например) не будут вызывать ошибку, только предупреждение
Используйте DateTime::getLastErrors() для определения, были ли в строке завершающие символы.
Если format не содержит символ !, то значения полей, не заданных в строке формата, будут установлены в соответствии с текущим временем.
Если format содержит символ !, то значения полей, не заданных в строке формата (равно как и значения полей слева от !) будут установлены в соответствии со значениями полей начала Эпохи Unix.
Начало эпохи Unix 1970-01-01 00:00:00 UTC.
Строка, представляющая время.
Объект класса DateTimeZone, представляющий ожидаемую временную зону.
Если timezone не указан и time не содержит временную зону, то будет использована текущая временная зона.
Параметр timezone и текущая временная зона будут проигнорированы, если параметр time также содержит метку времени UNIX (т.е. timestamp вида 946684800) или же указанную временную зону (т.е. 2010-01-28T15:00:00+02:00).
Возвращаемые значения
Возвращает созданный экземпляр класса DateTime или FALSE в случае возникновения ошибки.
Примеры
Пример #1 Пример использования DateTime::createFromFormat()
Для вставки в format буквенного символа, вы должны экранировать его с помощью обратного слеша( \ ).
Начало эпохи Unix 1970-01-01 00:00:00 UTC.
Строка, представляющая время.
Если timezone не указан или null и datetime не содержит часовой пояс, то будет использован текущий часовой пояс.
Параметр timezone и текущий часовой пояс будут проигнорированы, если параметр datetime также содержит метку времени UNIX (то есть timestamp вида 946684800 ) или же указанный часовой пояс (то есть 2010-01-28T15:00:00+02:00 ).
Возвращаемые значения
Возвращает созданный экземпляр класса DateTime или false в случае возникновения ошибки.
Список изменений
Примеры
Пример #1 Пример использования DateTime::createFromFormat()
Результат выполнения данных примеров:
Пример #2 Хитрости при использовании DateTime::createFromFormat()
Результатом выполнения данного примера будет что-то подобное:
Пример #3 Формат строки с буквенными символами
Результатом выполнения данного примера будет что-то подобное:
Смотрите также
User Contributed Notes 27 notes
Be warned that DateTime object created without explicitely providing the time portion will have the current time set instead of 00:00:00.
Be aware: If the day of the month is not provided, creating a DateTime object will produce different results depending on what the current day of the year is. This is because the current system date will be used where values are not provided.
// on August 1st printMonth ( «April» ); // outputs April
// on August 31st printMonth ( «April» ); // outputs May ?>
In this case, each and every character on that string has to be escaped as shown below.
createFromFormat(‘U’) has a strange behaviour: it ignores the datetimezone and the resulting DateTime object will always have GMT+0000 timezone.
?>
The problem is microtime() and time() returning the timestamp in current timezone. Instead of using time you can use ‘now’ but to get a DateTimeObject with microseconds you have to write it this way to be sure to get the correct datetime:
Parsing RFC3339 strings can be very tricky when their are microseconds in the date string.
Since PHP 7 there is the undocumented constant DateTime::RFC3339_EXTENDED (value: Y-m-d\TH:i:s.vP), which can be used to output an RFC3339 string with microseconds:
Note: the difference between «v» and «u» is just 3 digits vs. 6 digits.
Reportedly, microtime() may return a timestamp number without a fractional part if the microseconds are exactly zero. I.e., «1463772747» instead of the expected «1463772747.000000». number_format() can create a correct string representation of the microsecond timestamp every time, which can be useful for creating DateTime objects when used with DateTime::createFromFormat():
If you’re here because you’re trying to create a date from a week number, you want to be using setISODate, as I discovered here:
Эта функция является псевдонимом: DateTime::__construct()
User Contributed Notes 10 notes
If you want to create the DateTime object directly from a timestamp use this
If you are getting an error like this:
Exception: DateTime::__construct(): Failed to parse time string (13/02/2013) at position 0 (1): Unexpected character in DateTime->__construct()
Note that when you create a new date object using a format with slashes and dashes (eg 02-02-2012 or 02/02/2012) it must be in the mm/dd/yy(yy) or mm-dd-yy(yy) format (rather than british format dd/mm/yy)! Months always before years (the american style) otherwise you’ll get an incorrect date and may get an error like the one above (where PHP is crashing on trying to decode a 13th month).
Can catch you off guard because everything seems to be working fine and dandy until you hit a value over 12.
DateTime will recognise any number up to 12 as a [month], and any number up to 31 as a [day]; it calculates the resulting date to be [day] days after the start of [month]. This means that when a datetime object is created with more days than are found in that month, the date will be beyond the end of the month.
You should also be aware that DateTime has very lax date validation rules. It appears that all months have a maximum of 31 days.
For example, these will work fine:
= new DateTime ( ’02/31/2011′ ); $test = new DateTime ( ’06/31/2011′ ); ?>
We all know that these dates are not real and are invalid so I think a good idea is to do some further validation on dates before creating a DateTime object with them.
@Marton Bodonyi This is not exactly true.
The following code: [code] echo «1\n»; print_r(date_create(’13-02-2013′)); echo «2\n»; print_r(date_create(’13/02/2013′)); echo «3\n»; print_r(new DateTime(’13-02-2013′)); echo «4\n»; print_r(new DateTime(’13/02/2013′)); [/code]
Fatal error: Uncaught exception ‘Exception’ with message ‘DateTime::__construct(): Failed to parse time string (13/02/2013) at position 0 (1): Unexpected character’ in /test.php:23 Stack trace: #0 /test.php(23): DateTime->__construct(’13/02/2013′) #1 thrown in /test.php on line 23
Which means that only slashes format actually wants you to use American order of date parts. Hence you should use ‘dd-mm-yyyy’ or ‘mm/dd/yyyy’ Which is weird, and should not be such.
PHP version is 5.4.40
Notice php by default assume the give string as such format: ‘-‘ is ‘y-m-d’ ‘/’ is ‘m/d/y’
Unless the given string has Y or M, that is year is written as full year ‘2019’, or month is written as English shorthand ‘Jan’, the default assumption will be applied, where the date might be incorrect.
The following code show a quick test: (true as of php 7.2) $date = [ ‘2019-1-3’, ’19-1-3′, ‘3-1-2019’, ‘3-Jan-19’, ‘3-1-19’, //php assume as y-m-d not d-m-y
‘2019/3/1’, ’19/3/1′, //fail, php think is month 19 ‘1/3/2019’, //php think is m/d/y ‘1/3/19’ ];
PHP date() format when inserting into datetime in MySQL
What is the correct format to pass to the date() function in PHP if I want to insert the result into a MySQL datetime type column?
I’ve been trying date(‘Y-M-D G:i:s’) but that just inserts «0000-00-00 00:00:00» everytime.
13 Answers 13
Try: date(‘Y-m-d H:i:s’) which uses the numeric equivalents.
From the comments of php’s date() manual page:
Here’s an alternative solution: if you have the date in PHP as a timestamp, bypass handling it with PHP and let the DB take care of transforming it by using the FROM_UNIXTIME function.
I use the following PHP code to create a variable that I insert into a MySQL DATETIME column.
This will hold the server’s current Date and Time.
I use this function (PHP 7)
Older versions of PHP (PHP
Format time stamp to MySQL DATETIME column :
Format MySQL datetime with PHP
There is no need no use the date() method from PHP if you don’t use a timestamp. If dateposted is a datetime column, you can insert the current date like this:
This has been driving me mad looking for a simple answer. Finally I made this function that seems to catch all input and give a good SQL string that is correct or at least valid and checkable. If it’s 1999-12-31 it’s probably wrong but won’t throw a bad error in MySQL.
Note: I understood the question referring to current time.
