get_post_timestamp( int|WP_Post $post = null, string $field = 'date' )

Retrieve post published or modified time as a Unix timestamp.


Description Description

Note that this function returns a true Unix timestamp, not summed with timezone offset like older WP functions.


Top ↑

Parameters Parameters

$post

(int|WP_Post) (Optional) WP_Post object or ID. Default is global $post object.

Default value: null

$field

(string) (Optional) Published or modified time to use from database. Accepts 'date' or 'modified'.

Default value: 'date'


Top ↑

Return Return

(int|false) Unix timestamp on success, false on failure.


Top ↑

Source Source

File: wp-includes/general-template.php

function get_post_timestamp( $post = null, $field = 'date' ) {
	$datetime = get_post_datetime( $post, $field );

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

	return $datetime->getTimestamp();
}


Top ↑

Changelog Changelog

Changelog
Version Description
5.3.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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