# mysql2date()

URL: https://chugunov.pro/api-wordpress/functions/mysql2date/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 0.71.

## Сигнатура

```php
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` `string` — обязательный. Формат возвращаемой даты.
- `$date` `string` — обязательный. Строка даты для преобразования.
- `$translate` `bool` — необязательный, по умолчанию `true`. Нужно ли переводить возвращаемую дату.

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

`string|int|false` — $format 'U' 'G'

## Исходный код

Файл: `wp-includes/functions.php:35`

```php
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.

## Связанные

Использует: [`wp_timezone`](https://chugunov.pro/api-wordpress/functions/wp_timezone/), [`wp_date`](https://chugunov.pro/api-wordpress/functions/wp_date/).
Используется в: `WP_Customize_Manager::save_changeset_post`, [`wp_check_comment_flood`](https://chugunov.pro/api-wordpress/functions/wp_check_comment_flood/), [`mysql_to_rfc3339`](https://chugunov.pro/api-wordpress/functions/mysql_to_rfc3339/), `WP_MS_Sites_List_Table::column_lastupdated`, `WP_MS_Sites_List_Table::column_registered`, `WP_MS_Users_List_Table::column_registered`, [`export_wp`](https://chugunov.pro/api-wordpress/functions/export_wp/), [`get_inline_data`](https://chugunov.pro/api-wordpress/functions/get_inline_data/), [`touch_time`](https://chugunov.pro/api-wordpress/functions/touch_time/), [`get_media_item`](https://chugunov.pro/api-wordpress/functions/get_media_item/), [`wp_ajax_wp_fullscreen_save_post`](https://chugunov.pro/api-wordpress/functions/wp_ajax_wp_fullscreen_save_post/), [`wp_ajax_find_posts`](https://chugunov.pro/api-wordpress/functions/wp_ajax_find_posts/), [`wp_get_archives`](https://chugunov.pro/api-wordpress/functions/wp_get_archives/), [`the_date_xml`](https://chugunov.pro/api-wordpress/functions/the_date_xml/), [`get_boundary_post_rel_link`](https://chugunov.pro/api-wordpress/functions/get_boundary_post_rel_link/), [`get_parent_post_rel_link`](https://chugunov.pro/api-wordpress/functions/get_parent_post_rel_link/), `WP::send_headers`, [`get_adjacent_post_link`](https://chugunov.pro/api-wordpress/functions/get_adjacent_post_link/), [`get_adjacent_post_rel_link`](https://chugunov.pro/api-wordpress/functions/get_adjacent_post_rel_link/), `Walker_Page::start_el`, [`wp_prepare_attachment_for_js`](https://chugunov.pro/api-wordpress/functions/wp_prepare_attachment_for_js/), [`wpmu_validate_user_signup`](https://chugunov.pro/api-wordpress/functions/wpmu_validate_user_signup/), [`wpmu_validate_blog_signup`](https://chugunov.pro/api-wordpress/functions/wpmu_validate_blog_signup/), `wp_xmlrpc_server::wp_editPost`, `wp_xmlrpc_server::_convert_date`, `IXR_Date`, `wp_xmlrpc_server::_convert_date_gmt`, [`get_comment_time`](https://chugunov.pro/api-wordpress/functions/get_comment_time/), [`get_comment_date`](https://chugunov.pro/api-wordpress/functions/get_comment_date/), `_WP_Editors::wp_link_query`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/mysql2date/