Number.ToTextNumber.ToText

СинтаксисSyntax

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

О программеAbout

Преобразует числовое значение number в текстовое в соответствии с форматом, указанным в format.Formats the numeric value number to a text value according to the format specified by format. В качестве формата используется одиночный символ, к которому может добавляться указатель точности числа.The format is a single character code optionally followed by a number precision specifier. Для format можно использовать перечисленные ниже коды символов.The following character codes may be used for format.

  • "D" или "d": (десятичное) результат представляется в виде целого числа."D" or "d": (Decimal) Formats the result as integer digits. Указатель точности определяет количество цифр в выходных данных.The precision specifier controls the number of digits in the output.
  • "E" или "e": (Exponential): экспоненциальная запись."E" or "e": (Exponential/scientific) Exponential notation. Указатель точности определяет максимальное количество десятичных разрядов (по умолчанию 6).The precision specifier controls the maximum number of decimal digits (default is 6).
  • "F" или "f": (с фиксированной запятой) целая и десятичная дробная части."F" or "f": (Fixed-point) Integral and decimal digits.
  • "G" или "g": (общее) наиболее компактная форма из формы с фиксированной запятой и экспоненциальной."G" or "g": (General) Most compact form of either fixed-point or scientific.
  • "N" или "n": (число) целая и десятичная дробная части с разделителями разрядов и десятичным разделителем."N" or "n": (Number) Integral and decimal digits with group separators and a decimal separator.
  • "P" или "p": (проценты) число, умноженное на 100 и отображаемое со знаком процента."P" or "p": (Percent) Number multiplied by 100 and displayed with a percent symbol.
  • "R" или "r": (для обратного преобразования) текстовое значение, которое может быть преобразовано обратно в идентичное число."R" or "r": (Round-trip) A text value that can round-trip an identical number. Указатель точности не учитывается.The precision specifier is ignored.
  • "X" или "x": (шестнадцатеричное) шестнадцатеричное текстовое значение."X" or "x": (Hexadecimal) A hexadecimal text value.
Можно также указать необязательный параметр culture (например, en-US).An optional culture may also be provided (for example, "en-US").

Пример 1Example 1

Представление числа в виде текста без указания формата.Format a number as text without format specified.

Number.ToText(4)

"4"

Пример 2Example 2

Представление числа в виде текста в экспоненциальном формате.Format a number as text in Exponential format.

Number.ToText(4, "e")

"4.000000e+000"

Пример 3Example 3

Форматирование числа в виде текста в десятичном формате с ограниченной точностью.Format a number as text in Decimal format with limited precision.

Number.ToText(-0.1234, "P1")

"-12.3 %"