Utilisation des filtres de date SPIP

à partir de SPIP 1.8

Pour ceux qui ne connaissent pas PHP, voici décrites les nombreuses possibilités du filtre affdate.

Utilisation des filtres de date (SPIP1.8)

SPIP offre une grande variété de formats de date, enrichie dans la version 1.8 par le format PHP. Mais ceux d’entre vous, qui ne connaissent pas le format de date PHP, passent à côté d’une possibilité intéressante. C’est le but de cette modeste contrib.

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 « 1er juillet 2005 12:30:00 » et comme exemple alternatif « 7 juin 2004 12:30:00 » :

Nom du filtreCommentaireExemple
affdate affiche la date sous forme de texte 1er juillet 2005
affdate_jourcourt affiche le numéro du jour et le nom du mois (si la date est dans l’année en cours) 1er juillet
- idem - si la date n’est pas dans l’année en cours, on rajoute l’année 7 juin 2004
affdate_court affiche le numéro du jour et le nom du mois (si la date est dans l’année en cours) 1er juillet
- idem - si la date n’est pas dans l’année en cours , on affiche le nom du mois et l’année Juin 2004
affdate_mois_annee affiche seulement le mois et l’année juillet 2005
jour affiche le jour (en nombre) 1er
mois affiche le mois (en nombre) 07
annee affiche l’année 2005
heures affiche l’heure 12
minutes affiche les minutes 30
secondes affiche les secondes 00
nom_jour affiche le nom du jour (lundi, mardi...) vendredi
nom_mois affiche le nom du mois (janvier, février...) juillet
saison affiche la saison (hiver, été...) été
date_interface affiche il y a ... secondes, minutes, heures il y a 10 minutes

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'})]

-  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 « 0e 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) :

Caractère Description Exemple de valeur
a Ante meridiem et Post meridiem en minuscules am ou pm
A Ante meridiem et Post meridiem en majuscules AM ou PM
B Heure Internet Swatch 000 à 999
c Date au format ISO 8601 (ajouté en PHP 5) 2004-02-12T15:19:21+00:00
d Jour du mois, sur deux chiffres (avec un zéro initial) 01 à 31
D Jour de la semaine, en trois lettres (et en anglais) Mon à Sun [1]
F Mois, textuel, version longue ; en anglais, comme January ou December January à December [1]
g Heure, au format 12h, sans les zéros initiaux 1 à 12
G Heure, au format 24h, sans les zéros initiaux 0 à 23
h Heure, au format 12h, avec les zéros initiaux 01 à 12
H Heure, au format 24h, avec les zéros initiaux 00 à 23
i Minutes avec les zéros initiaux 00 à 59
I (i majuscule) L’heure d’été est activée ou pas 1 si oui, 0 sinon.
j Jour du mois sans les zéros initiaux 1 à 31
l (L minuscule) Jour de la semaine, textuel, version longue, en anglais Sunday à Saturday [1]
L Est ce que l’année est bissextile 1 si bissextile, 0 sinon.
m Mois au format numérique, avec zéros initiaux 01 à 12
M Mois, en trois lettres, en anglais Jan à Dec [1]
n Mois sans les zéros initiaux 1 à 12
O Différence d’heures avec l’heure de Greenwich (GMT), exprimée en heures Exemple : +0200
r Format de date RFC 822 Exemple : Thu, 21 Dec 2000 16:01:07 +0200 [1]
s Secondes, avec zéros initiaux 00 à 59
S Suffixe ordinal d’un nombre pour le jour du mois, en anglais, sur deux lettres st, nd, rd ou th. Fonctionne bien avec j [1]
t Nombre de jours dans le mois 28 à 31
T Fuseau horaire du serveur Exemples : EST, MDT ...
U Secondes depuis l’époque Unix (1er Janvier 1970, 0h00 00s GMT) Voir aussi time()
w Jour de la semaine au format numérique 0 (pour dimanche) à 6 (pour samedi)
W Numéro de semaine dans l’année ISO-8601, les semaines commencent le lundi (ajouté en PHP 4.1.0) Exemple : 42 (la 42e semaine de l’année)
Y Année, 4 chiffres Exemples : 1999 et 2003
y Année, 2 chiffres Exemples : 99 et 03
z Jour de l’année 0 à 366
Z Décalage horaire en secondes. Le décalage des zones à l’ouest de la zone UTC est négative, et à l’est, il est positif. -43200 à 43200

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

Notes

[1Malheureusement non traduit dans d’autres langues que l’anglais

Si vous avez besoin de créer vos propres filtres date, sachez que les dates SPIP sont au format datetime MySql « AAAA-MM-JJ HH:MM:SS », soit 2004-06-07 12:30:00 pour le 07/06/2004 12:30.

Discussion

7 discussions

  • 2
    Spipnaute

    Bonjour, quelqu’un pourrait me dire comment je peux faire pour supprimer la petite flèche et le signe d’interrogation qui s’affichent quand je pointe la souris sur la date de publication d’un article ? J’ai déjà supprimé [ title=« (#DATE|date_iso) » pour éliminer l’affichage de la date en format ISO qui apparaissait avec la petite flèche en question. Je veux juste conserver ma date ainsi : Lunes 21 de noviembre de 2011.

    Gracias mil.

    Répondre à ce message

  • 1

    Actuellement, février apparaît comme « f ?vrier ». Quel fichier faut-il modifier pour afficher le caractère accentué.
    voir : http://www.cyber-langues.asso.fr/spip.php?article42
    merci pour toute réponse

    • Le langage par défaut de spip, pour le site, est UTF-8. je ne comprends pas que les dates, et seulement elles, s’affichent avec le code Latin 1. Je n’ai pas rencontré ce problème avec les autres sites Spip que j’ai créés.

      Quelqu’un aurait-il une solution ? Ce site serait bilingue sans le savoir ?

    Répondre à ce message

  • 3

    Salut !

    Peut-on au lieu d’afficher la date de publication d’un article, afficher article publié il y a 20 minutes par exemple ? Ce serait sympa !

    • [(#DATE|date_relative)]

      Ca affichera les dates comme dans la gestion des forums (espace privé)

    • Super. C’est exactement ce que je recherchais ! Merci.

    • Je viens de me rendre compte du manque d’exactitude des résultats obtenus avec ce filtre. En effet jusqu’à 60 minutes, l’affichage est exact. Mais au delà de 60 minutes, on passe aussitôt à 2 heures. Ainsi, un article publié il y a 75 minutes n’affichera pas comme date ceci : il y a 1 heure15 minutes

      mais plutôt celà : il y a 2 heures

      Y at-il des filtres upplémentaires pour avoir un temps exact ?

    Répondre à ce message

  • Je cherche une boucle qui me permettrait de sortir un article créé le même jour, même mois que la date du jour.

    C’est pour cette page-là : http://www.belissor.net/

    Actuellement, je mets à jour à la main en changeant la date de l’article !!! Mais je voudrais (bien sûr !) que cela « se fasse tout seul » ;-)

    Je suis assez néophyte (voire très néophyte) en programmation mais devenue assez experte en « copier/coller/tester » ;-))

    Alors si quelqu’un avait quelque chose dans ses archives pour me venir en aide...

    Je cherche cela depuis deux ans et viens de passer le site en Spip 1 8 2g...

    Grand merci par avance à ceux qui pourront me donner une piste ;-)

    Répondre à ce message

  • 1

    Un petit filtre de date supplementaire :

    (#DATE

    Celui-ci test la date du serveur et affiche « Aujourd’hui », « Hier » ou un simple « affdate_court » sinon.

    <?php
    
    function dayoftheyear($date){
    	
    	$timestamp = strtotime($date);
    	$dayoftheyear = date('z',$timestamp);
    
    	return $dayoftheyear;
    }
    
    function friendlyday($date){
    
    	$articledayoftheyear = dayoftheyear($date);
    	$today = date('z');
    
    	if($today==$articledayoftheyear) {
        	$date = 'Aujourd\'hui';
    	} elseif(($today!=0 and $today==$articledayoftheyear+1)or($today==0 and $articledayoftheyear==365)) {
    		$date = 'Hier';
    	} else {
        	$date = affdate_court($date);
    	}
    
    	return $date;
    }
    
    function dayoftheyear($date){
    	
    	$timestamp = strtotime($date);
    	$dayoftheyear = date('z',$timestamp);
    
    	return $dayoftheyear;
    }
    
    ?>
    • marabbeh

      Pas mal comme filtre. Et ça montre comment transformer la date SPIP (MySql) en date PHP avec strtotime().

      Mais la fonction dayoftheyear() est déclarée 2 fois. Il faut supprimer l’une des 2.

    Répondre à ce message

  • 2

    Je voudrai comparer la date du jour avec la date d’un article :

    <?
       $date_art = "[(#DATE|affdate{'d-m-Y'})]";
       echo 'Date article : '.$date_art.'<br>';
       $date_jour = date("d-m-Y");
       echo 'Date du jour :'.$date_jour.'<br>';
       ?>

    ça ne marche pas car SPIP affiche tjs « 12 mai 2005 » et non « 12-05-2005 ».

    Est-ce qqn a une réponse ?

    • Si tu connais un peu le php, tu peux creer tes filtres de DATE assez facilement. J’ai poste un exemple juste apres ton message.

      enregistre ta fonction sur mes_fonctions.php3 a la racine de ton site Spip.

    • marabbeh
      1. Il faudrait mettre ton code entre balises <code>, sinon on ne sait pas trop ce que tu as voulu faire
      2. Ensuite :
      • Soit tu fais tout en PHP
      • Soit tu crées un filtre ce qui est préférable

    Répondre à ce message

  • 7
    Chrishoo

    Bonjour,

    j’ai une question concernant les filtres dates. Je cherche à afficher la date au format : « 1er janvier à 12h44 ». J’utilise aujourd’hui (#DATE à (#DATE(#DATE, ce qui me donne « 1er janvier 2005 à 12h44 ». Quelqu’un a-t-il une idée sur la façon de procéder ?

    • as-tu essayé [(#DATE|jour)] [(#DATE|mois)]  ?

    • Je dirais plutôt :

       [(#DATE|jour)] [(#DATE|nom_mois)]
    • Oui j’ai essayé tout ça mais ça me donne 1 janvier au lieu de 1er janvier :(

    • Il te reste qu’à te faire ton propre filtre pour le jour :

      function jour_perso($date) {
         return str_replace("1", "1er", date("j", $date));
      }

      et faire [(#DATE|jour_perso)] [(#DATE|nom_mois)]...

    • Erreur de ma part, c’est plutôt :

      function jour_perso($date) {
          return preg_replace("/^1$/", "1er", date("j", $date));
      }
    • Désolé, je ne suis pas réveillé ce matin... $date n’est pas une date PHP mais MySql. Donc ça ne peut pas marcher ces tentatives de filtre ! Ma suggestion (je ne peux laisser des conneries, mais il y a peut-être mieux) :

      function jour_perso($date) {
          if (preg_match("/^(2\d{3})-(\d\d)-(\d\d).+$/", $date, $elts)) {
              return ($elts[3] == "01") ? "1er" : (int) $elts[3];
          }
          else return null;
      }
    • la réponse est maintenant dans le premier tableau de l’article (depuis qu’il a été mis à jour)
      D.

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom