Number.ToTextNumber.ToText

SyntaxSyntax

Number.ToText(number as nullable number, optional format as nullable text, optional culture as nullable text) as nullable text 

InfoAbout

Mit dieser Funktion wird der numerische Wert number gemäß des von format angegebenen Formats in einen Textwert formatiert.Formats the numeric value number to a text value according to the format specified by format. Bei dem Format handelt es sich um einen einzelnen Zeichencode gefolgt von einem Genauigkeitsspezifizierer für Nummern.The format is a single character code optionally followed by a number precision specifier. Die folgenden Zeichencodes können für format verwendet werden.The following character codes may be used for format.

  • „D“ oder „d“: (dezimal) Das Ergebnis wird als ganzzahlige Ziffern formatiert."D" or "d": (Decimal) Formats the result as integer digits. Der Genauigkeitsspezifizierer überprüft die Anzahl der Ziffern in der Ausgabe.The precision specifier controls the number of digits in the output.
  • „E“ oder „e“: (Exponentiell/wissenschaftlich) Exponentialschreibweise."E" or "e": (Exponential/scientific) Exponential notation. Der Genauigkeitsspezifizierer überprüft die maximale Anzahl von Dezimalstellen (Standardwert ist 6).The precision specifier controls the maximum number of decimal digits (default is 6).
  • „F“ oder „f“: (Fester Punkt) Das Ergebnis wird in Ganzzahlen und mit Dezimalstellen angegeben."F" or "f": (Fixed-point) Integral and decimal digits.
  • „G“ oder „g“: (allgemein) Das Ergebnis wird in der kompaktesten Form mit festem Punkt oder in der wissenschaftlichen Schreibweise zurückgegeben."G" or "g": (General) Most compact form of either fixed-point or scientific.
  • „N“ oder „n“: (Zahl) Das Ergebnis wird in Ganzzahlen und mit Dezimalstellen angegeben, wobei Gruppen- und Dezimaltrennzeichen verwendet werden."N" or "n": (Number) Integral and decimal digits with group separators and a decimal separator.
  • „P“ oder „p“: (Prozent) Die Zahl wird mit 100 multipliziert und mit einem Prozentzeichen angezeigt."P" or "p": (Percent) Number multiplied by 100 and displayed with a percent symbol.
  • „R“ oder „r“: (Roundtrip) Hier wird das Ergebnis in einem Textwert zurückgegeben, der auch mit einer identischen Zahl in einem anderen Format angegeben werden kann."R" or "r": (Round-trip) A text value that can round-trip an identical number. Der Genauigkeitsspezifizierer wird ignoriert.The precision specifier is ignored.
  • „X“ oder „x“: (hexadezimal) Das Ergebnis wird in einem hexadezimalen Textwert zurückgegeben."X" or "x": (Hexadecimal) A hexadecimal text value.
Möglicherweise wird auch eine optionale culture bereitgestellt (z. B. „en-US“).An optional culture may also be provided (for example, "en-US").

Beispiel 1Example 1

Hier wird eine Zahl als Text ohne angegebenes Format formatiert.Format a number as text without format specified.

Number.ToText(4)

"4"

Beispiel 2Example 2

Hier wird eine Zahl als Text im Exponentialformat formatiert.Format a number as text in Exponential format.

Number.ToText(4, "e")

"4.000000e+000"

Beispiel 3Example 3

Hier wird eine Zahl als Text im Dezimalformat mit eingeschränkter Genauigkeit formatiert.Format a number as text in Decimal format with limited precision.

Number.ToText(-0.1234, "P1")

"-12.3 %"