Utilisation des filtres de date SPIP

Filtres date SPIP

Commençons par un récapitulatif des filtres date disponibles, jusqu’à la version 1.8.1 (voir http://www.spip.net/fr_article901.html). On prendra comme exemple de date le « 1^er juillet 2005 12:30:00 » et comme exemple alternatif « 7 juin 2004 12:30:00 » :

Présentation du filtre affdate

La nouveauté est que maintenant le filtre affdate peut recevoir une chaîne de caractères comme argument. Cette chaîne de caractères utilise les codes date de la fonction PHP date(), que vous pouvez voir en fin de cette page.

[(#DATE|affdate{"***format PHP***"})]

où « ***format PHP*** » est un mélange de texte et de codes date PHP, tel que :

-  les codes date sont interprétés par le filtre
-  les autres caractères servent de « remplissage » et sont rendus tels quels.

Exemples

Prenons le même exemple 7 juin 2004 12:30:00 :

Afficher « 07/06/2004 »

[(#DATE|affdate{'d/m/Y'})]

où

-  d indique le jour sur 2 chiffres, m est le mois sur 2 chiffres, et Y l’année sur 4 chiffres,
-  / servira de « remplissage », car il n’est pas dans le tableau des codes de date.

Afficher « Ce 7/6 à 12:30 »

[(#DATE|affdate{"Ce j/n à H:i"})]

-  j est le jour sans « 0 » devant, n est le numéro de mois sans « 0 » devant, H est l’heure sur 24h et i représente les minutes sur 2 chiffres.
-  ni /, ni C, ni e, ni l’espace ne sont dans le tableau : ils seront rendus tels quels.

Mais si vous faîtes :

[(#DATE|affdate{"Le j/n à H:i"})]

vous aurez « 0^e 16 à 12:30 », car « L » a une signification dans le format date PHP. En règle générale il vaut mieux réserver la ponctuation, les caractères spéciaux et les lettres accentuées au « remplissage », PHP étant susceptible d’étendre son format date à d’autres caractères non accentués.

Afficher « 24° semaine, 158° jour de l’année 2004 »

[(#DATE|affdate{'W'})]° semaine, [(#DATE|affdate{'z'})]° jour de l'année [(#DATE|affdate{'Y'})]

-  W indique le numéro de semaine, z le numéro de jour dans l’année et Y toujours l’année sur 4 chiffres,

Afficher la date ISO 8601

Utile, par exemple, pour afficher les dates dans le sitemap de Google (nécessite PHP5) :

[(#DATE|affdate{'c'})]

Affiche : « 2004-06-07T12:30:00+02:00 ». Mais dans le cas du sitemap Google, la date YYYY-MM-JJ suffit (ne nécessite pas PHP5) :

[(#DATE|affdate{'Y-m-d'})]

Critère pour comparer une date sans les heures et secondes

Si votre champ date contient les heures et les secondes, et que vous voulez faire une boucle avec un critère qui ne compare que le jour, relativement à une date de référence, et sans tenir compte des heures, minutes et secondes, le critère de votre boucle peut être :
{annee=#GET{dateref}|annee}  {mois=#GET{dateref}|mois}  {jour=#GET{dateref}|jour}
mais plus simplement il peut aussi être :
{date LIKE #GET{dateref}|affdate{'Y-m-d'}|concat{%}}

Tableau des codes de date PHP

Voici les codes de date PHP (extraits du manuel PHP) :

Voilà les principes et les codes date. A vous de jouer !