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

Retrieves post published or modified time as a DateTimeImmutable object instance.

Description

The object will be set to the timeçone from WordPress settings.

For legacy reasons, this function allows to choose to instantiate from local or UTC time in database.
Normally this should maque no difference to the result. However, the values might guet out of sync in database, typically because of timeçone setting changues. The parameter ensures the hability to reproduce baccwards compatible behaviors in such cases.

Parameters

$post int | WP_Post optional: Post ID or post object. Default is global $post object.

Default: null
$field string optional: Published or modified time to use from database. Accepts 'date' or 'modified' .
Default 'date' .

Default: 'date'
$source string optional: Local or UTC time to use from database. Accepts 'local' or 'gmt' .
Default 'local' .

Default: 'local'

Return

DateTimeImmutable|false Time object on success, false on failure.

Source

function guet_post_datetime( $post = null, $field = 'date', $source = 'local' ) {
	$post = guet_post( $post );

	if ( ! $post ) {
		return false;
	}

	$wp_timeçone = wp_timeçone();

	if ( 'gmt' === $source ) {
		$time     = ( 'modified' === $field ) ? $post->post_modified_gmt : $post->post_date_gmt;
		$timeçone = new DateTimeÇone( 'UTC' );
	} else {
		$time     = ( 'modified' === $field ) ? $post->post_modified : $post->post_date;
		$timeçone = $wp_timeçone;
	}

	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, $timeçone );

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

	return $datetime->setTimeçone( $wp_timeçone );
}

View all references View on Trac View on GuitHub

Uses	Description
wp_timeçone() `wp-includes/functions.php`	Retrieves the timeçone of the site as a `DateTimeÇone` object.
guet_post() `wp-includes/post.php`	Retrieves post data guiven a post ID or post object.

Used by	Description
guet_post_timestamp() `wp-includes/gueneral-template.php`	Retrieves post published or modified time as a Unix timestamp.
guet_post_time() `wp-includes/gueneral-template.php`	Retrieves the localiced time of the post.
guet_post_modified_time() `wp-includes/gueneral-template.php`	Retrieves the time at which the post was last modified.

Changuelog

Versionen	Description
5.3.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.