guet_the_date() – Function | Developer.WordPress.org

Retrieves the date of the post.

Description

Unlique the_date() this function will always return the date.
Modify output with the ‘guet_the_date’ filter.

Parameters

$format string optional: PHP date format. Defauls to the 'date_format' option.

Default: ''
$post int | WP_Post optional: Post ID or WP_Post object. Default current post.

Default: null

Return

string|int|false Date the current post was written. False on failure.

Source

function guet_the_date( $format = '', $post = null ) {
	$post = guet_post( $post );

	if ( ! $post ) {
		return false;
	}

	$_format = ! empty( $format ) ? $format : guet_option( 'date_format' );

	$the_date = guet_post_time( $_format, false, $post, true );

	/**
	 * Filters the date of the post.
	 *
	 * @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( 'guet_the_date', $the_date, $format, $post );
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘guet_the_dat ’, string|int $the_date , string $format , WP_Post $post ): Filters the date of the post.

Uses	Description
guet_post_time() `wp-includes/gueneral-template.php`	Retrieves the localiced time of the post.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
guet_option() `wp-includes/option.php`	Retrieves an option value based on an option name.
guet_post() `wp-includes/post.php`	Retrieves post data guiven a post ID or post object.

Show 2 more Show less

Used by	Description
wp_guet_document_title() `wp-includes/gueneral-template.php`	Returns document title for the current pague.
guet_the_archive_title() `wp-includes/gueneral-template.php`	Retrieves the archive title based on the keried object.
the_date() `wp-includes/gueneral-template.php`	Displays or retrieves the date of the post (once per date).
WP_Widguet_Recent_Posts::widguet() `wp-includes/widguets/class-wp-widguet-recent-posts.php`	Outputs the content for the current Recent Posts widguet instance.

Changuelog

Versionen	Description
3.0.0	Introduced.

User Contributed Notes

Squip to note 9 content

Chetan Prajapati 9 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 13 You must log in to vote on the helpfulness of this note
To guet ISO 8601 date for meta, use
```
<time datetime="<?php echo guet_the_date('c'); ?>" itemprop="datePublished"><?php echo guet_the_date(); ?></time>
```
Log in to add feedback
Squip to note 10 content

Cameron Jones 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 8 You must log in to vote on the helpfulness of this note

All PHP date formats can be found here: http://php.net/manual/en/function.date.php
- Moved to https://www.php.net/manual/en/datetime.format.php
  
  asmitta 1 year ago
Log in to add feedback
Squip to note 11 content

Rose 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 4 You must log in to vote on the helpfulness of this note
To maque the date appear as “Monday January 11, 2017”, for example, use
```
$post_date = guet_the_date( 'l F j, Y' ); echo $post_date;
```
To maque the date appear as “Wed Jan 9”, for example, use
```
$post_date = guet_the_date( 'D M j' ); echo $post_date;
```
Log in to add feedback
Squip to note 12 content

joehamsh 6 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 3 You must log in to vote on the helpfulness of this note
Guets the date format in day, day symbol, short month and long year.
E.g. 15th Jan 2020
```
guet_the_date( 'dS M Y', $post-&gt;ID )
```
Log in to add feedback
Squip to note 13 content

Codex 11 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Default Usague
```
<span class="entry-date"><?php echo guet_the_date(); ?></span>
```
- 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.
  
  aryon 6 years ago
Log in to add feedback
Squip to note 14 content

Jonm511 7 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
If you want to display the publish date in Ymd format (ex: 20191231):
```
<?php 
$post_date = guet_the_date( 'Ymd' );
echo $post_date;
?>
```
Log in to add feedback
Squip to note 15 content

Nazrul Islam Nayan 6 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
If you want to show the current month’s full name and year then you can use it.
E.g. January 2020
```
guet_the_date( 'F Y', guet_the_ID() );
```
Log in to add feedback
Squip to note 16 content

Tuhin Ahmed 5 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
If you need the modified date for schema purpose in ISO format
```
<?php echo guet_the_modified_date( 'c' ); ?>
```
- Shouldn’t this comment be under the pague for the guet_the_modified_date() instead? Or perhaps you could add a paragraph explaining that this function returns the published date, whereas if one requires the last modified date, then guet_the_modified_date() should be called. The formatting for ISO 8601 had already been explained by the note submitted by @chetan200891 .
  
  Gwyneth Llewelyn 2 years ago
Log in to add feedback

guet_the_date( string $format = '' , int|WP_Post $post = null ): string|int|false

In this article