TRANSFORM( )-Funktion

Konvertiert die Zeichenfolge eines Ausdrucks über eine Formatierungszeichenfolge in eine formatierte Zeichenfolge.

TRANSFORM(eExpression, [cFormatCodes])

Rückgabewerte

Zeichen

Parameter

• eExpression
  Gibt das Zeichen, die Währung, das Datum oder einen numerischen Ausdruck an, der formatiert werden soll.
• cFormatCodes
  Gibt einen oder mehr Formatcodes an, die bestimmen, wie der Ausdruck formatiert wird. Die folgende Tabelle listet die verfügbaren Formatcodes auf:

  Formatcodes	Beschreibung
  @B	Numerische Daten werden im Anzeigebereich linksbündig angeordnet.
  @C	Die Zeichenfolge CR wird an positive numerische oder Währungswerte angehängt, um ein Haben anzuzeigen.
  @D	Datum- und Datum/Zeit-Werte werden in das aktuelle SET DATE-Format umgewandelt.
  @E	Datum- und Datum/Zeit-Werte werden in ein BRITISCHES Datumsformat umgewandelt.
  @L	Versieht numerische Daten mit führenden Nullen.
  @R	Die Umwandlung verwendet eine Formatmaske. Die Maskenzeichen werden nicht in den umgewandelten Werten gespeichert. Diese Einstellung kann nur für die Datentypen Zeichen oder Numerisch verwendet werden. Maskenzeichen sind: 9 oder #   Steht für ein Zeichen oder eine Zahl. !   Wandelt Kleinbuchstaben in Großbuchstaben um.
  @T	Führende und nachfolgende Leerzeichen werden von den Zeichenwerten entfernt.
  @X	Die Zeichenfolge DB wird an negative numerische oder Währungswerte angehängt, um ein Soll anzuzeigen.
  @Z	Wenn gleich 0, werden numerische oder Währungswerte in Leerzeichen umgewandelt.
  @(	Schließt negative numerische oder Währungswerte in runde Klammern ein.
  @^	Wandelt numerische oder Währungswerte in wissenschaftliche Notation um.
  @0	Wandelt numerische oder Währungswerte in ihre hexadezimale Entsprechung um. Die Werte müssen positiv und kleiner als 4.294.967.296 sein.
  @!	Wandelt eine ganze Zeichenfolge in Großbuchstaben um.
  @$	Fügt das aktuelle durch SET CURRENCY vorgegebene Währungssymbol zu den numerischen und Währungswerten hinzu. Standardmäßig wird dieses Zeichen unmittelbar vor oder hinter dem Wert angeordnet. Das Währungssymbol sowie dessen Position (festgelegt mit SET CURRENCY), das Trennzeichen (festgelegt mit SET SEPARATOR) und das Dezimalzeichen (festgelegt mit SET POINT) können geändert werden.
  X	Gibt die Breite der Zeichenwerte an. Wenn beispielsweise cFormatCodes gleich XX ist, werden zwei Zeichen zurückgegeben.
  Y	Wandelt logische Wahr (.T.)- und Falsch (.F.)-Werte in entsprechende Y und N um.
  !	Wandelt an der entsprechenden Stelle in einer Zeichenfolge einen Kleinbuchstaben in einen Großbuchstaben um.
  .	Gibt die Position des Dezimalpunktes in numerischen und Währungswerten an.
  ,	Trennt Ziffern links des Dezimalpunktes in numerische und Währungswerte.

Wenn Sie cFormatCodes nicht angeben, führt Visual FoxPro eine Standardumwandlung mit eExpression durch. Die folgende Tabelle beschreibt die Umwandlung, die für jeden Datentyp durchgeführt wird, den eExpression annehmen kann:

Beispiel

STORE 12.34 TO gnPrice
CLEAR
? TRANSFORM(gnPrice, '$$$$.99')  && Displays $12.34

Siehe auch

DTOC( ) | TTOC( ) | InputMask-Eigenschaft