SUBSTR() : extraire une partie d'un texte (sous-chaîne)

La fonction SUBSTR() extrait un nombre de caractères défini dans une chaîne de caractères, à partir d'une position que vous indiquez, et renvoie une chaîne de texte. Elle est pratique pour isoler un préfixe, un code ou une portion fixe d'un texte, par exemple pour créer une souche de numérotation automatique pour vos devis, factures ou avoirs.

Le format du type de sortie du résultat se configure dans les options du champ de sortie de l'éditeur de formule : voir Colonne de formule.

Syntaxe

SUBSTR(texte_original, position_départ, nombre_de_caractères)

Appel des paramètres dans TimeTonic : $nom_du_champ pour un champ (lien, colonne de table liée, nombre, sélection, formule, texte) ; "texte libre" entre guillemets ; pas de guillemets pour les nombres.

Paramètres

# Paramètre Description

1 texte_original La chaîne de caractères source (colonne ou texte) dans laquelle extraire les caractères.

2 position_départ La position du premier caractère à extraire. Le comptage commence à 0 : le premier caractère porte l'indice 0.

3 nombre_de_caractères Le nombre de caractères à extraire à partir de la position de départ.

Exemples

Extraire les premiers caractères d'un texte

« TT-2026-01 » devient « TT ».

SUBSTR("TT-2026-01", 0, 2)

Créer une souche de numérotation à partir d'un champ

Pour un champ $Type contenant par exemple « Facture », « Devis » ou « Avoir » : « Facture » devient « Fac ».

SUBSTR($Type, 0, 3)

La position de départ commence à 0 : pour extraire à partir du premier caractère, indiquez 0.

Cas d'usage métier : SUBSTR() est particulièrement utile pour isoler une portion fixe d'un texte : préfixe de référence, code produit, ou souche de numérotation automatique de devis, factures ou avoirs selon le type de document.

Bonne pratique : lorsque la position à extraire varie d'un enregistrement à l'autre, combinez SUBSTR() avec FIND() ou LENGTH() pour calculer dynamiquement la position de départ plutôt que de la coder en dur.

Aller plus loin

LEFT()

Extrait les premiers caractères d'une chaîne de texte.

Lire la suite →

Ou continuer avec

Glossaire des formules

Tous les opérateurs et fonctions disponibles, classés par catégorie.