get_the_date( string $format = '', int|WP_Post $post = null ): string|int|false
Retrieves the date on which the post was written.
Contents
Description
Unlike the_date() this function will always return the date.
Modify output with the ‘get_the_date’ filter.
Parameters
Return
string|int|false Date the current post was written. False on failure.
Source
File: wp-includes/general-template.php.
View all references
function get_the_date( $format = '', $post = null ) {
$post = get_post( $post );
if ( ! $post ) {
return false;
}
$_format = ! empty( $format ) ? $format : get_option( 'date_format' );
$the_date = get_post_time( $_format, false, $post, true );
/**
* Filters the date a post was published.
*
* @since 3.0.0
*
* @param string|int $the_date Formatted date string or Unix timestamp if `$format` is 'U' or 'G'.
* @param string $format PHP date format.
* @param WP_Post $post The post object.
*/
return apply_filters( 'get_the_date', $the_date, $format, $post );
}
Hooks
-
apply_filters( 'get_the_date',
string|int $the_date ,string $format ,WP_Post $post ) -
Filters the date a post was published.
Changelog
| Version | Description |
|---|---|
| 3.0.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
To get ISO 8601 date for meta, use
All PHP date formats can be found here: http://php.net/manual/en/function.date.php
To make the date appear as “Monday January 11, 2017”, for example, use
To make the date appear as “Wed Jan 9”, for example, use
Gets the date format in day, day symbol, short month and long year.
E.g. 15th Jan 2020
Default Usage
Top ↑
Feedback
For Front End Designers: Use this to simply display the month day, year (April 20, 2020) and then style the date with css using .entry-date. — By aryon —
If you want to display the publish date in Ymd format (ex: 20191231):
If you want to show the current month’s full name and year then you can use it.
E.g. January 2020
If you need the modified date for schema purpose in ISO format