WordPress.org

Languages: English • Deutsch • 日本語 (Add your language)

Description

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

This tag must be used within The Loop.

Usage

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

Parameters

$format

(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

$before

(string) (optional) Text to place before the date.

Default: None

$after

(string) (optional) Text to place after the date

Default: None

$echo

(boolean) (optional) Display the date (TRUE), or return the date to be used in PHP (FALSE).

Default: TRUE

Return

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

Examples

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

Notes

• Affects the return value of the is_new_day() function.

Change Log

Since: 0.71

Source File

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

Related

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()