Перевести формат региональных настроек в маску PHP Date::convertFormatToPhp
Модуль: main — подключать отдельно не нужно
Доступно с версии: 14.0.18
Метод Date::convertFormatToPhp переводит формат даты из нотации региональных настроек, например DD.MM.YYYY HH:MI:SS, в маску PHP. Классический метод CDatabase::DateFormatToPHP вызывает этот метод.
Сигнатура метода в классе Bitrix\Main\Type\Date:
public static function convertFormatToPhp($format)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| format* | string |
Задает формат в нотации региональных настроек |
Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод возвращает маску PHP. Метод заменяет обозначения по таблице, остальные символы оставляет без изменений.
| Обозначение | Маска PHP | Значение |
|---|---|---|
YYYY |
Y |
Год из четырех цифр |
MMMM |
F |
Полное название месяца на английском |
MM |
m |
Месяц с ведущим нулем |
DD |
d |
День с ведущим нулем |
TT |
A |
AM или PM |
T |
a |
am или pm |
MI |
i |
Минуты с ведущим нулем |
SS |
s |
Секунды с ведущим нулем |
HH |
H |
Час от 00 до 23 |
H |
h |
Час от 01 до 12 |
GG |
G |
Час от 0 до 23 без ведущего нуля |
G |
g |
Час от 1 до 12 без ведущего нуля |
Одиночную H метод переводит в h, только если в формате нет HH. Одиночную G — только если нет GG.
Примеры
Пример. Код переводит в маски PHP два формата с 24-часовым и 12-часовым временем:
<?php
use Bitrix\Main\Type\Date;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
echo Date::convertFormatToPhp('DD.MM.YYYY HH:MI:SS') . ' | ' . Date::convertFormatToPhp('MM/DD/YYYY H:MI:SS T');
Код выведет d.m.Y H:i:s | m/d/Y h:i:s a.