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 (number [,format])
Parameter
- FORMAT
Zahlenformate - number
Zahl, die Sie formatieren möchten
Format: Script-Literal oder Script-Variable - format
Nullen, die als Platzhalter für die Anzahl der führenden Nullen dienen
nur Gleitkommazahlen: Geben Sie ein Trennzeichen als Dezimalpunkt und die Anzahl der Nachkommastellen an
Format: Script-Literal oder Script-Variable
Standardwert: 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.
Beispiele
Das folgende Beispiel entfernt führende Nullen aus dem 16-stelligen Rückgabewert der SYS_BUSY_60-Script-Funktionund 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, so dass 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: