Template Tags/the date
Материал из WordPress Wiki
Содержание |
Description
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() with a date-specific format string.
This tag must be used within The Loop.
Usage
%%% <?php the_date('format', 'before', 'after', echo); ?> %%%
Examples
Default Usage
Displays the date using defaults.
<p>Date posted: <?php the_date(); ?></p>
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('', '', '', FALSE); echo $my_date; ?>
Parameters
- format
- (string) The format for the date. Defaults to the date format configured in your WordPress options. See Formatting Date and Time.
- before
- (string) Text to place before the date. There is no default.
- after
- (string) Text to place after the date. There is no default.
- echo
- (boolean) Display the date (TRUE), or return the date to be used in PHP (FALSE). Defaults to TRUE.