|
|
|
|
|
|
|
|
|
|
Version 2004.5 (Geändert)
String (Ausdruck{; Format}) 
String
| Parameter | Typ | Beschreibung | |
| Ausdruck | | Ausdruck, der in Text umgewandelt werden | |
| soll (vom Typ numerisch, Datum oder Zeit) | |||
| Format | String | Nummer | | Anzeigeformat |
| Funktionsergebnis | String |  | Zeichenkette des Ausdrucks |
Beschreibung
Der Befehl String gibt eine Zeichenkette zurück für die in Ausdruck übergebenen Ausdrücke. Sie können vom Typ numerisch, Datum oder Zeit sein.
Format ist optional. Geben Sie diesen Parameter nicht an, wird das entsprechende Standardformat gewählt. Mit Format können Sie ein bestimmtes Format vorgeben.
Numerischer Ausdruck
Ist Ausdruck vom Typ numerisch (Zahl, Ganzzahl, Lange Ganzzahl), können Sie ein optionales Textformat übergeben. Hierzu einige Beispiele:
| Beispiel | Ergebnis |
| String(2^15) ` Verwende Standardformat | 32768 (Standardformat) |
| String(2^15;"###.##0 Einwohner") | 32.768 Einwohner |
| String(1/3;"##0,00000") | 0,33333 |
| String(1/3) ` Verwende Standardformat | 0,3333333333333333 (Standardformat) |
| String(Arctan(1)*4) | 3,1415926535897931 (Standardformat) |
| String(Arctan(1)*4;"##0.00") | 3,14 |
| String(-1;"&x") | 0xFFFFFFFF |
| String(-1;"&$") | $FFFFFFFF |
| String(0 ?+ 7;"&x") | 0x80 |
| String(0 ?+ 7;"&$") | $80 |
| String(0 ?+ 14;"&x") | 0x4000 |
| String(0 ?+ 14;"&$") | $4000 |
| String(Num(1=1);"True;;False") | Wahr |
| String(Num(1=2);"Herr;;Frau") | Frau |
Sie definieren das Format genauso wie für ein numerisches Datenfeld in einem Formular. Weitere Informationen dazu finden Sie im Handbuch 4th Dimension Designmodus. In Format können Sie auch eigene Stilvorlagen übergeben. Sie müssen dann dem Namen das Zeichen "|" voranstellen.
Ausdruck vom Typ Datum
Ist Ausdruck vom Typ Datum, erhalten Sie als Zeichenkette das Standardformat des jeweiligen Landes, z.B. TT.MM.JJJJ für die deutschsprachige Version.
Sie können aber auch zwischen folgenden Formaten wählen:
| Format | Name | Beispiel |
| 1 | Systemabhängig | 29.12.97 |
| 2 | Abgekürzt | So, 29. Dez 1997 |
| 3 | Ausgeschrieben | Sonntag, 29. Dezember 1997 |
| 4 | Jahrhundertabhängig | 29.12.1897, 29.12.1997 oder |
| 29.12.03 (für 2003) | ||
| 5 | 4D-Format: Ausgeschrieben | Sonntag, 29. Dezember 1997 |
| 6 | 4D-Format: Abgekürzt | So, 29. Dez. 1997 |
| 7 | Fest (Jahr vierstellig) | 29.12.1997 |
| 8 | ISO Datum Zeit | 1997-12-29T00:00:00 |
Hinweis:
Bei Format 4 hängt die Anzeige vom aktuellen Datum ab. Das aktuelle Jahrhundert wird zweistellig ausgegeben, andere Jahrhunderte vierstellig. Bei Format 5 und 6 bestimmt die 4D Version die Sprache, nicht die Einstellung im Betriebssystem. Entsprechend würde auch bei einem englischen System "Sonntag" statt "Sunday" erscheinen.
4D bietet folgende vordefinierte Konstanten:
| Konstante | Typ | Wert |
| Short | Lange Ganzzahl | 1 |
| Abbreviated | Lange Ganzzahl | 2 |
| Long | Lange Ganzzahl | 3 |
| MM DD YYYY | Lange Ganzzahl | 4 |
| Month Date Year | Lange Ganzzahl | 5 |
| Abbr Month Date | Lange Ganzzahl | 6 |
| MM DD YYYY Forced | Lange Ganzzahl | 7 |
| ISO Date Time | Lange Ganzzahl | 8 |
Hinweis: Das Format ISO Datum Zeit entspricht dem Standard ISO8601. Dieses Format enthält Datum und Zeit. So wird das Datum 31.Mai 2006 um 1:20 PM in der Form 2006-05-31T13:20:00 geschrieben. Es dient zur XML Bearbeitung und für Web-Dienste. 4th Dimension ermöglicht nicht, Datum und Zeit in einem einzigen Feld zu speichern. Mit der Funktion String lässt sich das jedoch über das ISO-Format verwalten.
Diese Beispiele gehen vom aktuellen Datum 29.12.97 aus:
$vsResult:=String(Current date) ` $vsResult ergibt "29.12.97" $vsResult:=String(Current date; Month Date Year) ` $vsResult ergibt "29. Dezember 1997" $vsResult:=String(Current date; ISO Date Time) ` $vsResult ergibt "1997-03-04T00:00:00"
Ausdruck vom Typ Zeit
Ist Ausdruck vom Typ Zeit, erhalten Sie als Zeichenkette das Standardformat HH:MM:SS. Sie können aber auch zwischen folgenden Formaten wählen:
| Format | Name | Beispiel |
| 1 | h:mn:s | 01:02:03 |
| 2 | h:mn | 01:02 |
| 3 | Stunde:Minute:Sekunde | 1 Stunde 2 Minuten 3 Sekunden |
| 4 | Stunde:Minute | 1 Stunde 2 Minuten |
| 5 | h:mn AM/PM | 1:02 AM |
4D bietet folgende vordefinierte Konstanten:
| Konstante | Typ | Wert |
| HH MM SS | Lange Ganzzahl | 1 |
| HH MM | Lange Ganzzahl | 2 |
| Hour Min Sec | Lange Ganzzahl | 3 |
| Hour Min | Lange Ganzzahl | 4 |
| HH MM AM PM | Lange Ganzzahl | 5 |
Diese Beispiele gehen von der aktuellen Zeit 5:30 PM und 45 Sekunden aus:
$vsResult:=String(Current time) ` $vsResult ergibt "17:30:45" $vsResult:=String(Current time;Hour Min Sec) ` $vsResult ergibt "17 Stunden 30 Minuten 45 Sekunden"
Referenz
Date, Num, Time string.
|
|
|
|
|
|
|
|
|
|