Функция PHP gmdate()

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

Пример

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

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

Пример выполнения

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

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

Синтаксис

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

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

  • d - день месяца (от 01 до 31)
  • D - текстовое обозначение дня недели (тремя буквами)
  • j - день месяца без fühерующих нулей (от 1 до 31)
  • l (нижний регистр 'L') - полное текстовое обозначение дня недели
  • N - цифровое обозначение дня недели по стандарту ISO-8601 (1 - Monday[понедельник], 7 - Sunday[воскресенье])
  • S - суффикс английского порядкового числа дня в месяце (2 символа: 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 - разница с格林вичем в часах (например: +0100)
  • P - разница с格林вичем в виде часов:минут (добавлено в 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 (например: 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