PHP gmdate()Функции

PHP Date/TimeСправочное руководство по дате/времени PHP

Примеры

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

<?php
// Выводит день
echo gmdate("l") . "<br>";

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

Запустить пример »

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

Функция gmdate() форматирует дату и время GMT/UTC и возвращает отформатированную строку даты.

Синтаксис

gmdate(format,timestamp);

Параметр Описание
format Обязательный. Задает формат выходной строки даты. Можно использовать следующие символы:
  • d - День месяца (от 01 до 31)
  • D - Текстовое представление дня недели (три буквы)
  • j - День месяца без ведущих нулей (от 1 до 31)
  • l (строчная 'L') - Полное текстовое представление дня недели
  • N - числовое представление дня недели по ISO-8601 (1 для понедельника, 7 для воскресенья)
  • S - Английский суффикс порядкового числительного для дня месяца (2 символа: st, nd, rd или th. Хорошо работает с j)
  • w - Числовое представление дня недели (0 для воскресенья, 6 для субботы)
  • z - День года (от 0 до 365)
  • W - Номер недели в году по ISO-8601 (недели начинаются с понедельника)
  • F - Полное текстовое представление месяца (от января до декабря)
  • m - Числовое представление месяца (от 01 до 12)
  • M - Краткое текстовое представление месяца (три буквы)
  • n - Числовое представление месяца без ведущих нулей (от 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) в часах:минутах (добавлено в PHP 5.1.3)
  • T - Аббревиатура часового пояса (примеры: EST, MDT)
  • Z - Смещение часового пояса в секундах. Смещение для часовых поясов западнее UTC отрицательное (от -43200 до 50400)
  • c - Дата в формате ISO-8601 (например, 2013-05-05T16:34:42+00:00)
  • r - Дата в формате RFC 2822 (например, Fri, 12 Apr 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 (например: Friday, 12-Apr-13 15:52:01 UTC)
  • DATE_ISO8601 - ISO-8601 (например: 2013-04-12T15:52:01+0000)
  • DATE_RFC822 - RFC 822 (например: Fri, 12 Apr 13 15:52:01 +0000)
  • DATE_RFC850 - RFC 850 (например: Friday, 12-Apr-13 15:52:01 UTC)
  • DATE_RFC1036 - RFC 1036 (например: Fri, 12 Apr 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 - Консорциум Всемирной паутины (например: 2013-04-12T15:52:01+00:00)
timestamp Необязательный. Задает целочисленную метку времени Unix. По умолчанию — текущее локальное время (time()).

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

Возвращаемое значение: Возвращает отформатированную строку даты в случае успеха или выдает E_WARNING и возвращает FALSE в случае неудачи.
Версия PHP: 4+
Список изменений: PHP 5.1.0: допустимый диапазон меток времени — с пятницы, 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 Date/TimeСправочное руководство PHP по дате/времени Другие расширения