CONVERT

Strings

HEX

---

FORMAT

Script-Funktion: Änderung der Formatierung einer Zahl

Syntax

FORMAT(Number, [Format])

Anmerkungen

Mit der Script-Funktion können führende Nullen einer Ganzzahl hinzugefügt oder entfernt werden. Die Anzahl an Nullen, die Sie in diesem Parameter vermerken, dienen als Platzhalter für die Gesamtanzahl der Stellen. Geben Sie dazu einen Dezimalpunkt als Trennzeichen beim Parameter Format an. Mit den Nullen nach dem Trennzeichen wird die Anzahl der Nachkommastellen definiert. Nachkommastellen, die über die diese Anzahl hinausgehen, werden abgeschnitten. Es erfolgt keine Rundung! Wird der Dezimalpunkt nicht angegeben, so werden alle Nachkommastellen entfernt. Besitzt die Zahl weniger Kommastellen als bei Format angegeben, so wird der Rest mit Nullen aufgefüllt.

Durch die Verwendung des Parameters Format, kann die Anzahl der führenden Nullen von Ganzzahlen festgelegt werden. Die Anzahl an Nullen, die Sie in diesem Parameter vermerken, dienen als Platzhalter für die Gesamtanzahl der Stellen. Ist die Anzahl der angegebenen Stellen kleiner als die der Zahl, so bleibt der Wert unverändert.Geben Sie diesen Parameter nicht an, so entfernt die Funktion ihre führenden Nullen.

Wird zusätzlich bei Format ein '+' als erstes Zeichen angegeben (zum Beispiel: "+0.00"), wird das Vorzeichen auch bei positiven Zahlen angezeigt.

Die Zielvariable, die den Rückgabewert der Funktion zugewiesen bekommt, muss den Datentyp "string" aufweisen!

Ist das Ergebnis durch Entfernung aller Nachkommastellen 0, so spielt das Vorzeichen keine Rolle mehr und es wird entfernt.

Beispiele

Das erste Beispiel entfernt die führenden Nullen beim 16-stelligen Rückgabewert einer Script-Funktion. Das Ergebnis wird im Aktivierungsprotokoll ausgegeben.

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

Im zweiten Beispiel wird die angegebene Zahl 5-stellig formatiert. Das Ergebnis (00125) wird im Aktivierungsprotokoll ausgegeben.

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

Auch im dritten Beispiel werden die führenden Nullen entfernt, weil die Anzahl der Stellen zu klein angegeben wurde. Das Ergebnis (333) wird im Aktivierungsprotokoll ausgegeben.

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

Im vierten Beispiel bleibt die Zahl unverändert.

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

The fifth example shows the formatting of a floating-point number to one position after the decimal point. "-0.7" is output in the activation protocol. 

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

Im sechsten Beispiel werden die Kommastellen entfernt. Die Ausgabe im Aktivierungsreport ist "0000".

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

Siehe auch:

Script-Sprachmittel - Strings

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung