Dans une colonne de formule, 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. Elle est pratique pour isoler un préfixe, un code ou une portion fixe d'un texte.
Vous pouvez par exemple l'utiliser pour créer une souche de numérotation automatique pour vos devis, factures ou avoirs.
-
Nom de la fonction texte :
SUBSTR()
Syntaxe
SUBSTR(texte_original, position_départ, nombre_de_caractères)
Appel des paramètres de fonction dans TimeTonic :
- $nom_du_champ = champ (lien, colonne de table liée, nombre, sélection, formule, texte...).
- "texte libre" = texte libre à ajouter entre guillemets.
- ne pas utiliser de guillemets pour les nombres.
Paramètres
| Paramètre | Description |
|---|---|
texte_original |
La chaîne de caractères source (colonne ou texte) dans laquelle extraire les caractères. |
position_départ |
La position du premier caractère à extraire. Le comptage commence à 0 : le premier caractère porte l'indice 0. |
nombre_de_caractères |
Le nombre de caractères à extraire à partir de la position de départ. |
Exemple
1. Pour extraire les premiers caractères d'un texte :
SUBSTR("TT-2026-01", 0, 2)Résultat : "TT"
2. Pour créer une souche de numérotation à partir d'un champ $Type (contenant par exemple « Facture », « Devis » ou « Avoir ») :
SUBSTR($Type, 0, 3)
Résultat : "Fac" pour la valeur « Facture ».
Notes
- La position de départ commence à 0 : pour extraire à partir du premier caractère, indiquez
0.
Type de retour
La fonction renvoie une chaîne de texte.
Le format du type de sortie du résultat peut être configuré dans les options du champ de sortie de l'éditeur de formule. Pour plus de détails, consultez Options de format de sortie dans l'article Colonne de formule.
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.