Fonction TOKENSUB

Cette fonction sert à renvoyer une valeur formatée contenant des éléments prédéfinis.

Syntaxe

TOKENSUB("Format", Arguments)

Où « Format » définit le contenu de la sortie et précise les arguments nécessaires.

Les spécificateurs d'argument se construisent sous la forme %[index de l'argument]spécificateur. L'indice d'argument permet d'accéder à l'argument de la liste qui suit la chaîne formatée. Si aucun numéro d'index d'argument n'est spécifié, la fonction lit les arguments dans l'ordre. Pour plus d'informations à ce sujet, veuillez vous reporter à l'exemple 1.

Le spécificateur définit le type et l'interprétation de la valeur de l'argument. La valeur du spécificateur peut être l'une des suivantes.

En suivant cette structure jusqu'au spécificateur d'argument, %3d identifiera la troisième entrée de la liste d'arguments et tentera de renvoyer la valeur sous la forme d'une chaîne de caractères au format de date abrégé.

La liste des arguments respecte ce format et les éléments sont séparés par des virgules. Les arguments peuvent être une référence de cellule, une fonction telle que SYSDATE(), ou une chaîne de caractères ou une valeur ordinaire.

Exemple 1

TOKENSUB("Ceci est %s généré le %d","texte d'exemple", SYSDATE())

Retour Ceci est un exemple de texte généré le 04/10/2008

Comme aucun numéro d'index n'est spécifié pour les arguments, ceux-ci doivent être énumérés dans l'ordre où ils doivent apparaître dans la chaîne.

Exemple 2

TOKENSUB(C1, C2, C3) où

• La cellule C1 contient la valeur « %s %d <%2D> »

• La cellule C2 contient la chaîne de caractères « La date du jour est »

• La cellule C3 contient la valeur de date julienne « 39487 »

Résultats Nous sommes le 10/04/2008 <10 avril 2008>

Les références de cellule seront remplacées, ce qui donnera l'équation suivante : TOKENSUB("%s %2d <%2D>", "La date du jour est", 39487). Cette fonction affiche le premier argument sous forme de chaîne de caractères, affiche le deuxième argument au format de date court, puis au format de date long, en convertissant la valeur de la date julienne en une date lisible.

• Les spécificateurs non pris en charge apparaîtront dans la chaîne de caractères obtenue.

  Par exemple, TOKENSUB("Ceci est un %B", "test") renverra la chaîne Ceci est un B.

• Les zéros non significatifs sont supprimés dans la chaîne obtenue.

  Par exemple, TOKENSUB("J'ai %n dollars", "65,00") renverra la chaîne J'ai 65 dollars.

• La fonction TOKENSUB peut actuellement traiter une liste de 20 arguments. Si la liste comporte plus de 20 éléments, le 21e argument et tous les suivants seront ignorés.

Sujets connexes

• Fonctions de texte