Menu

format()

Mis à jour : 2025-03-27

La fonction format() est couramment utilisée dans les modèles pour formater des nombres, des dates et d'autres informations. C'est la première fonction à utiliser lorsque vous devez afficher des données dans le bon format. Le simple fait d'appliquer la fonction format() sans préciser de paramètres supplémentaires peut rapidement modifier le résultat.

La fonction format() respecte les paramètres régionaux et affiche les devises et les dates dans la langue du modèle. 

Devise

Appliquer la fonction format() à n'importe quel code de champ numérique pour l'afficher sous forme de devise. 

  • TaxCycle n'ajoute pas le signe numérique après la devise. Si vous souhaitez que le signe numérique figure dans votre modèle, ajoutez-le dans le texte en clair à côté du code du champ.
  • Si vous créez une formule en ajoutant ou en soustrayant des codes de champ, ajoutez la fonction format() autour de la formule complète pour afficher le résultat sous forme de devise.
  • Pour modifier les décimales, arrondissez à la valeur de la zone en utilisant « C0 » pour aucune décimale, « C » ou « C2 » pour deux décimales. Cela permet d'arrondir le nombre à la hausse ou à la baisse. Voir aussi les fonctions round() et abs().
Code Résultat
{{CurrentClient.T1.RefundBalanceOwing.BalanceOwing}} 1254,9
{{format(CurrentClient.T1.RefundBalanceOwing.BalanceOwing)}} 1 254,90
${{format(CurrentClient.T1.RefundBalanceOwing.BalanceOwing)}} 1 254,90 $
${{format(CurrentClient.T1.RefundBalanceOwing.BalanceOwing, "C0")}} 1 255 $
${{format(sum(CurrentClient.BillingWorksheet.Totals.TotalBeforeTaxes, CurrentSpouse.BillingWorksheet.Totals.TotalBeforeTaxes))}} 300,00 $

Dates

Par défaut, TaxCycle affiche la date et l'heure complètes pour tout champ de date. Appliquer la fonction format() et les paramètres associés pour ajuster l'affichage de la date.

  • Après le code de champ, ajoutez une virgule, puis la date du "2 janvier 2003" pour indiquer le format que vous préférez.
  • Vous pouvez également utiliser des masques de format de date traditionnels. Voir le tableau de la page Chaînes de format de date et d’heure personnalisées de Microsoft pour une liste des chaînes de format prises en charge.
Code Résultat
{{CurrentClient.Info.CommonData.FileByDate}} 2025-04-30 12:00:00 AM
{{format(CurrentClient.Info.CommonData.FileByDate, "January 2, 2003")}} Le 30 avril 2025
{{format(CurrentClient.Info.CommonData.FileByDate, "Jan 2, 2003")}} 30 avril 2025
{{format(CurrentClient.Info.CommonData.FileByDate, "2003-01-02")}} 30 avril 2025
{{format(CurrentClient.Info.CommonData.FileByDate, "03-01-02")}} 30 avril 2019
{{format(CurrentClient.Info.CommonData.FileByDate, "03-Jan-02")}} 19 avril 2030
{{format(CurrentClient.Info.CommonData.FileByDate, "yy-MMM-dd")}} 19 avril 2030
{{format(CurrentClient.Info.CommonData.FileByDate, "January 2, 2003 at 4:05")}} Le 30 avril 2025 à 1h22
{{format(CurrentClient.Info.CommonData.FileByDate, "January 2, 2003 at 16:05")}} Le 30 avril 2025 à 13h22
{{format(CurrentClient.Info.CommonData.FileByDate, "yyyy-dd-MMM")}} 30 avril 2025

Numéro de téléphone

Appliquez la fonction format() pour ajouter des parenthèses et un trait d'union à un champ de numéro de téléphone.

Code Résultat
{{CurrentClient.Info.Address.HomePhone}} 555555555
{{format(CurrentClient.Info.Address.HomePhone)}} (555) 555-5555

Code postal

Appliquez la fonction format() pour ajouter un espace dans un champ de code postal.

Code Résultat
{{CurrentClient.Info.Address.PostalCode}} H0H0H0
{{format(CurrentClient.Info.Address.PostalCode)}} H0H 0H0

Numéro d'assurance sociale / Numéro d'entreprise

Appliquez la fonction format() pour ajouter des espaces à un numéro d’assurance sociale. Ajoutez le paramètre « Field » à la fin d'un numéro d'entreprise pour afficher le type de compte. Cela peut être combiné avec la fonction mask().

Code Résultat
{{CurrentClient.Info.ID.SIN}} 111111118
{{format(CurrentClient.Info.ID.SIN)}} 111 111 118
{{CurrentClient.Info.ID.BusinessNumber}} 8510871480001
{{format(CurrentClient.Info.ID.BusinessNumberField)}} 851087148 RC0001

Texte 

Appliquez la fonction format() et le paramètre « text » pour afficher la version texte d'un champ déroulant. Voir aussi abbreviate() et Exemple : T3 Champ de type de fiducie dans les modèles.

Code Résultat
{{CurrentClient.Info.Residency.ProvinceDec31}} NewBrunswick
{{format(CurrentClient.Info.Residency.ProvinceDec31Field,"text")}} Nouveau-Brunswick
{{CurrentClient.Info.ID.Type}} TestamentarySpousal
{{format(CurrentClient.Info.ID.TypeField,"text")}} Testamentaire - époux ou conjoint de fait

Code

Appliquez la fonction format() et le paramètre « code » pour afficher le code du champ déroulant. Exemple : T3 Champ de type de fiducie dans les modèles

Code Résultat
{{CurrentClient.Info.ID.Type}} TestamentarySpousal
{{format(CurrentClient.Info.ID.TypeField,"code")}} 905