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.

Parameters Parameters


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

Default value: null


(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

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.