Num# - Skript- und Diagrammfunktion
Num#() interpretiert einen Textstring als numerischen Wert, konvertiert also den Eingabestring in eine Zahl anhand des im zweiten Parameter angegebenen Formats. Wenn der zweite Parameter ausgelassen wird, werden die Zehner- und Tausendertrennzeichen verwendet, die im Datenladeskript festgelegt sind. Angepasste Dezimal- und Tausendertrennzeichen sind optionale Parameter.
Syntax:
Num#(text[, format[, dec_sep [, thou_sep ] ] ])
Rückgabe Datentyp: dual
Die Funktion Num#() gibt einen dualen Wert mit dem String- und dem Zahlenwert zurück. Die Funktion nimmt die Textdarstellung der Eingabeformel und generiert eine Zahl. Das Format der Zahl wird nicht geändert. Die Ausgabe ist genau so formatiert wie die Eingabe.
Argumente:
| Argument | Beschreibung |
|---|---|
| text |
Der zu evaluierende Textstring. |
| format |
String zur Angabe des Zahlenformats im ersten Parameter. Ist kein String angegeben, werden die Dezimal- und Tausendertrennzeichen verwendet, die im Datenladeskript festgelegt sind. |
| dec_sep |
String zur Angabe des Dezimaltrennzeichens. Ist kein String angegeben, wird der vom Datenladeskript vorgegebene Wert der Variablen DecimalSep verwendet. |
| thou_sep |
String zur Angabe des Tausendertrennzeichens. Ist kein String angegeben, wird der vom Datenladeskript vorgegebene Wert der Variablen ThousandSep verwendet. |
Beispiel:
Die folgende Tabelle zeigt das Ergebnis von Num#( A, '#', '.' , ',') für verschiedene Werte von A.
| A | String-Darstellung | Numerischer Wert (hier mit Dezimalpunkt dargestellt) |
|---|---|---|
| 35,648.31 | 35,648.31 | 35648.31 |
| 35 648.312 | 35 648.312 | 35648.312 |
| 35.648,3123 | 35.648,3123 | - |
| 35 648,31234 | 35 648,31234 | - |