# get_post_datetime()

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

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

## Сигнатура

```php
get_post_datetime( int|WP_Post|null $post = null, string $field = 'date', string $source = 'local' ): DateTimeImmutable|false
```

## Описание

Объект будет установлен в часовой пояс из настроек WordPress.
По историческим причинам эта функция позволяет выбрать, создавать экземпляр из локального времени или из времени UTC в базе данных.
Обычно это никак не влияет на результат. Однако значения в базе данных могут рассинхронизироваться, как правило из-за изменения настройки часового пояса. Параметр обеспечивает возможность воспроизвести обратно совместимое поведение в таких случаях.

## Параметры

- `$post` `int|WP_Post|null` — необязательный, по умолчанию `null`. ID записи или объект записи. По умолчанию — глобальный объект $post .
- `$field` `string` — необязательный, по умолчанию `'date'`. Время публикации или изменения, используемое из базы данных. Принимает 'date' или 'modified'.
  
  Значение по умолчанию 'date'.
- `$source` `string` — необязательный, по умолчанию `'local'`. Локальное время или время UTC, используемое из базы данных. Принимает 'local' или 'gmt'.
  
  Значение по умолчанию 'local'.

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

`DateTimeImmutable|false`

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

Файл: `wp-includes/general-template.php:2952`

```php
function get_post_datetime( $post = null, $field = 'date', $source = 'local' ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return false;
	}

	$wp_timezone = wp_timezone();

	if ( 'gmt' === $source ) {
		$time     = ( 'modified' === $field ) ? $post->post_modified_gmt : $post->post_date_gmt;
		$timezone = new DateTimeZone( 'UTC' );
	} else {
		$time     = ( 'modified' === $field ) ? $post->post_modified : $post->post_date;
		$timezone = $wp_timezone;
	}

	if ( empty( $time ) || '0000-00-00 00:00:00' === $time ) {
		return false;
	}

	$datetime = date_create_immutable_from_format( 'Y-m-d H:i:s', $time, $timezone );

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

	return $datetime->setTimezone( $wp_timezone );
}
```

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

- 5.3.0 — Introduced.

## Связанные

Использует: [`wp_timezone`](https://chugunov.pro/api-wordpress/functions/wp_timezone/), [`get_post`](https://chugunov.pro/api-wordpress/functions/get_post/).
Используется в: [`get_post_timestamp`](https://chugunov.pro/api-wordpress/functions/get_post_timestamp/), [`get_post_time`](https://chugunov.pro/api-wordpress/functions/get_post_time/), [`get_post_modified_time`](https://chugunov.pro/api-wordpress/functions/get_post_modified_time/).

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