Formatage des dates à l’affichage des fiches ou dans l’export tabulaire

Les langages Java et Javascript proposent quelque soit la langue quatre styles différents pour formater une date :

• short : formatage avec uniquement des chiffres (en français : 24/12/2025)

• medium : formatage avec des formes abrégés (en français : 24 nov. 2025)

• long : formatage avec les noms complets (en français : 24 novembre 2025)

• full : formatage avec le nom du jour (en français : mercredi 24 décembre 2025)

Par défaut, le formatage appliqué est long. Il est possible de modifier ce formatage aussi bien pour les exports tabulaires quelque soit le format qu’à l’affichage.

Modification du format par défaut pour une donnée de type date

Le format désiré peut être indiqué pour un champ Propriété ou Information via les attributs de ces champs comme composant du formulaire (voir la commande CRP-30 Modification des attributs des composants). Deux attributs peuvent être utilisés :

• format:datestyle : peut prendre une des quatre valeurs indiquées plus haut (short, medium, long, full)

• format:datelabeltruncate : indique la date sous une forme plus globale que le seul jour ; peut prendre les valeurs suivantes :

  • month : indique le mois et l’année de la date

  • quarter : indique le trimestre et l’année de la date

  • halfyear : indique le semestre et l’année de la date

  • year : indique uniquement l’année

format:datestyle=long
format:datelabeltruncate=quarter

Avec ces attributs, le format s’appliquera aussi bien pour les gabarits d’affichage par défaut que pour l’export tabulaire par défaut.

Spécification du format dans un gabarit personnalisé

L’indication se fait dans le fichier extraction.xml du gabarit au niveau du champ en question en rajoutant les paramètres datestyle et datelabeltruncate avec les valeurs indiquées précédemment :

<prop name="date">
  <param name="datestyle">long</param>
  <param name="truncate">quarter</param>
</prop>

À noter que ces paramètres peuvent s’appliquer aux dates de création et de modification de la fiche :

<chrono>
  <param name="datestyle">short</param>
</chrono>

Spécification du format dans un export tabulaire

Les champs Propriété et Information de type de date ainsi que les champs de date de création et de dernière modification possèdent un gabarit de formatage {label} qui possède les paramètres datestyle et truncate aboutissant au même résultat que décrit précédemment, comme le montre l’exemple :

date
prop_date
{label,datestyle=long,truncate=quarter}

À noter que {label} propose un autre paramètre sep qui permet d’indiquer le séparateur si {label} affiche plusieurs langues.

Le paramètre datestyle est aussi disponible pour le gabarit {json} :

datejson
prop_date
{json, include="labels", datestyle=medium}
cast=json

Lorsque le paramètre cast est utilisé pour indiquer que la colonne est de type date, le gabarit de formatage {label} ne peut pas être utilisé. Il est cependant possible d’utiliser le paramètre datestyle en complément de cast. Dans le cas d’export « brut » (comme en CSV et en SQL), ce paramètre n’a pas d’effet, c’est le code ISO qui s’affiche. Ce paramètre a de l’effet pour des exports ODS et l’affichage du tableau en HTML dans l’interface d’administration.

L’exemple ci-dessous montre le formatage par défaut du champ de création de date, où les dates sont au format court :

date_creation
date_creation
{iso}
cast=date,datestyle=short

Enfin, pour rappel, il existe un autre gabarit de formatage {pattern} qui permet, lui, d’afficher une date dans le format de son choix suivant la syntaxe de Java décrite dans la classe java.time.format.DateTimeFormatterBuilder.

Dans l’exemple suivant, la date sera affichée sous la forme « 20251224 » :

datecompacte
prop_date
{pattern="yMMd"}