Codex

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

User:Sithran/Marqueurs de Modele/the date

Page d'accueil du Codex en français - Télécharger WordPress en français
Les utilisateurs francophones se retrouvent sur le site WordPress-Francophone, notamment sur son forum d'entraide.

This article is marked as in need of editing. You can help Codex by editing it.

Description

Affiche ou retourne la date d'un article ou d'un ensemble d'articles si ceux-ci ont été publiés le même jour.

NOTE : Lorsque plusieurs articles puliés le même jour sont sur une page, the_date() n'affichera que la date du premier article (cf. premier exemple). Pour obtenir la date des articles publiés le même jour, vous devriez utiliser le marqueur de modèle the_time() avec un format de date spécifique.

Ce marqueur doit être utilisé au sein de la boucle.

Utilisation

 <?php the_date('format''avant''apres', echo); ?> 

Exemples

Utilisation par défaut

Affiche la date en utilisant les paramètres par défaut.

<p>Date de publication : <?php the_date(); ?></p>

Date de l'année, du mois, date dans le header

Affiche la date en utilisant le format YYYY-MM-DD à l'intérieur de balises de titres de niveau 2 (<h2>).

<?php the_date('Y-m-d', '<h2>', '</h2>'); ?>

NOTE : Vous pouvez également afficher la date en français de la façon suivante :

<?php the_date('d-m-Y', '<h2>', '</h2>'); ?>

Date dans le header utilisant la variable $ma_date

Retourne la date au format par défaut à l'intérieur du marqueur <h2> et l'assigne à la variable $ma_date. La valeur de la variable est affichée grâce à la commande PHP echo.

<?php $ma_date = the_date('', '', '', FALSE); echo $ma_date; ?>

Paramètres

format (string) Le format pour la date. la valeur par défaut est configurée dans vos options WordPress. Référez-vous au formatage de date et de temps.

before (string) Texte à placer avant la date. Aucune valeur par défaut.

after (string) Texte à placer après la date. Aucune valeur par défaut.

echo (boolean) Affiche la date (TRUE), ou la retourne pour être utilisée dans le script (FALSE). TRUE par défaut


En relation

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