FORMAT

Mit der Script-Funktion FORMAT können Sie Zahlen formatieren, indem Sie führende Nullen hinzufügen oder entfernen. Sie können die Anzahl der führenden Nullen zum Hinzufügen oder Entfernen sowie die Anzahl der Dezimalstellen bei Gleitkommazahlen angeben.

Syntax

FORMAT (Zahl [,Format])

Parameter

• FORMAT
  Formatiert Zahlen

• Zahl
  Die zu formatierende Zahl
  Format: Script-Literal oder Script-Variable

• Format
  Nullen, die nur als Platzhalter für die Anzahl der führenden Nullen dienen
  nur Fließkommazahlen: geben Sie ein Trennzeichen als Dezimaltrennzeichen und die Anzahl der Positionen hinter dem Dezimaltrennzeichen an
  Format: Script-Literal oder Script-Variable
  Standard: 0

Rückgabewert: Zahl mit oder ohne führende Nullen, je nachdem, was Sie angeben

Hinweise:

• Die Anzahl der Nullen, die Sie im Format-Parameter eingeben, dient als Platzhalter für die Gesamtzahl der Stellen. Wenn die Zahl weniger Ziffern hat, bleibt der Wert unverändert. Führende Nullen werden entfernt, wenn Sie diesen Parameter verwenden.
• Wenn Sie das Pluszeichen (+) als erstes Zeichen in den Format-Parameter aufnehmen, wird das Pluszeichen auch in positiven Zahlen ("+1,00") angezeigt. In diesem Fall muss die Zielvariable, der Sie den Rückgabewert der Funktion FORMAT zuweisen, die Datentyp STRING haben. Wenn das Ergebnis Null ist, weil alle Dezimalstellen entfernt wurden, wird das Vorzeichen entfernt. Weitere Informationen finden Sie unter Datentypen von Script-Variablen.
• Bei Gleitkommazahlen können Sie die Anzahl der Dezimalstellen angeben. Definieren Sie im Format-Parameter einen Dezimalpunkt als Trennzeichen. Geben Sie nach dem Trennzeichen so viele Nullen ein, wie Sie Dezimalstellen in Ihrer Zahl wünschen. Zahlen mit mehr Nachkommastellen werden ohne Rundung abgeschnitten. Wenn Sie keinen Dezimalpunkt angeben, werden alle Dezimalstellen entfernt. Wenn die Zahl weniger Nachkommastellen hat, als Sie im Format-Parameter angegeben haben, werden die restlichen Stellen mit nachgestellten Nullen gefüllt.
• Ein formatierter Gleitkommavariablenwert muss einer Variablen des Typs string zugewiesen werden.

Beispiele

Das folgende Beispiel entfernt führende Nullen aus dem 16-stelligen Rückgabewert der -Script-Funktion SYS_BUSY_60 und gibt das Ergebnis im Aktivierungsreport aus:

: SET   &SRV# = SYS_BUSY_60 ()
: SET   &RET# = FORMAT ( &SRV# )
: PRINT   &RET#

Das folgende Beispiel fügt führende Nullen hinzu, um die angegebene Länge von 5 Stellen zu erreichen, und gibt das Ergebnis (00125) im Aktivierungsreport aus:

: SET &RET# = FORMAT ( "125" , "00000" )
: PRINT   &RET#

Das folgende Beispiel entfernt führende Nullen und gibt das Ergebnis (333) im Aktivierungsreport aus:

: SET   &RET# = FORMAT ( "0000333" , "00" )
: PRINT   &RET#

Im folgenden Beispiel ändert sich die Zahl nicht, da es keine führenden Nullen gibt, sodass die Zahl wie bisher dem angegebenen Format entspricht:

: SET   &RET# = FORMAT ( "555" , "00" )
: PRINT   &RET#

Das folgende Beispiel formatiert eine Gleitkommazahl so, dass sie nur eine Dezimalstelle hat, und gibt das Ergebnis (-0,7) im Aktivierungsreport aus: 

:DEFINE &NUM#,float
:DEFINE &RET#,string
:SET &NUM#=-0.75
: SET   &RET# = FORMAT (&NUM#, "00.0" )
: PRINT   &RET#

Das folgende Beispiel entfernt alle Dezimalstellen und gibt das Ergebnis (0000) im Aktivierungsreport aus:

:DEFINE &NUM#,float
:DEFINE &RET#,string
:SET &NUM#=0.65
: SET   &RET# = FORMAT (&NUM#, "0000" )
: PRINT   &RET#

Siehe auch: