array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.gmstrftime.php', 1 => 'gmstrftime', 2 => 'Форматирует дату и время как время UTC с учётом региональных настроек', ), 'up' => array ( 0 => 'ref.datetime.php', 1 => 'Функции даты и времени', ), 'prev' => array ( 0 => 'function.gmmktime.php', 1 => 'gmmktime', ), 'next' => array ( 0 => 'function.idate.php', 1 => 'idate', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/datetime/functions/gmstrftime.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

gmstrftime

(PHP 4, PHP 5, PHP 7, PHP 8)

gmstrftime — Форматирует дату и время как время UTC с учётом региональных настроек

Внимание

Функция УСТАРЕЛА с PHP 8.1.0. Полагаться на функцию настоятельно не рекомендуют.

Разработчикам доступны следующие альтернативы:

Описание

#[\Deprecated]
gmstrftime(string $format, ?int $timestamp = null): string|false

Функция работает аналогично функции strftime(), но игнорирует смещение времени в текущем часовом поясе и форматирует метку времени как UTC-время с учётом региональных настроек. Например, при запуске в системе, в которой установили часовой пояс Eastern Standard Time со смещением GMT-0500, первая строка приведённого примера выведет "Dec 31 1998 20:00:00", а вторая — "Jan 01 1999 01:00:00".

Внимание

Функция зависит от региональных настроек операционной системы, которые не гарантируют совместимость или доступность региональных настроек в другой ОС. Для форматирования даты без влияния региональных настроек ОС вызывают метод IntlDateFormatter::format().

Список параметров

format

См. описание функции strftime().

timestamp

Необязательный параметр timestamp — целочисленная (int) метка времени, которая по умолчанию равна текущему местному времени, если параметр timestamp не указали или равен null. Говоря по другому, значение по умолчанию равно результату функции time().

Возвращаемые значения

Функция возвращает строку в заданном формате. Функция форматирует дату и время на основе метки времени, которую передали в аргументе timestamp, или текущего локального времени, если метку времени не указали. Названия месяцев, дней недели и других языкозависимых строк учитывают настройки текущей локали, которую установили функцией setlocale(). Функция возвращает значение false, если возникла ошибка.

Список изменений

Версия Описание
8.0.0 Параметр timestamp теперь принимает значение null.

Примеры

Пример #1 Пример форматирования даты и времени как UTC-времени с учетом текущей локали функцией gmstrftime()

<?php

setlocale(LC_TIME, 'en_US');

echo strftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";
echo gmstrftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";

Смотрите также