date
Returns a string formatted according to the given format string using the given integer timestamp (Unix timestamp) or the current time if no timestamp is given. In other words, timestamp is optional and defaults to the value of time() .
Unix timestamps do not handle timezones. Use the DateTimeImmutable class, and its DateTimeInterface::format() formatting method to format date/time information with a timezone attached.
Parameters
Note: date() will always generate 000000 as microseconds since it takes an int parameter, whereas DateTime::format() does support microseconds if DateTime was created with microseconds.
The optional timestamp parameter is an int Unix timestamp that defaults to the current local time if timestamp is omitted or null . In other words, it defaults to the value of time() .
Return Values
Returns a formatted date string.
Errors/Exceptions
Every call to a date/time function will generate a E_WARNING if the time zone is not valid. See also date_default_timezone_set()
Changelog
| Version | Description |
|---|---|
| 8.0.0 | timestamp is nullable now. |
Examples
Example #1 date() examples
// set the default timezone to use.
date_default_timezone_set ( ‘UTC’ );
// Prints something like: Monday
echo date ( «l» );
// Prints something like: Monday 8th of August 2005 03:12:46 PM
echo date ( ‘l jS \of F Y h:i:s A’ );
// Prints: July 1, 2000 is on a Saturday
echo «July 1, 2000 is on a » . date ( «l» , mktime ( 0 , 0 , 0 , 7 , 1 , 2000 ));
/* use the constants in the format parameter */
// prints something like: Wed, 25 Sep 2013 15:28:57 -0700
echo date ( DATE_RFC2822 );
// prints something like: 2000-07-01T00:00:00+00:00
echo date ( DATE_ATOM , mktime ( 0 , 0 , 0 , 7 , 1 , 2000 ));
?>
You can prevent a recognized character in the format string from being expanded by escaping it with a preceding backslash. If the character with a backslash is already a special sequence, you may need to also escape the backslash.
Example #2 Escaping characters in date()
It is possible to use date() and mktime() together to find dates in the future or the past.
Example #3 date() and mktime() example
$tomorrow = mktime ( 0 , 0 , 0 , date ( «m» ) , date ( «d» )+ 1 , date ( «Y» ));
$lastmonth = mktime ( 0 , 0 , 0 , date ( «m» )- 1 , date ( «d» ), date ( «Y» ));
$nextyear = mktime ( 0 , 0 , 0 , date ( «m» ), date ( «d» ), date ( «Y» )+ 1 );
?>
Note:
This can be more reliable than simply adding or subtracting the number of seconds in a day or month to a timestamp because of daylight saving time.
Some examples of date() formatting. Note that you should escape any other characters, as any which currently have a special meaning will produce undesirable results, and other characters may be assigned meaning in future PHP versions. When escaping, be sure to use single quotes to prevent characters like \n from becoming newlines.
Example #4 date() Formatting
// Assuming today is March 10th, 2001, 5:16:18 pm, and that we are in the
// Mountain Standard Time (MST) Time Zone
$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 (the MySQL DATETIME format)
?>
To format dates in other languages, IntlDateFormatter::format() can be used instead of date() .
Notes
Note:
To generate a timestamp from a string representation of the date, you may be able to use strtotime() . Additionally, some databases have functions to convert their date formats into timestamps (such as MySQL’s » UNIX_TIMESTAMP function).
Timestamp of the start of the request is available in $_SERVER[‘REQUEST_TIME’] .
See Also
- DateTimeImmutable::__construct() — Returns new DateTimeImmutable object
- DateTimeInterface::format() — Returns date formatted according to given format
- gmdate() — Format a GMT/UTC date/time
- idate() — Format a local time/date part as integer
- getdate() — Get date/time information
- getlastmod() — Gets time of last page modification
- mktime() — Get Unix timestamp for a date
- IntlDateFormatter::format() — Format the date/time value as a string
- time() — Return current Unix timestamp
- Predefined DateTime Constants
User Contributed Notes
- Date/Time Functions
- checkdate
- date_add
- date_create_from_format
- date_create_immutable_from_format
- date_create_immutable
- date_create
- date_date_set
- date_default_timezone_get
- date_default_timezone_set
- date_diff
- date_format
- date_get_last_errors
- date_interval_create_from_date_string
- date_interval_format
- date_isodate_set
- date_modify
- date_offset_get
- date_parse_from_format
- date_parse
- date_sub
- date_sun_info
- date_sunrise
- date_sunset
- date_time_set
- date_timestamp_get
- date_timestamp_set
- date_timezone_get
- date_timezone_set
- date
- getdate
- gettimeofday
- gmdate
- gmmktime
- gmstrftime
- idate
- localtime
- microtime
- mktime
- strftime
- strptime
- strtotime
- time
- timezone_abbreviations_list
- timezone_identifiers_list
- timezone_location_get
- timezone_name_from_abbr
- timezone_name_get
- timezone_offset_get
- timezone_open
- timezone_transitions_get
- timezone_version_get
Php дата yyyy mm dd
На этой странице описаны форматы даты в BNF-подобном синтаксисе, которые понимает парсер функций: DateTimeImmutable , DateTime , date_create() , date_create_immutable() и strtotime() .
Чтобы отформатировать объекты DateTimeImmutable и DateTime , обратитесь к документации метода DateTimeInterface::format() .
Используемые символы
Описание Формат Примеры daysuf (суффикс порядкового числительного дня месяца) «st» | «nd» | «rd» | «th» dd (день месяца без ведущих нулей) (2?8 | «3»[01]) daysuf ? «7th», «22nd», «31» DD (день месяца, 2 цифры с ведущим нулём) «0» 9 | 28 | «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»? 4 | «1»1 «0», «04», «7», «12» MM (порядковый номер месяца, 2 цифры с ведущим нулём) «0» 7 | «1»2 «00», «04», «07», «12» y (порядковый номер года) 5 «00», «78», «08», «8», «2008» yy (порядковый номер года, 2 цифры) 3 «00», «08», «78» YY (порядковый номер года, 4 цифры) 8 «2000», «2008», «1978» YYY 2 «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» Нотации ISO8601
Описание Формат Примеры 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 . Если год попадает в диапазон 0-69 (включительно), то к нему добавляется 2000. Если же год принадлежит диапазону 70-99 (включительно), то к нему добавляется 1900. Это означает, что дата «00-01-01» интерпретируется как «2000-01-01».
Замечание:
Формат «День, месяц и 2 цифры года с разделителем в виде точки или символа табуляции» ( dd [.\t] mm «.» yy ) работает только для годов из диапазона 61-99 (включительно). За пределами этого диапазона отдаётся предпочтение формату времени » HH [.:] MM [.:] SS «.
Замечание:
Формат «Только год» задействуется только в случае, если строка времени была найдена. В противном случае отдаётся предпочтению формату HH MM .
Возможен выход за границы диапазона форматов 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 год до н.э. по григорианскому календарю).
User Contributed Notes
date() – форматирование даты PHP
date($format, $timestamp) – форматирует дату/время по шаблону, где:
Результат работы функции зависит от настроек часового пояса, установить его можно следующем образом:
Основные параметры шаблона
Символ Описание Пример возвращаемого значения День j День месяца без ведущего нуля от 1 до 31 d День месяца, 2 цифры с ведущим нулём от 01 до 31 l Полное наименование дня недели от Sunday до Saturday D День недели, 3 символа от Mon до Sun z Порядковый номер дня в году От 0 до 365 Неделя N Порядковый номер дня недели от 1 (понедельник)
до 7 (воскресенье)W Порядковый номер недели года Например: 42 (42-я неделя года) Месяц n Порядковый номер месяца без ведущего нуля от 1 до 12 m Порядковый номер месяца с ведущим нулём от 01 до 12 F Полное название месяца от January до December M Сокращенное наименование месяца, 3 символа от Jan до Dec t Количество дней в месяце от 28 до 31 Год Y Год, 4 цифры 2019 y Год, 2 цифры 19 Время g Часы в 12-часовом формате без ведущего нуля от 1 до 12 h Часы в 12-часовом формате с ведущим нулём от 01 до 12 G Часы в 24-часовом формате без ведущего нуля от 0 до 23 H Часы в 24-часовом формате с ведущим нулём от 00 до 23 i Минуты с ведущим нулём от 00 до 59 s Секунды с ведущим нулём от 00 до 59 v Миллисекунды 123 Полная дата/время c Дата в формате ISO 8601 2004-02-12T15:19:21+00:00 r Дата в формате RFC 2822 Thu, 21 Dec 2000 16:01:07 +0200 дд.мм.ггг (dd.mm.yyyy)
Самый распространенные форматы: dd.mm.yyyy и dd.mm.yyyy hh:ss .
echo date('d.m.Y'); // 28.07.2023 echo date('d.m.Y H:i'); // 28.07.2023 00:28 echo date('d.m.Y H:i:s'); // 28.07.2023 00:28:37гггг-мм-дд (yyyy.mm.dd)
Используется в MySQL тип поля DATE.