1. Главная
  2. Документы
  3. Функции
  4. Работа со строками
  5. String.Format()

String.Format()

Метод Format принимает строку с плейсхолдерами типа {0}, {1} и т.д., а также набор аргументов, которые вставляются на место данных плейсхолдеров. В итоге генерируется новая строка.

В методе Format могут использоваться различные спецификаторы и описатели, которые позволяют настроить вывод данных. Рассмотрим основные описатели.

Синтаксис:

String.Format(format, string)

Параметры:

format - строку с плейсхолдерами см.ниже

string - форматируемая строка

Возвращаемый тип данных:

строка

Все используемые форматы:

C / cЗадает формат денежной единицы, указывает количество десятичных разрядов после запятой
D / dЦелочисленный формат, указывает минимальное количество цифр
E / eЭкспоненциальное представление числа, указывает количество десятичных разрядов после запятой
F / fФормат дробных чисел с фиксированной точкой, указывает количество десятичных разрядов после запятой
G / gЗадает более короткий из двух форматов: F или E
N / nТакже задает формат дробных чисел с фиксированной точкой, определяет количество разрядов после запятой
P / pЗадает отображения знака процентов рядом с число, указывает количество десятичных разрядов после запятой
X / xШестнадцатеричный формат числа

Пример:

$h.amount = 23.50 ;

String.Format("{0:C}",$h.amount), результат 23.5 ₽

String.Format("{0:C2}", $h.amount), результат 23.59 ₽

String.Format("{0:d}", $h.amount) , результат 23.59

$h.amount = 23 -> String.Format("{0:f}", $h.amount) , результат 23.00

$h.amount = 23.5 -> String.Format("{0:f4}", $h.amount) , результат 23.5000

$h.amount = 23.5 -> String.Format("{0:P}", $h.amount) , результат 23 %

$h.amount = 23.5 -> String.Format("{0:P}", $h.amount) , результат 23 %