> For the complete documentation index, see [llms.txt](https://ksaar.gitbook.io/ksaar-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ksaar.gitbook.io/ksaar-documentation/les-elements/les-formules/fonctions-de-formatage.md).
# Fonctions de formatage
{% hint style="success" %}
Les fonctions sur les formules sont disponibles dans chacune des sous-pages dédiées :
* [Opérateurs](/ksaar-documentation/les-elements/les-formules/operateurs.md)
* [Fonctions de texte](/ksaar-documentation/les-elements/les-formules/fonctions-de-texte.md)
* [Fonctions mathématiques](/ksaar-documentation/les-elements/les-formules/fonctions-mathematiques.md)
* [Fonctions de date](/ksaar-documentation/les-elements/les-formules/fonctions-de-date.md)
* [Fonctions de formatage](/ksaar-documentation/les-elements/les-formules/fonctions-de-formatage.md)
* [Fonctions de liste](/ksaar-documentation/les-elements/les-formules/fonctions-de-liste.md)
* [Fonctions sur des champs Ksaar](/ksaar-documentation/les-elements/les-formules/fonctions-sur-des-champs-ksaar.md)
* [Fonctions de Logique et autres](/ksaar-documentation/les-elements/les-formules/fonctions-de-logique-et-autres.md)
Des exemples de formules prêtes à l'emploi se trouvent ici : [Bibliothèque de formules classiques](/ksaar-documentation/les-elements/les-formules/bibliotheque-de-formules-classiques.md)
{% endhint %}
FORMAT_CURRENCY
#### Résumé
La fonction `FORMAT_CURRENCY` formate un nombre en tant que devise en utilisant les paramètres de région et de devise fournis.
Le résultat est sous forme de texte.
#### Syntaxe
`FORMAT_CURRENCY(nombre, région, devise)`
#### Exemple
* `FORMAT_CURRENCY(1000, "fr-FR", "EUR")` → `1 000,00 €`
* `FORMAT_CURRENCY(1000, "en-US", "USD")` → `$1,000.00`
FORMAT_DATE
#### Résumé
La fonction `FORMAT_DATE` formate une date selon le format spécifié.
Vous pouvez mettre le format pour une région particulière, puis ajouter des paramètres séparés par des virgules, dont vous pouvez trouver la documentation [ici](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat).
Les paramètres principaux sont `dateStyle` , qui définit le format de la date, et `timeStyle`, qui définit le format de l'heure, qui peuvent prendre `short`, `medium`, `long` ou `full` comme valeur.
Vous pouvez aussi mettre un format encore plus personnalisé en ne précisant pas la région et en plaçant chaque élément de la date où vous le souhaitez comme par exemple `"DD-MM-YYYY HH [heures et] mm [minutes]"`.\
Les crochets sont des caractères d'échappement, ils permettent de préciser le texte qui doit être affiché tel quel et qui ne doit pas être interprétés comme du formatage.\
Vous pouvez retrouver la liste des formats possibles [ici](https://day.js.org/docs/en/display/format#list-of-all-available-formats).
Le résultat est sous forme de texte.
#### Syntaxe
`FORMAT_DATE(date, format)`
#### Exemple
Pour : {Date et Heures} = 20/10/2023 15:30:00
* `FORMAT_DATE({Date et Heures}, "DD/MM/YYYY")` → `20/10/2023`
* `FORMAT_DATE({Date et Heures}, "DD/MM/YY h:mm A")` → `20/10/23 3:30 PM`
* `FORMAT_DATE({Date et Heures}, "dddd DD MMMM YYYY, HH:mm")` → `vendredi 20 octobre 2023, 15:30`
* `FORMAT_DATE({Date et Heures}, "DD-MM-YYYY HH [heures et] mm [minutes]")` → `20-10-2023 15 heures et 30 minutes`
* `FORMAT_DATE({Date et Heures}, "fr-FR, dateStyle=full")` -> `vendredi 20 octobre 2023`
* `FORMAT_DATE({Date et Heures}, "en-US, timeStyle=short")` -> `3:30 PM`
* `FORMAT_DATE({Date et Heures}, "fr-FR, dateStyle=medium, timeStyle=medium")` -> `20 oct. 2023, 15:30:00`
* `FORMAT_DATE(DATE(2023,1,1),"en-US, dateStyle=long, timeStyle=full, timeZone=Europe/London")` -> `December 31, 2022 at 11:00:00 PM Greenwich Mean Time`
TO_NUMBER
#### Résumé
La fonction `TO_NUMBER` convertit une chaîne de caractères en nombre.
#### Syntaxe
`TO_NUMBER(texte)`
#### Exemple
* `TO_NUMBER("123.45")` → `123.45`
TO_TEXT
#### Résumé
La fonction `TO_TEXT` convertit une variable en texte.
#### Syntaxe
`TO_TEXT(any)`
#### Exemple
* `TO_TEXT(12)` → `"12"`
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://ksaar.gitbook.io/ksaar-documentation/les-elements/les-formules/fonctions-de-formatage.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.