Number.ToText

  • Статья
  • Чтение занимает 2 мин

Синтаксис

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

О программе

Преобразует числовое значение number в текстовое в соответствии с форматом, указанным в format. В качестве формата используется одиночный символ, к которому может добавляться указатель точности числа. Для format можно использовать перечисленные ниже коды символов.

  • "D" или "d": (десятичное) результат представляется в виде целого числа. Указатель точности определяет количество цифр в выходных данных.
  • "E" или "e": (Exponential): экспоненциальная запись. Указатель точности определяет максимальное количество десятичных разрядов (по умолчанию 6).
  • "F" или "f": (с фиксированной запятой) целая и десятичная дробная части.
  • "G" или "g": (общее) наиболее компактная форма из формы с фиксированной запятой и экспоненциальной.
  • "N" или "n": (число) целая и десятичная дробная части с разделителями разрядов и десятичным разделителем.
  • "P" или "p": (проценты) число, умноженное на 100 и отображаемое со знаком процента.
  • "R" или "r": (для обратного преобразования) текстовое значение, которое может быть преобразовано обратно в идентичное число. Указатель точности не учитывается.
  • "X" или "x": (шестнадцатеричное) шестнадцатеричное текстовое значение.

Можно также указать необязательный параметр culture (например, en-US).

Пример 1

Представление числа в виде текста без указания формата.

Использование

Number.ToText(4)

Выходные данные

"4"

Пример 2

Представление числа в виде текста в экспоненциальном формате.

Использование

Number.ToText(4, "e")

Выходные данные

"4.000000e+000"

Пример 3

Форматирование числа в виде текста в десятичном формате с ограниченной точностью.

Использование

Number.ToText(-0.1234, "P1")

Выходные данные

"-12.3 %"