wpseek.com
Uma área de pesquisa sobre o WordPress para devs e autores do tema



the_date › WordPress Function

Desde0.71
Obsoleton/a
› the_date ( $format = '', $before = '', $after = '', $display = true )
Parâmetros: (4)
  • (string) $format Optional. PHP date format. Defaults to the 'date_format' option.
    Required: No
    Padrão: (empty)
  • (string) $before Optional. Output before the date. Default empty.
    Required: No
    Padrão: (empty)
  • (string) $after Optional. Output after the date. Default empty.
    Required: No
    Padrão: (empty)
  • (bool) $display Optional. Whether to echo the date or return it. Default true.
    Required: No
    Padrão: true
Retorna:
  • (string|void) The date when `$display` is false, or an empty string when the post's
    date matches the previously output one. Nothing otherwise.
Definido em:
Codex:

Displays or retrieves the date of the post (once per date).

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 {@see 'the_date'}. Date string output can be filtered with {@see 'get_the_date'}.


Funções relacionadas: get_the_date, the_date_xml, the_time, the_id, the_terms

Fonte 

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 of the post, 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 ) {
		return $the_date;
	}

	echo $the_date;
}