Der Befehl String gibt eine Zeichenkette zurück für die in Ausdruck übergebenen Ausdrücke. Sie können vom Typ numerisch, Datum, Zeit, String oder Boolean 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.

Der optionale Parameter plusZeit fügt in einem kombinierten Format an ein Datum eine Zeit hinzu. Er ist nur verwendbar, wenn der Parameter Ausdruck ein Datum ist (siehe unten).

Numerischer Ausdruck
Ist Ausdruck vom Typ numerisch (Zahl, Ganzzahl, Lange Ganzzahl), können Sie ein optionales Textformat übergeben. Hierzu einige Beispiele:

(*) Der Algorithmus für die Konvertierung von reellen Werten in Text basiert auf 13 signifikanten Stellen .

Sie definieren das Format genauso wie für ein numerisches Datenfeld in einem Formular. Weitere Informationen dazu finden Sie im Abschnitt Zahlenformate des Handbuchs 4D Designmodus. In Format können Sie auch eigene Stilvorlagen übergeben. Sie müssen dann dem Namen das Zeichen “|” voranstellen.

Hinweis: Die Funktion String ist nicht kompatibel mit Feldern vom Typ "Ganzzahl 64 bits" im kompilierten Modus.

Datumsausdrücke
Wenn es sich bei Ausdruck um einen Datumsausdruck handelt und Sie den Parameter format weglassen, wird der String unter Verwendung des im System festgelegten Standardformats zurückgegeben. 

Andernfalls können Sie im Parameter format übergeben:

• entweder ein vordefiniertes Format, das über die folgenden Konstanten des Datum Anzeigeformate Themas verfügbar ist (Longint-Wert):
  

  Konstante	Wert	Kommentar
  Blank if null date	100	"" statt 0
  Date RFC 1123	10	Fri, 10 Sep 2010 13:07:20 GMT
  Internal date abbreviated	6	29. Dez 2006
  Internal date long	5	29. Dezember 2006
  Internal date short	7	29.12.2006
  Internal date short special	4	29.12.06 (aber 29.12.1896 oder 29.12.2096)
  ISO Date	8	2006-29-12T00:00:00
  ISO Date GMT	9	2010-09-13T16:11:53Z
  System date abbreviated	2	Fr, 29. Dez 2006
  System date long	3	Freitag, 29. Dezember 2006
  System date short	1	29.12.2006

  
  Beispiele:

• oder ein benutzerdefiniertes Format, das auf einem Muster basiert (String-Wert)

Beispiele:

Hinweis: Die Formate können je nach Systemeinstellungen variieren.

addTime-Parameter
Bei der Verarbeitung von Datumsausdrücken können Sie mit dem Parameter addTime auch eine Zeit übergeben. Mit diesem Parameter können Sie ein Datum mit einer Uhrzeit kombinieren, so dass Sie Zeitstempel in Übereinstimmung mit den aktuellen Standards (ISO Date GMT und Date RFC 1123 Konstanten) erzeugen können. Diese Formate sind vor allem im Zusammenhang mit der Verarbeitung von xml und Web nützlich. Der Parameter addTime kann nur verwendet werden, wenn der Parameter Ausdruck ein Datum ist.
This parameter can be used with both predefined or pattern-based date formats. Examples:

• Das Format ISO Date GMT entspricht dem Standard ISO8601. Dieses Format enthält Datum und Zeit unter Berücksichtigung der Zeitzone (GMT).
  
   $mydate:=String(Current date;ISO Date GMT;Current time) // gibt z.B. 2010-09-13T16:11:53Z zurück
  
  Beachten Sie, dass das Zeichen "Z" am Ende das GMT Format angibt.
  Übergeben Sie nur ein Datum, gibt der Befehl das Datum um Mitternacht (lokale Zeit) in GTM Zeit zurück. Das kann je nach der lokalen Zeitzone bewirken, dass das Datum vor- oder zurückbewegt wird:
  
   $mydate:=String(!13/09/2010!;ISO Date GMT) // gibt 2010-09-12T22:00:00Z in Deutschland zurück
• Das Format ISO Date ist ähnlich zum Format ISO Date GMT, mit dem Unterschied, dass es Datum und Zeit ohne Berücksichtigung der Zeitzone ausdrückt. Beachten Sie, dass dieses Format nicht dem Standard ISO8601 entspricht. Es sollte nur für ganz bestimmte Zwecke verwendet werden.
  
   $mydate:=String(!13/09/2010!;ISO Date) // gibt  2010-09-13T00:00:00 zurück unabhängig von der Zeitzone.
 $mydate:=String(Current date;ISO Date;Current time) // gibt 2010-09-13T18:11:53 zurück
• Das Format Date RFC 1123 formatiert eine Datum-/Zeitkombination gemäß dem von RFC 822 und 1123 definierten Standard. Sie benötigen dieses Format zum Beispiel, um für Cookies in einem HTTP Header das Ablaufdatum zu setzen.
   $mydate:=String(Current date;Date RFC 1123;Current time) // gibt z.B. Fr, 10 Sep 2010 13:07:20 GMT zurück
  
  Die dargestellte Zeit berücksichtigt die Zeitzone (GMT Zone). Übergeben Sie nur ein Datum, gibt der Befehl das Datum um Mitternacht (lokale Zeit) ausgedrückt in GMT Zeit zurück. Das kann je nach der lokalen Zeitzone bewirken, dass das Datum vor- oder zurückbewegt wird:
  
   $mydate:=String(Current date;Date RFC 1123) // gibt Do, 09 Sep 2010 22:00:00 GMT

Ausdruck vom Typ Zeit
Ist Ausdruck vom Typ Zeit, erhalten Sie als Zeichenkette das Standardformat HH:MM:SS. Im Parameter Format können Sie eine Konstante unter dem Thema Zeit Anzeigeformate übergeben:

Andernfalls können Sie im Parameter format übergeben:

• entweder ein vordefiniertes Format, das über die folgenden Konstanten des Zeit Anzeigeformate Themas verfügbar ist (Longint-Wert):
  

  Konstante	Wert	Kommentar
  Blank if null time	100	"" statt 0
  HH MM	2
  HH MM AM PM	5
  HH MM SS	1
  Hour min	4	1 Stunde 2 Minuten
  Hour min sec	3	1  Stunde 2 Minuten 3 Sekunden
  ISO time	8
  Min sec	7	62 Minuten 3 Sekunden
  MM SS	6
  System time long	11	1:02:03 AM HNEC (nur Mac OS)
  System time long abbreviated	10	1•02•03 AM (nur Mac OS)
  System time short	9

  
  Beispiele:
  
  
   $vsResult:=String(?17:30:45?;HH MM AM PM) //"17:30 PM"
 $vsResult:=String(?17:30:45?;Hour Min Sec) //"17 Stunden 30 Minuten 45 Sekunden"

• oder ein benutzerdefiniertes Format, das auf einem Muster basiert (String-Wert)
  
  Beispiele:
  
  
   $vsResult:=String(?17:30:45?;"hh:mm aa O") //"05:30 PM GMT+1"
 $vsResult:=String(?17:30:45?;"'Es ist' K a") //"Es ist 17 Uhr"

Hinweise:

• Das Format ISO Time entspricht dem Standard ISO8601 und enthält theoretisch ein Datum und eine Zeit.Da dieses Format keine Kombination Datum/Zeit unterstützt, wird der Datumsteil mit Nullen gefüllt. Dieses Format stellt die lokale Zeit dar.
• Die Konstante Blank if null muss zum Format hinzugefügt werden; sie gibt an, dass 4D im Falle von einem Nullwert anstelle von Nullen einen leeren String zurückgibt.

Ausdruck vom Typ String
Ist Ausdruck vom Typ String oder Text, gibt die Funktion den Wert wie eingetragen zurück. Das ist besonders bei generischer Programmierung mit Zeigern hilfreich. In diesem Fall wird der Parameter Format ignoriert.

Ausdruck vom Typ Boolean
Ist Ausdruck vom Typ Boolean, gibt die Funktion den String "True" oder "False" in der Sprache der Anwendung zurück, also "Wahr" oder "Falsch" in der deutschen Version. In diesem Fall wird der Parameter Format ignoriert.

Undefinierte Ausdrücke
Wird Ausdruck als undefiniert gewertet, gibt String einen leeren String zurück. Das ist hilfreich, wenn als Ergebnis eines Ausdrucks (z.B. ein Objektattribut) ein String erwartet wird, auch wenn er undefiniert ist.

Null Ausdrücke
Wird Ausdruck als Null gewertet, gibt String den String "Null" zurück. Das ist hilfreich, wenn als Ergebnis eines Ausdrucks (z.B. ein Objektattribut) ein String erwartet wird, auch wenn er Null ist.