Описание функции mysql2date()
Функция mysql2date() преобразует дату и время из формата MySQL (Y-m-d H:i:s) в формат, который используется в PHP. Она позволяет форматировать даты для отображения на сайте в удобочитаемом виде.
Функция полезна при выводе дат публикации записей, комментариев и других временных метаданных, обеспечивая гибкость в представлении информации о времени.
Параметры
$format
Тип: string
Обязательный: Да
По умолчанию: ‘Y-m-d’
Описание: Формат, в который нужно преобразовать дату
Возможные значения:
0: ‘Y-m-d’
1: ‘d/m/Y’
2: ‘F j, Y’
3: ‘l, F j, Y’
$date
Тип: string
Обязательный: Да
По умолчанию: »
Описание: Дата в формате MySQL
Возможные значения:
0: ‘2023-10-04 15:30:00’
1: ‘2023-01-01 00:00:00’
$gmt
Тип: bool
Обязательный: Нет
По умолчанию: false
Описание: Флаг, указывающий, нужно ли использовать время в формате GMT
Возможные значения:
0: 1
1:
Возвращаемое значение
Тип: string
Описание: Преобразованная дата в указанном формате
Возможные значения:
• Отформатированная строка даты при успешном выполнении
• false в случае ошибки
Примеры использования
Преобразование даты без дополнительных параметров
$formatted_date = mysql2date('F j, Y', '2023-10-04 15:30:00');
// Вывод: October 4, 2023
Выводит отформатированную дату
Использование GMT для преобразования даты
$formatted_date_gmt = mysql2date('Y-m-d', '2023-10-04 15:30:00', true);
// Вывод: 2023-10-04
Выводит дату в формате Y-m-d
Безопасность
Валидация входных данных: Функция проверяет формат входной даты
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для вывода дат
— Связанные функции
Получает дату записи в формате WordPress
Получает время публикации записи в формате MySQL
— Хуки
Фильтрует дату перед преобразованием
— Примечания
– Ограничения
Функция ожидает корректный формат даты в MySQL
– Частые проблемы
- false при передаче неверной даты
- Невозможность обработки пустой строки
