Функция PHP date()

Функции даты и времени PHP

Пример

Форматирует локальную дату и время и возвращает отформатированную строку даты:

<?php
// Вывод дня
echo date("l") . "<br>";
// Вывод дня, даты, месяца, года, времени AM или PM
echo date("l jS \of F Y h:i:s A");
?>

Пример работы

Определение и использование

Функция date() форматирует локальную дату и время и возвращает отформатированную строку даты.

Синтаксис

date(format,timestamp);
Параметр Описание
format

Обязателен. Определяет формат выводимой строки даты.

  • d - день месяца (от 01 до 31)
  • D - текстовое обозначение дня недели (тремя буквами)
  • j - день месяца без fühерующих нулей (от 1 до 31)
  • l (малая форма 'L') - полное текстовое обозначение дня недели
  • N - цифровое обозначение дня недели в формате ISO-8601 (1 - Monday[понедельник], 7 - Sunday[воскресенье])
  • S - суффикс порядкового числа дня месяца (два символа: st, nd, rd или th. Используется с j)
  • w - цифровое обозначение дня недели (0 - Sunday[воскресенье], 6 - Saturday[суббота])
  • z - день года (от 0 до 365)
  • W - номер недели в году в формате ISO-8601 (неделя начинается с Monday[понедельника])
  • F - полное текстовое обозначение месяца (от January[января] до December[декабря])
  • m - цифровое обозначение месяца (от 01 до 12)
  • M - краткое текстовое обозначение месяца (тремя буквами)
  • n - цифровое обозначение месяца без fühерующих нулей (от 1 до 12)
  • t - количество дней в данном месяце
  • L - является ли год високосным (если да, то 1,否则 0)
  • o - годовой номер в формате ISO-8601
  • Y - четырехзначное обозначение года
  • y - двухзначное обозначение года
  • a - малая форма обозначения: am или pm
  • A - верхний регистр也表示 AM или PM
  • B - Swatch Internet Time (000 до 999)
  • g - время в 12-часовом формате без ведущей нольи (1 до 12)
  • G - время в 24-часовом формате без ведущей нольи (0 до 23)
  • h - время в 12-часовом формате, с ведущей нолью (01 до 12)
  • H - время в 24-часовом формате, с ведущей нолью (00 до 23)
  • i - минуты, с ведущей нолью (00 до 59)
  • s - секунды, с ведущей нолью (00 до 59)
  • u - микросекунды (добавлено в PHP 5.2.2)
  • e - идентификатор часового пояса (например: UTC, GMT, Atlantic/Azores)
  • I (большие буквы i) - является ли дата в летнее время (если да, то 1,否则 0)
  • O - разница с格林вичским временем (GMT) в часах (например: +0100)
  • P - разница с格林вичским временем (GMT) в формате hours:minutes (добавлено в PHP 5.1.3)
  • T - аббревиатура часового пояса (например: EST, MDT)
  • Z - смещение часового пояса в секундах. Для западных часовых поясов смещение отрицательное (-43200 до 50400)
  • c - дата в формате ISO-8601 (например: 2013-05-05T16:34:42+00:00)
  • r - дата в формате RFC 2822 (например: Пт, 12 апр 2013 12:01:05 +0200)
  • U - количество секунд, прошедших с Unix эры (1 января 1970 00:00:00 GMT)

Кроме того, можно использовать следующие предопределенные константы (с PHP 5.1.0):

  • DATE_ATOM - Atom (например: 2013-04-12T15:52:01+00:00)
  • DATE_COOKIE - HTTP Cookies (например: Пятница, 12-апр-13 15:52:01 UTC)
  • DATE_ISO8601 - ISO-8601 (например: 2013-04-12T15:52:01+0000)
  • DATE_RFC822 - RFC 822 (например: Пт, 12 апр 13 15:52:01 +0000)
  • DATE_RFC850 - RFC 850 (например: Пятница, 12-апр-13 15:52:01 UTC)
  • DATE_RFC1036 - RFC 1036 (например: Пт, 12 апр 13 15:52:01 +0000)
  • DATE_RFC1123 - RFC 1123 (например: Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC2822 - RFC 2822 (Fri, 12 Apr 2013 15:52:01 +0000)
  • DATE_RFC3339 - Как DATE_ATOM (с PHP 5.1.3)
  • DATE_RSS - RSS (Fri, 12 Aug 2013 15:52:01 +0000)
  • DATE_W3C - Веб-сайт W3C (например: 2013-04-12T15:52:01+00:00)
timestamp Опционально. Определяет целое число Unix-временной метки. По умолчанию это текущее местное время (time()).

Технические детали

Возврат значений: Возвращает отформатированную строку даты, если успешно, в противном случае генерируется ошибка E_WARNING и возвращается FALSE.
Версия PHP: 4+
Журнал обновлений:

PHP 5.1.0: Добавлены E_STRICT и E_NOTICE для ошибок часового пояса. Валидный диапазон временных меток с 13 декабря 1901 года в 20:45:54 GMT пятница до 19 января 2038 года в 03:14:07 GMT вторник. В версиях 5.1.0 и ранее, на некоторых системах (например, Windows) временные метки ограничены от 01-01-1970 до 19-01-2038.

PHP 5.1.1: Добавлены стандартные константы формата даты/времени, используемые для указания format Параметры.

Функции даты и времени PHP