|
|
|
|
|
|
|
|
|
|
version 2004.5 (Modifiée)
Chaine (expression{; format}) 
Alpha
| Paramètre | Type | Description | |
| expression | | Expression à convertir en chaîne (peut être de type | |
| Numérique, Entier, Entier long, Date ou Heure) | |||
| format | Alpha | Num | | Format d'affichage |
| Résultat | Alpha |  | expression convertie en chaîne alphanumérique |
Description
La commande Chaine retourne sous forme de chaîne alphanumérique l'expression de type numérique, Date ou Heure, que vous avez passée dans le paramètre expression.
Si vous ne passez pas le paramètre optionnel format, la chaîne est retournée dans le format par défaut du type de données correspondant. Si vous passez le paramètre format, vous pouvez définir suivant vos besoins le formatage de la chaîne retournée.
Expressions numériques
Si expression est du type numérique (Réel, Entier, Entier long), vous pouvez passer le paramètre optionnel de formatage de la chaîne. Voici quelques exemples :
| Exemple | Résultat |
| Chaine(2^15) `Utiliser format défaut | 32768 (Format par défaut) |
| Chaine(2^15;"### ##0 habitants") | 32 768 habitants |
| Chaine(1/3;"##0,00000") | 0,33333 |
| Chaine(1/3) `Utiliser format défaut | 0,3333333333333333 (Format défaut) |
| Chaine(Arctan(1)*4) | 3,1415926535897931 (Format défaut) |
| Chaine(Arctan(1)*4;"##0,00") | 3,14 |
| Chaine(-1;"&x") | 0xFFFFFFFF |
| Chaine(-1;"&$") | $FFFFFFFF |
| Chaine(0 ?+ 7;"&x") | 0x80 |
| Chaine(0 ?+ 7;"&$") | $80 |
| Chaine(0 ?+ 14;"&x") | 0x4000 |
| Chaine(0 ?+ 14;"&$") | $4000 |
| Chaine(Num(1=1);"Vrai;;Faux") | Vrai |
| Chaine(Num(1=2);"Vrai;;Faux") | Faux |
Le format est défini de la même manière que pour un champ numérique dans un formulaire. Pour plus d'informations sur le formatage des numériques, reportez-vous au manuel Mode Structure de 4e Dimension. Vous pouvez également passer le nom d'un style personnalisé dans format. Dans ce cas, le nom du style doit être précédé du caractère "|".
Expressions de type Date
Si expression est de type Date, la chaîne est retournée dans le format par défaut du pays (par exemple, JJ-MM-AA pour la version française). Vous pouvez passer une valeur dans le paramètre format, en fonction du tableau ci-dessous :
| Numéro | Format | Exemple |
| 1 | Court | 06-12-96 |
| 2 | Abrégé | ven 6 déc 1996 |
| 3 | Long | vendredi 6 décembre 1996 |
| 4 | Spécial | 06-12-96 (mais 06-12-1896 ou 06-12-2096) |
| 5 | Jour Mois Année | 6 décembre 1996 |
| 6 | Abrégé Jour Mois Année | 6 déc 1996 |
| 7 | Spécial forcé | 06-12-1996 |
| 8 | ISO Date Heure | 1996-06-12T00:00:00 |
4D fournit les constantes prédéfinies suivantes :
| Constante | Type | Valeur |
| Format court | Entier long | 1 |
| Format abrégé | Entier long | 2 |
| Format long | Entier long | 3 |
| Format spécial | Entier long | 4 |
| Jour Mois Année | Entier long | 5 |
| Abrégé Jour Mois Année | Entier long | 6 |
| Spécial forcé | Entier long | 7 |
| ISO Date Heure | Entier long | 8 |
Note : Le format ISO Date Heure correspondant à la norme ISO8601. Ce format contient une date et une heure. Par exemple, la date du 31 mai 2006 à 13h20 est notée 2006-05-31T13:20:00. Il est utilisé lors des traitements XML et dans le cadre des Web services. 4e Dimension ne permet pas de stocker dans un seul champ une date et une heure. Toutefois, il est possible de gérer des dates dans ce format à l'aide de la commande Chaine.
Voici quelques exemples (en supposant que nous soyons mardi 4 mars 1997) :
$vsRésultat:=Chaine(Date du jour) ` $vsRésultat prend la valeur "04-03-97" $vsRésultat:=Chaine(Date du jour;Jour Mois Année) ` $vsRésultat prend la valeur "4 Mars 1997" $vsRésultat:=Chaine(Date du jour;ISO Date Heure) ` $vsRésultat prend la valeur "1997-03-04T00:00:00"
Expressions de type Heure
Si expression est de type Heure, la chaîne est retournée dans le format par défaut hh:mm:ss. Vous pouvez passer une valeur dans le paramètre format, en fonction du tableau ci-dessous :
| Numéro | Format | Exemple |
| 1 | hh:mm:ss | 01:02:03 |
| 2 | hh:mm | 01:02 |
| 3 | heure minute seconde | 1 heure 2 minutes 3 secondes |
| 4 | heure minute | 1 heure 2 minutes |
| 5 | h:mm matin/après-midi | 1:02 du matin |
4D fournit les constantes suivantes :
| Constante | Type | Valeur |
| h mn s | Entier long | 1 |
| h mn | Entier long | 2 |
| Heure Minute Seconde | Entier long | 3 |
| Heure Minute | Entier long | 4 |
| h mn Matin Après Midi | Entier long | 5 |
Voici quelques exemples (en supposant qu'il soit 17h30 et 45 secondes) :
$vsRésultat:=Chaine(Heure courante) ` $vsRésultat prend la valeur "17:30:45" $vsRésultat:=Chaine(Heure courante;Heure Minute Seconde) ` $vsRésultat prend la valeur "17 heures 30 minutes 45 secondes"
Référence
Chaine heure, Date, Num.
|
|
|
|
|
|
|
|
|
|