Chaine

4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 11 (Modifiée)


Chaine (expression{; format}) Chaîne

ParamètreTypeDescription
expressionExpression à convertir en chaîne (peut être de type
Réel, Entier, Entier long, Date, Heure, Alpha, Texte
ou Booléen)
formatAlpha | NumFormat d'affichage
RésultatChaîneexpression 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 :

ExempleRésultat
Chaine(2^15) `Utiliser format défaut32768 (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éfaut0,3333333333333330000 (Format défaut)
Chaine(Arctan(1)*4)3,141592653589790000 (Format défaut)
Chaine(Arctan(1)*4;"##0,00")3,14
Chaine(-1;"&x")0xFFFFFFFF
Chaine(-1;"&$")$FFFFFFFF
Chaine(0 ?+ 7;"&x")0x0080
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 "Formats d'affichage des dates") :

Numéro ConstanteExemple
1 Système date court06/12/2006
2 Système date abrégémer. 25 déc. 2006
3 Système date longmercredi 6 décembre 2006
4 Interne date court spécial06/12/06 (mais 06-12-1896 ou 06-12-2096)
5 Interne date long6 décembre 2006
6 Interne date abrégé 6 déc 1996
7Interne date court06/12/2006
8ISO Date2006-06-12T00:00:00
100Vide 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 jeudi 5 mars 2009) :

   $vsRésultat:=Chaine(Date du jour)   ` $vsRésultat prend la valeur "05/03/09"
   $vsRésultat:=Chaine(Date du jour;Interne date long)   ` $vsRésultat prend la valeur "5 Mars 2009"
   $vsRésultat:=Chaine(Date du jour;ISO Date)   ` $vsRésultat prend la valeur "2009-03-05T00: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 "Formats d'affichage des heures") :

Numéro ConstanteExemple
1 h mn s01:02:03
2 h mn01:02
3 Heures Minutes Secondes 1 heure 2 minutes 3 secondes
4 Heures Minutes1 heure 2 minutes
5h mn Matin Après midi1:02 du matin
6 mn s62:03
7Minutes secondes62 minutes 3 secondes
8ISO Heure0000-00-00T01:02:03
9Système heure court01:02:03
10Système heure long abrégé10203 AM (Mac uniquement)
11Système heure long1:02:03 AM HNEC (Mac uniquement)
100Vide 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.


4D - Documentation   Français   English   German   Español   Japanese   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant