Le formatage des données est un aspect crucial de la génération de documents, vous permettant de présenter les informations selon vos besoins spécifiques. Qu’il s’agisse de dates, de nombres ou d’autres types de données, avoir le contrôle sur leur présentation ajoute une touche de précision et de professionnalisme à vos documents.
Pour utiliser les filtres de formatage de données, vous devez utiliser la syntaxe avancée. Sans l’activer, les filtres de formatage ne seront pas appliqués lors de la génération du document.
1. Formater les Dates 2. Formater les Nombres 3. Convertir en Majuscules 4. Convertir en Minuscules 5. Supprimer les Espaces
L’un des filtres de formatage les plus puissants est le formateur de date. Il vous permet de contrôler l’apparence des dates dans vos documents générés. Voici la syntaxe à utiliser dans votre modèle :
[source_date | date:'date_format']
La valeur source_date doit être au format ISO 8601 (une norme internationale pour représenter les dates et heures). Par exemple, une date spécifiée au format yyyy-MM-dd fonctionnera parfaitement avec le formateur de date.
Le date_format représente le format de sortie souhaité pour la date, et est basé sur le Unicode Technical Standard
Supposons que vous ayez une date dans votre jeu de données comme ceci :
[{
"source_date": "2023-06-15"
}]
En utilisant le formateur de date dans votre modèle :
Date: [source_date | date:'dd-MM-yyyy']
Le résultat sera :
Date: 15-06-2023
Voici quelques autres exemples d’options de formatage :
| Format | Résultat | Description |
|---|---|---|
| dd-MM-yyyy | 15-06-2025 | Format de date basique |
| dd/MM/yyyy | 15/06/2025 | Format de date basique avec slashs |
| yyyy-MM-dd HH:mm | 2025-06-15 00:00 | Format avec heures et minutes |
| yyyy-MM-dd HH:mm:ss | 2025-06-15 00:00:00 | Format avec heures, minutes et secondes |
| eeee, yyyy-MM-dd | Friday, 2025-06-15 | Format personnalisé avec jour de la semaine |
| MMM yyyy | Jun 2025 | Mois abrégé et année |
| MMMM d, yyyy | June 15, 2025 | Nom complet du mois avec jour et année |
Un autre filtre de formatage utile est le formateur de nombre. Il vous permet de contrôler l’apparence des nombres dans vos documents générés. Voici la syntaxe à utiliser dans votre modèle :
[source_number | number:'digits_format':'locale']
source_number peut être un nombre ou une chaîne représentant un nombre.
digits_format spécifie la représentation décimale de la valeur dans le format suivant : {minIntegerDigits}.{minFractionDigits}-{maxFractionDigits}. {minIntegerDigits} est optionnel, il est donc possible de ne spécifier que {minFractionDigits}-{maxFractionDigits}, où : minIntegerDigits est le nombre minimum de chiffres entiers avant la virgule décimale. Une valeur comportant moins de chiffres entiers que ce nombre sera complétée à gauche par des zéros (jusqu’à la longueur spécifiée) lors du formatage. Les valeurs possibles vont de 1 à 21. La valeur par défaut est 1.minFractionDigits est le nombre minimum de chiffres après la virgule décimale. Les valeurs possibles vont de 0 à 20. La valeur par défaut est 0.maxFractionDigits est le nombre maximum de chiffres après la virgule décimale. Les valeurs possibles vont de 0 à 20. La valeur par défaut est 3.locale formatera la valeur source selon les règles de la locale. Il s’agit d’un paramètre de chaîne optionnel avec une balise de langue BCP 47. La valeur par défaut est en-US.Supposons que vous ayez une donnée dans votre jeu de données comme ceci :
[{
"source_number": 3.14159265359
}]
En utilisant le formateur de nombre dans votre modèle :
兀 with 3 decimals: [source_number | number]
兀 with 2 decimals: [source_number | number:'1.0-2']
Le résultat sera :
兀 with 3 decimals: 3.142
兀 with 2 decimals: 3.14
Comme vous pouvez le voir dans l’exemple “Pi with 3 decimals” ci-dessus, si aucun paramètre supplémentaire n’est fourni au filtre number, la valeur est formatée en utilisant le digits_format par défaut, qui est 1.0-3, et la locale par défaut, qui est en-US.
Voici quelques autres exemples d’options de formatage :
| Format | Résultat | Description |
|---|---|---|
| 2.0-2 | 03.14 | Au moins 2 chiffres avant la virgule et jusqu’à 2 chiffres après la virgule. Des zéros sont ajoutés au début si nécessaire. |
| 2-2 | 3.14 | Aucune exigence sur le nombre de chiffres avant la virgule, mais exactement 2 chiffres après la virgule. |
| 4.0-2:en-US | 0,003.14 | Au moins 4 chiffres avant la virgule, jusqu’à 2 chiffres après la virgule, formaté selon la locale en-US, avec une virgule comme séparateur de milliers et un point comme séparateur décimal. |
| 4.2-2:fr-FR | 0 003,14 | Au moins 4 chiffres avant la virgule, exactement 2 chiffres après la virgule, formaté selon la locale fr-FR, avec un espace comme séparateur de milliers et une virgule comme séparateur décimal. |
| 4.2-2:fr | 0 003,14 | Au moins 4 chiffres avant la virgule, exactement 2 chiffres après la virgule, formaté selon le style français, avec un espace comme séparateur de milliers et une virgule comme séparateur décimal |
| 2 | 3.14159265359 | Format incorrect, la valeur d’origine est affichée telle quelle, sans formatage numérique spécifique appliqué. |
Pour convertir un texte en majuscules, utilisez la syntaxe suivante dans votre modèle :
[source_text | upper]
Pour le jeu de données suivant :
[{
"source_text": "Hello"
}]
Le résultat sera :
HELLO
Pour convertir un texte en minuscules, utilisez la syntaxe suivante dans votre modèle :
[source_text | lower]
Pour le jeu de données suivant :
[{
"source_text": "Hello"
}]
Le résultat sera :
hello
Les espaces incluent les caractères espace, tabulation, espace insécable et les caractères de fin de ligne. Pour supprimer les espaces situés aux deux extrémités d’une chaîne, utilisez la syntaxe suivante dans votre modèle :
[source_text | trim]
Pour le jeu de données suivant :
[{
"source_text": " Hello "
}]
Le résultat sera :
Hello