Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/the date


Displays or returns the date of a post, or a set of posts if published on the same day.

SPECIAL NOTE: When there are multiple posts on a page published under the SAME DAY, the_date() only displays the date for the first post (that is, the first instance of the_date()). To repeat the date for posts published under the same day, you should use the Template Tag the_time() or get_the_date() (since 3.0) with a date-specific format string.
Use <?php the_time( get_option( 'date_format' ) ); ?> to add the date set in the admin interface.

This tag must be used within The Loop.


 <?php the_date$format$before$after$echo ); ?> 


(string) (optional) The format for the date. Defaults to the date format configured in your WordPress options. See Formatting Date and Time.
Default: F j, Y)
(string) (optional) Text to place before the date.
Default: None
(string) (optional) Text to place after the date
Default: None
(boolean) (optional) Display the date (TRUE), or return the date to be used in PHP (FALSE).
Default: TRUE


(string|null) Null if displaying, string if retrieving.


Default Usage

Displays the date using defaults.

<?php the_date(); ?>

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>'); ?>

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.

<?php $my_date = the_date('', '<h2>', '</h2>', FALSE); echo $my_date; ?>


Change Log

Since: 0.71

Source File

the_date() is located in wp-includes/general-template.php.


get_calendar(), get_day_link(), get_month_link(), get_the_date(), get_the_time(), get_year_link(), single_month_title(), the_date(), the_date_xml(), the_modified_date(), get_the_modified_date(), the_modified_time(), get_the_modified_time(), the_time()

See also index of Function Reference and index of Template Tags.