Guide des fonctions de Format AMPscript

Introduction

AMPscript est l'ultime code pour la personnalisation de contenu et dynamique dans Salesforce Marketing Cloud (SFMC). Ce guide offre une explication approfondie des principales fonctions de formatage—Format, FormatCurrency et FormatNumber. Ces fonctions permettent un contrôle précis de l'affichage des chaînes, des nombres, des dates et des devises dans vos e-mails et pages d'atterrissage.

1. Fonction Format

La fonction Format formate une chaîne dans un modèle spécifique en fonction du type et de la langue. Elle prend en charge divers modèles, notamment les formats numériques et date-heure standards.

Syntaxe

Format(1, 2, 3, 4)

1 : La chaîne à formater (par ex. date ou nombre).
2 : Le modèle de format (par ex. `D`, `C`, `MMM`).
3 : (Optionnel) Type de données (`Date` ou `Number`).
4 : (Optionnel) Code de langue ISO (par ex. `en-US`, `fr-FR`).

Exemples

Formatage des Dates


%%[
    SET @dateString = "2017-09-15T06:07:08.1230000-06:00"
    SET @long = Format(@dateString, "D", "Date")
    SET @short = Format(@dateString, "d", "Date")
    SET @rfc = Format(@dateString, "R", "Date")
    SET @universal = Format(@dateString, "U", "Date")
]%%

Sortie :

Date Longue (D) : Vendredi 15 septembre 2017
Date Courte (d) : 15/09/2017
RFC1123 (R) : Ven, 15 Sep 2017 06:07:08 GMT
Heure Universelle (U) : Vendredi 15 septembre 2017 12:07:08 PM

Formatage des Nombres


%%[
    SET @num = -1.8967
    SET @currency = Format(@num, "C", "Number")
    SET @percent = Format(@num, "P", "Number")
    SET @custom = Format(@num, "#,##0.00", "Number")
]%%

Sortie :

Devise (C) : (1,90 €)
Pourcentage (P) : -189,67%
Personnalisé (#,##0.00) : -1 897,00

2. Fonction FormatCurrency

La fonction FormatCurrency formate une chaîne en devise selon la langue spécifiée. Elle permet de définir une précision décimale et d’éventuellement remplacer le symbole de devise par défaut.

Syntaxe

FormatCurrency(1, 2, 3, 4)

1 : La chaîne de devise à formater.
2 : Le code de langue ISO pour la devise (par ex. `en-US`, `fr-FR`).
3 : (Optionnel) Nombre de décimales pour la sortie.
4 : (Optionnel) Symbole de devise pour remplacer celui par défaut de la langue.

Exemples


%%[
    SET @num = "123.45678"
    SET @locale = "fr-FR"
    SET @currency = FormatCurrency(@num, @locale)
]%%

Sortie :

Nombre : 123.45678
Langue : fr-FR
Devise Formatée : 123,46 €

3. Fonction FormatNumber

La fonction FormatNumber formate une chaîne en nombre selon divers modèles, y compris les formats numériques standards, scientifiques et personnalisés. Par défaut, cette fonction arrondit à deux décimales.

Syntaxe

FormatNumber(1, 2, 3)

1 : La chaîne numérique à formater.
2 : Le modèle de format (par ex. `C`, `D`, `N`).
3 : (Optionnel) Code de langue ISO pour des modèles propres à une langue.

Exemples


%%[
    SET @num = "123"
    SET @currency = FormatNumber(@num, "C")
    SET @exponential = FormatNumber(@num, "E")
    SET @percent = FormatNumber(@num, "P")
    SET @hexadecimal = FormatNumber(@num, "X")
]%%

Sortie :

Devise (C) : 123,00 €
Exponentiel (E) : 1,230000E+002
Pourcentage (P) : 12 300,00%
Hexadécimal (X) : 7B