STRING( )-Funktion

Konvertiert einen numerischen Wert in einen Zeichenstring.

Syntax

STRING(Zahl; Länge <;Format>)

Parameter

Name Typ Beschreibung
Nummer

numerisch

Der in eine Zeichenfolge zu konvertierende numerische Wert.

Länge numerisch

Die Anzahl der Zeichen der Ausgabezeichenfolge.

Format

Optional

Zeichen Die auf die Ausgabezeichenfolge anzuwendende Formatierung. Zum Beispiel: "(9999,99)"

Ausgabe

Zeichen.

Beispiele

Einfache Beispiele

Nicht formatierte Zeichenfolgen

Gibt „ 125,2“ zurück:

STRING(125,2; 6)

Gibt „25,2“ zurück („-1“ wird abgeschnitten, da Länge kleiner ist als die Anzahl an Stellen und Formatierungszeichen in Zahl):

STRING(-125,2; 4)

Gibt „ -125,2“ zurück:

STRING(-125,2; 7)

Formatierte Zeichenfolgen

Gibt „  (125,20)“ zurück:

STRING(-125,2; 10;  "(9.999,99)")

Gibt „25,20“ zurück („1“ wird abgeschnitten, da Länge kleiner ist als die Anzahl an Stellen und Formatierungszeichen in Zahl):

STRING(125,2; 6;  "(9.999,99)")

Feldeingabe

Gibt numerische Werte im Feld Mitarbeiternummer als Zeichenfolgen mit einer Länge von zehn Zeichen zurück. Falls notwendig, wird der Rückgabewert aufgefüllt oder abgeschnitten:

STRING(Mitarbeiternummer; 10)

Bemerkungen

Aufgefüllte und abgeschnittene Rückgabewerte

STRING( ) konvertiert Zahl in eine Zeichenfolge mit der angegebenen Länge:

  • Wenn Zahl kürzer ist als Länge, werden dem Rückgabewert Leerzeichen hinzugefügt.
  • Wenn die Zahl länger ist als die Länge, wird der Rückgabewert von links abgeschnitten.

Den Rückgabewert formatieren

Mit dem optionalen Parameter Format werden dem Rückgabewert Formatierungen wie z.B. Eurozeichen, Prozentsymbole, Dezimalstellen, Kommas, Minuszeichen oder Klammern hinzugefügt. Das Format muss durch doppelte Anführungszeichen umschlossen sein.

Die Ziffer 9 dient als Platzhalter für die zu formatierenden Stellen. Stellen Sie sicher, dass die richtige Anzahl an Neunen angegeben wurde, um eine ordnungsgemäße Anzeige zu gewährleisten. Zudem müssen beim Angeben des Werts für Länge Dezimalstellen und Formatierungszeichen berücksichtigt werden, z.B. Eurozeichen und Klammern für negative Zahlen.

Verwandte Funktionen

STING( ) ist das Gegenteil der Funktion VALUE( ), mit der Zeichendaten in numerische Daten umgewandelt werden.

Leitfaden für die Skripterstellung in ACL 14.1