String()

Référence des fonctions Convertit des données en une chaîne mise en forme selon un masque de format spécifié. Vous pouvez convertir et mettre en forme des données de type date, DateTime, numérique et heure.

String ( data {, format } )

Argument	Description
data	Les données que vous souhaitez obtenir sous forme de chaîne avec la mise en forme spécifiée. Les données peuvent être de type date, DateTime, numérique, heure ou chaîne.
format (facultatif)	Une chaîne contenant les masques d’affichage à utiliser pour mettre en forme les données. Les masques contiennent des informations de mise en forme propres au type de données de data. Si data est de type chaîne, format est obligatoire. La chaîne de format peut comporter plusieurs masques, selon le type de données de data. Les masques sont séparés par un point-virgule. Consultez la section Utilisation pour plus de détails sur chaque type de données.

Type de données : String Renvoie les données dans le format spécifié en cas de réussite, et la chaîne vide (‘’) si le type de données de data ne correspond pas au type de masque d’affichage spécifié ou si format n’est pas un masque valide.

Format

Pour les données de type date, DateTime, numérique et heure, le format par défaut du système est utilisé pour la chaîne renvoyée si vous ne spécifiez pas de format. Pour les données numériques, le format par défaut est le format [General]. Pour les données de type chaîne, un masque de format d’affichage est obligatoire. (Sinon, la fonction n’aurait rien à faire.) Le format peut comporter un ou plusieurs masques :

Les formats des données de type date, DateTime, chaîne et heure peuvent comporter un ou deux masques. Le premier masque est le format des données ; le second est le format d’une valeur nulle. Les formats des données numériques peuvent comporter jusqu’à quatre masques. Un format à masque unique gère à la fois les données positives et négatives. S’il y a des masques supplémentaires, le premier masque s’applique aux valeurs positives, et les masques supplémentaires aux valeurs négatives, nulles (zéro) et null.

Un format peut inclure des spécifications de couleur. Si le format d’affichage ne correspond pas au type de données, l’application du masque produit des résultats imprévisibles.

Exemple 1

String(Date('2005-01-31'), 'mmm dd, yyyy)

Renvoie : Jan 31, 2005

Exemple 2

String(DateTime('2005-01-31 06:08:00.63534'), 'mmm dd, yyyy, h:m')

Renvoie : Jan 31, 2005, 6:8

Exemple 3

String(nbr, '0000;(000);xxxx;empty')

Renvoie : 0123 si nbr vaut 123 (123) si nbr vaut -123 xxxx si nbr vaut 0 empty si nbr est null

Exemple 4

String('ABC', '@-@-@')

Renvoie : A-B-C

Exemple 5

String(ABC, '@*@')

Renvoie : A*B

Exemple 6

String('ABC', '@@@')

Renvoie : ABC

Exemple 7

String('ABC”, ' ')

Renvoie : un espace

Exemple 8

String(Time('06:08:02.9986'),'h:m')

Renvoie : 6:8

Exemple 9

String(Time('20:06:04'), 'hh:mm:ss am/pm')

Renvoie : 08:06:04 pm

Exemple 10

String(Time('08:06:04'), 'h:mm:ss am/pm')

Renvoie : 8:06:04 am:

Exemple 11

String(Time('6:11:25.300000', 'h:mm:ss.ffffff')

Renvoie : 6:11:25.300000