|
|
|
|
|
|
|
|
|
|
|
version 11 (Modifiée)
Chaine (expression{; format}) 
Chaîne
| Paramètre | Type | Description | |
| expression | | Expression à convertir en chaîne (peut être de type | |
| Réel, Entier, Entier long, Date, Heure, Alpha, Texte | |||
| ou Booléen) | |||
| format | Alpha | Num | | Format d'affichage |
| Résultat | Chaîne |  | 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, Heure, chaîne ou Booléen 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 Développement de 4D. 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 défini dans le système. Vous pouvez passer dans le paramètre format une des constantes suivantes (thème "Format d'affichage des dates") :
| Numéro | Constante | Exemple |
| 1 | Système date court | 06/12/2006 |
| 2 | Système date abrégé | mer. 25 déc. 2006 |
| 3 | Système date long | mercredi 6 décembre 2006 |
| 4 | Interne date court spécial | 06/12/06 (mais 06-12-1896 ou 06-12-2096) |
| 5 | Interne date long | 6 décembre 2006 |
| 6 | Interne date abrégé | 6 déc 1996 |
| 7 | Interne date court | 06/12/2006 |
| 8 | ISO Date | 2006-06-12T00:00:00 |
| 100 | Vide si date nulle | "" au lieu de 0 |
Notes :
• Le format ISO Date correspond à la norme ISO8601. Ce format contient en principe 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. 4D 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.
• La constante Vide si date nulle doit être additionnée au format, elle indique qu'en cas de valeur nulle 4D doit retourner une chaîne vide au lieu de zéros.
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;Interne date long) ` $vsRésultat prend la valeur "4 Mars 1997" $vsRésultat:=Chaine(Date du jour;ISO Date) ` $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 dans le paramètre format une des constantes suivantes (thème "Format d'affichage des heures") :
| Numéro | Constante | Exemple |
| 1 | h mn s | 01:02:03 |
| 2 | h mn | 01:02 |
| 3 | Heures Minutes Secondes | 1 heure 2 minutes 3 secondes |
| 4 | Heures Minutes | 1 heure 2 minutes |
| 5 | h mn Matin Après midi | 1:02 du matin |
| 6 | mn s | 62:03 |
| 7 | Minutes secondes | 62 minutes 3 secondes |
| 8 | ISO Heure | 0000-00-00T01:02:03 |
| 9 | Système heure court | 01:02:03 |
| 10 | Système heure long abrégé | 1•02•03 AM (Mac uniquement) |
| 11 | Système heure long | 1:02:03 AM HNEC (Mac uniquement) |
| 100 | Vide si heure nulle | "" au lieu de 0 |
Notes :
• Pour plus d'informations sur le format ISO Heure, reportez-vous à la note ci-dessus.
• La constante Vide si heure nulle doit être additionnée au format, elle indique qu'en cas de valeur nulle 4D doit retourner une chaîne vide au lieu de zéros.
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;Heures Minutes Secondes) ` $vsRésultat prend la valeur "17 heures 30 minutes 45 secondes"
Expressions de type chaîne
Si expression est de type Alpha ou Texte, la commande retourne la même valeur que celle passée en paramètre. Ce fonctionnement est utile notamment dans le cadre d'une programmation générique utilisant des pointeurs.
Dans ce cas, le paramètre format, s'il est passé, est ignoré.
Expressions de type Booléen
Si expression est de type Booléen, la commande retourne la chaîne "Vrai" ou "Faux" dans la langue de l'application ("True" ou "False" dans une version anglaise de 4D).
Dans ce cas, le paramètre format, s'il est passé, est ignoré.
Référence
Chaine heure, Date, Num.
|
|
|
|
|
|
|
|
|
|
|