mysql2date() — описание функции WordPress на русском

Сигнатура

mysql2date( string $format, string $date, bool $translate = true ): string|int|false

Описание

$format должен быть строкой формата даты PHP.

Форматы «U» и «G» возвращают целочисленную сумму метки времени и смещения часового пояса.

Ожидается, что $date — это местное время в формате MySQL (Y-m-d H:i:s).

Исторически в функцию можно было передать время UTC для получения метки времени Unix.
Если $translate равно true, то указанные дата и строка формата будут переданы в wp_date() для перевода.

Оригинал (английский)

$format should be a PHP date format string.
‘U’ and ‘G’ formats will return an integer sum of timestamp with timezone offset.
$date is expected to be local time in MySQL format (Y-m-d H:i:s).

Historically UTC time could be passed to the function to produce Unix timestamp.

If $translate is true then the given date and format string will be passed to wp_date() for translation.

Параметры

$format string обязательный

Формат возвращаемой даты.

$date string обязательный

Строка даты для преобразования.

$translate bool необязательный = true

Нужно ли переводить возвращаемую дату.

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

string|int|false

$format 'U' 'G'

Исходный код

wp-includes/functions.php:35

function mysql2date( $format, $date, $translate = true ) {
	if ( empty( $date ) ) {
		return false;
	}

	$timezone = wp_timezone();
	$datetime = date_create( $date, $timezone );

	if ( false === $datetime ) {
		return false;
	}

	// Returns a sum of timestamp with timezone offset. Ideally should never be used.
	if ( 'G' === $format || 'U' === $format ) {
		return $datetime->getTimestamp() + $datetime->getOffset();
	}

	if ( $translate ) {
		return wp_date( $format, $datetime->getTimestamp(), $timezone );
	}

	return $datetime->format( $format );
}

История изменений

Версия	Описание
0.71	Introduced.