Filtre durée

Un filtre pour calculer la période entre deux dates ou l’âge d’un élément

Utilisation du filtre

Ajouter le code du filtre dans votre fichier mes_fonctions.php

filtre durée
version 0.25

Vous pouvez ensuite utiliser le filtre selon la syntaxe

[(#DATE_DEBUT|duree{#DATE_FIN})]

Il est possible d’ajouter un 2e paramètre pour préciser le formatage de durée

[(#DATE_DEBUT|duree{#DATE_FIN,horaire})]

Différents formatages de durée proposés

Voici les différents formatages proposés

ValeurDéfinitionExemple
court on arrondit à la durée la plus proche (formatage par défaut) 4 semaines
etendu affichage complet en lettres 4 semaines 3 jours 23 heures 2 minutes
horaire affichage heures et minutes 2h04
minute affichage minutes cumulées 124
iso8601 affichage selon la norme iso 8601 P18Y9W4DT11H9M8S
ical même chose que iso8601 P18Y9W4DT11H9M8S

Pour faciliter l’internationalisation, il est aussi possible de sortir un élément inviduellement :

  • Y : année
  • W : semaine
  • D : jour
  • H : heure
  • M : minute
  • S : seconde

Exemple d’utilisation
On veut « un format à l’anglaise » qui affiche la durée de la façon suivante : 4’46’’

[(#DATE_DEBUT|duree{#DATE_FIN,M})']][(#DATE_DEBUT|duree{#DATE_FIN,S})'']

Références techniques

Exemple d’utilisation avec le plugin Agenda

Je programme un site de cinéma qui utilise le plugin Agenda pour saisir les séances. Pour chaque séance, le rédacteur saisit une date de début et fin

Voici ma boucle pour afficher toutes les séance d’un film avec l’heure de début de film et la durée

<B_seance><table>
<tr>
  <td>Jour</td>  
  <td>Séance</td>
  <td>Titre du film</td>
  <td>Durée</td>      
</tr>
<BOUCLE_seance(EVENEMENTS){id_article}{par date_debut}>
<tr>
  <td>[(#DATE_DEBUT|affdate_jourcourt)]</td>
  <td>[(#DATE_DEBUT|heures)h][(#DATE_DEBUT|minutes)]</td>
  <td><a href="#URL_ARTICLE">#TITRE</a></td>
  <td>[(#DATE_DEBUT|duree{#DATE_FIN,minute}) min]</td>      
</tr>
</BOUCLE_seance>
</table></B_seance>

Explications
On utilise une boucle EVENEMENTS pour récupérer les séances liées à l’article grâce au critère {id_article} par ordre chronologique grâce au critère {par date_debut}

<BOUCLE_seance(EVENEMENTS){id_article}{par date_debut}>

L’affichage des résultats se fait dans un tableau
Pour afficher la durée on utilise la filtre duree avec l’option d’affichage minute

[(#DATE_DEBUT|duree{#DATE_FIN,minute}) min]

Utiliser le filtre durée pour calculer l’âge d’un élément

Pour calculer l’âge d’un élément, il faut utiliser comme date de fin, la date actuelle.

[(#DATE|duree{#ENV{date}})]

Développement

Le code du filtre est disponible sur la zone à l’adresse http://zone.spip.org/trac/spip-zone...

Voir aussi

Le filtre date_relative peut aussi très pratique.

Discussion

2 discussions

  • Bonsoir,
    En réponse à
    https://discuter.spip.net/t/filtre-duree-attitude-differente-sur-2-sites/170843
    j’ai créé un nouvel filtre plus court pour calculer les durées que je vous partage
    juillet 2023

    // Définir le fuseau horaire par défaut à utiliser.
    # date_default_timezone_set('UTC');
    /**
     * 
     * Calculer les durées écoulées entre deux dates au format Y-m-d H:i:s
     * @param date $date_debut
     * @param date|string $date_fin
     * Sans le parametre $date_fin == today
     *
     * @param string $type_affichage
     * par defaut court, sinon affichage des durées année/mois/jours/heures …
     *
     * @example dans un squelette
     	#SET{date_debut_brut_sql,2006-05-03 18:30:00}
     	#SET{date_fin_brut_sql,2022-06-23 17:29:56}
    
     	<h3>Durées écoulées</h3>
     	Entre son arrivée le [(#GET{date_debut_brut_sql})] et aujourd'hui<br>
     	<span style="color:red">[(#GET{date_debut_brut_sql}|duree)]</span><br>
     	Ou bien avec la date de fin [(#GET{date_fin_brut_sql})] <br>
     	<span style="color:green">[(#GET{date_debut_brut_sql}|duree{#GET{date_fin_brut_sql}})]</span>
     *
     * @return string
     * par defaut le nombre de jours
     * sinon année/mois/jours/heures
     *
    **/
    function duree($date_debut,$date_fin = '',$type_affichage = 'court') {
    	
    	if(!$date_fin) {
    		$date_fin = date("Y-m-d H:i:s"); 
    	}
    	
    	$origin = new DateTimeImmutable($date_debut);
    	$target = new DateTimeImmutable($date_fin);
    	$interval = $origin->diff($target);
    	
    	if($type_affichage == 'court' ) {
    		$duree_affichage = $interval->format('%R%a jours'); //nb_jours
    	} else {
    		$duree_affichage = $interval->format("%Y". ' ans '. "%m".' mois '."%H".'h'."%I" .'min'.":%S (Total de jours: %a)");
    	}
    	
    	return $duree_affichage;
    
    }

    Répondre à ce message

  • 1
    Frédéric

    Je pense qu’il y a un bug sur la fonction minute : le multiples pour diff_weeks devrait être 7 et non 52. Version corrigée :

          case "minute":    $str = $diff_minutes+($diff_hours*60)+($diff_days*60*24)+($diff_weeks*60*24*7)+($diff_year*60*24*365);                                    
                            break;

    Mais cela ne donne quand même pas la valeur tout à fait exacte, il doit y avoir d’autres bugs en amont.

    Plus simplement, le nombre de minutes sera donné par

          case "minute":    $str = floor(($d_fin - $d_debut)/60);                                    
                            break;

    Cette dernière version a l’avantage de donner une valeur exacte même les années bissextiles.

    • Disons même :

      case "minute":
         $str = floor($diff_seconds / 60);
         break;

    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