the_date() – Function | Developer.WordPress.org

Displays or retrieves the date the current post was written (once per date)

Description

Will only output the date if the current post’s date is different from the previous one output.

i.e. Only one date listing will show per day worth of posts shown in the loop, even if the function is called several times for each post.

HTML output can be filtered with ‘the_date’.
Date string output can be filtered with ‘get_the_date’.

Parameters

$formatstringoptional: PHP date format. Defaults to the 'date_format' option.
Default:''
$beforestringoptional: Output before the date.
Default:''
$afterstringoptional: Output after the date.
Default:''
$displaybooloptional: Whether to echo the date or return it.
Default:true

Return

string|void String if retrieving.

Source

function the_date( $format = '', $before = '', $after = '', $display = true ) {
	global $currentday, $previousday;

	$the_date = '';

	if ( is_new_day() ) {
		$the_date    = $before . get_the_date( $format ) . $after;
		$previousday = $currentday;
	}

	/**
	 * Filters the date a post was published for display.
	 *
	 * @since 0.71
	 *
	 * @param string $the_date The formatted date string.
	 * @param string $format   PHP date format.
	 * @param string $before   HTML output before the date.
	 * @param string $after    HTML output after the date.
	 */
	$the_date = apply_filters( 'the_date', $the_date, $format, $before, $after );

	if ( $display ) {
		echo $the_date;
	} else {
		return $the_date;
	}
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘the_date’, string $the_date, string $format, string $before, string $after ): Filters the date a post was published for display.

Uses	Description
get_the_date()`wp-includes/general-template.php`	Retrieves the date on which the post was written.
is_new_day()`wp-includes/functions.php`	Determines whether the publish date of the current post in the loop is different from the publish date of the previous post in the loop.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Show 1 more Show less

Changelog

Version	Description
0.71	Introduced.

User Contributed Notes

Skip to note 6 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 4You must log in to vote on the helpfulness of this note
Date as Year, Month, Date in Heading
Displays the date using the ‘2007-07-23’ format (ex: 2004-11-30), inside an <h2> tag.
```
<?php the_date( 'Y-m-d', '<h2>', '</h2>' ); ?>
```
Log in to add feedback
Skip to note 7 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note
Default Usage
Displays the date using defaults.
```
<?php the_date(); ?>
```
Log in to add feedback
Skip to note 8 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note
Date in Heading Using $my_date Variable
Returns the date in the default format inside an <h2> tag and assigns it to the $my_date variable. The variable’s value is then displayed with the PHP echo command.
```
$my_date = the_date( '', '<h2>', '</h2>', false );
echo $my_date;
```
Log in to add feedback
Skip to note 9 content

Ruhul Amin 4 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
As stated in the documentation if there are multiple posts from the same day, it will only show once.
To show the date for posts published under same day, we should use the template tag the_time() or get_the_date() with a date-specific format string.
```
<?php echo get_the_date(); ?> 
// get_the_date() return the date doesn't echo the date, so have to echo to show it

// or use the_time() with date-specific format
<?php the_time( 'd F Y' ); ?>
```
Both functions takes an optional parameter which follows the PHP Date Format
Log in to add feedback
Skip to note 10 content

Ibrahim khalil 3 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
//add a specific date format with your loop

//example format: November 10, 2021. here You can see date Format String Examples::
```
<?php the_time( 'F j, Y' );?>
```
Log in to add feedback

the_date( string $format = ”, string $before = ”, string $after = ”, bool $display = true ): string|void

In this article