Форматирование
Format
| Функция | Параметры | Возвращаемое значение |
|---|---|---|
Format |
string format, params object[] args |
string |
Заменяет каждый элемент формата в указанной строке format значением соответствующего параметра в массиве args.
Например, следующий вызов функции:
Format("Name = {0}, hours = {1:hh}", myName, DateTime.Now)
содержит элементы формата {0} и {1:hh}. Они заменяются значениями myName и DateTime.Now. Результат может выглядеть так:
Name = Alex, hours = 12
Элемент формата имеет следующий синтаксис:
{index[,alignment][:formatString]}
где
index- обязательный номер значения, которое будет подставлено в это место строки;alignment- необязательная ширина форматированного значения;formatString- необязательный спецификатор формата.
Для форматирования числовых значений используются следующие стандартные символы-спецификаторы:
| Символ | Тип | Описание |
|---|---|---|
| C или c | Валюта | Число преобразуется в строку, представляющую денежные единицы. Format("{0:C}", 10) = "10,00 ₽" |
| D или d | Десятичное число | Этот формат доступен только для целых типов. Число преобразуется в строку, состоящую из десятичных цифр (0-9).Format("{0:D}", 10) = "10" |
| E или e | Научный | Число преобразуется в строку вида -d.ddd…E+ddd или -d.ddd…e+ddd, где знак d представляет цифру (0-9).Format("{0:E}", 10) = "1,000000E+001" |
| F или f | Фиксированная запятая | Число преобразуется в строку вида -ddd.ddd…, где знак d представляет цифру (0-9).Format("{0:F}", 10) = "10,00" |
| G или g | Общий | Число преобразуется в наиболее короткую запись.Format("{0:G}", 10) = "10" |
| N или n | Число | Число преобразуется в строку вида -d,ddd,ddd.ddd…, где знак d - цифра (0-9), знак , - разделитель тысяч, а знак . - разделитель целой и дробной части.Format("{0:N}", 1234.56) = "1 234,56" |
| P или p | Процент | Число преобразуется в строку, представляющую проценты. Преобразуемое число умножается на 100, чтобы соответствовать процентам.Format("{0:P}", 0.15) = "15,00%" |
| X или x | Шестнадцатеричный | Этот формат доступен только для целых типов. Число преобразуется в строку шестнадцатеричных знаков. Регистр шестнадцатеричных знаков, превосходящих 9, совпадает с регистром указателя формата.Format("{0:X}", 26) = "1A" |
После символа-спецификатора формата можно указать число. Для чисел с плавающей запятой это будет означать количество знаков после запятой в форматированном значении:
Format("{0:C1}", 12.23) = "12,2 ₽"
Если стандартных средств форматирования чисел недостаточно, можно использовать символы настраиваемого числового формата:
| Символ | Описание |
|---|---|
| 0 | Знак-заменитель нуля. Если форматируемое значение содержит цифру в этой позиции, она копируется в выходную строку. В противном случае 0 отображается в выходной строке. |
| # | Заместитель цифры. Если форматируемое значение содержит цифру в этой позиции, она копируется в выходную строку. В противном случае в выходной строке ничего не записывается. |
| . | Разделитель дроби. Первый знак . в строке формата определяет положение разделителя дроби. |
| , | Разделитель числовых разрядов. Знак , в строке формата определяет положение разделителя групп разрядов. |
| % | Заместитель процентов. При использовании знака % в строке форматирования число будет умножено на 100, и в соответствующую позицию в выходной строке будет вставлен символ %. |
| ; | Разделитель секций. Знак ; служит для разделения секций положительных, отрицательных и нулевых чисел в строке формата. |
Примеры использования:
Format("{0:#,##0.00 ₽}", 1024.25) = "1 024,25 ₽"
Format("{0:00%}", 0.25) = "25%"
Format("{0:#,##0.00 ₽;(#,##0.00 ₽);Zero}", 1024.25) = "1 024,25 ₽"
Format("{0:#,##0.00 ₽;(#,##0.00 ₽);Zero}", -1024.25) = "(1 024,25 ₽)"
Format("{0:#,##0.00 ₽;(#,##0.00 ₽);Zero}", 0) = "Zero"
Для форматирования даты/времени используются следующие стандартные символы-спецификаторы:
| Символ | Тип | Пример |
|---|---|---|
| d | Короткий шаблон даты | "02.04.2024" |
| D | Полный шаблон даты | "2 апреля 2024 г." |
| f | Полный шаблон даты и времени (короткий шаблон времени) | "2 апреля 2024 г. 20:41" |
| F | Полный шаблон даты и времени (полный шаблон времени) | "2 апреля 2024 г. 20:41:33" |
| g | Общий шаблон даты и времени (короткий шаблон времени) | "02.04.2024 20:41" |
| G | Общий шаблон даты и времени (полный шаблон времени) | "02.04.2024 20:41:33" |
| t | Короткий шаблон времени | "20:41" |
| T | Полный шаблон времени | "20:41:33" |
Так же можно использовать символы настраиваемого формата даты/времени:
| Символ | Описание |
|---|---|
| d | Представляет день месяца в виде числа от 1 до 31. Одноразрядные числа форматируются без нуля в начале. |
| dd | Представляет день месяца в виде числа от 01 до 31. |
| ddd | Представляет сокращенное название дня недели. |
| dddd | Представляет полное название дня недели. |
| f или F | Представляет миллисекунды. |
| h | Представляет часы числом от 1 до 12. Одноразрядные числа форматируются без нуля в начале. |
| hh | Представляет часы числом от 01 до 12. |
| H | Представляет часы числом от 0 до 23. Одноразрядные числа форматируются без нуля в начале. |
| HH | Представляет часы числом от 00 до 23. |
| m | Представляет минуты как число от 0 до 59. Одноразрядные числа форматируются без нуля в начале. |
| mm | Представляет минуты как число от 00 до 59. |
| M | Представляет месяц как число от 1 до 12. Одноразрядные числа форматируются без нуля в начале. |
| MM | Представляет месяц как число от 01 до 12. |
| MMM | Представляет сокращенное название месяца. |
| MMMM | Представляет полное название месяца. |
| s | Представляет секунды как число от 0 до 59. Одноразрядные числа форматируются без нуля в начале. |
| ss | Представляет секунды как число от 00 до 59. |
| y | Представляет год как число из одной или двух цифр. |
| yy | Представляет год как число из двух цифр. |
| yyyy | Представляет год как число из четырех цифр. |
| : | Представляет стандартный разделитель времени. |
| / | Представляет стандартный разделитель даты. |
Примеры использования:
Format("{0:d MMM yyyy}", DateTime.Now) = "2 апр 2024"
Format("{0:dd/MM/yyyy}", DateTime.Now) = "02.04.2024"
Format("{0:d MMMM}", DateTime.Now) = "2 апреля"
Format("{0:HH:mm}", DateTime.Now) = "20:41"
Format("{0:dd/MM/yyyy HH:mm}", DateTime.Now) = "02.04.2024 20:41"
FormatCurrency
| Функция | Параметры | Возвращаемое значение |
|---|---|---|
FormatCurrency |
object value |
string |
Форматирует значение value как валюту, используя региональные установки Windows.
Пример:
FormatCurrency(1.25) = "1,25 ₽"
| Функция | Параметры | Возвращаемое значение |
|---|---|---|
FormatCurrency |
object value, int decimalDigits |
string |
Форматирует значение value как валюту, округляя результат до количества знаков после запятой decimalDigits.
Пример:
FormatCurrency(1.25, 1) = "1,3 ₽"
FormatDateTime
| Функция | Параметры | Возвращаемое значение |
|---|---|---|
FormatDateTime |
DateTime value |
string |
Форматирует значение value как дату/время. Данная функция не возвращает дату или время, если соответствующие части имеют пустые значения. Пустой датой считается дата 1/1/1, пустым временем - 0:00:00.
Пример:
FormatDateTime(new DateTime(2024,4,2)) = "02.04.2024"
FormatDateTime(new DateTime(2024,4,2,1,30,0)) = "02.04.2024 1:30:00"
FormatDateTime(new DateTime(1,1,1,1,30,1)) = "1:30:01"
| Функция | Параметры | Возвращаемое значение |
|---|---|---|
FormatDateTime |
DateTime value, string format |
string |
Форматирует значение value как дату/время, используя именованный формат format. Допустимые значения для параметра format:
- Long Date;
- Short Date;
- Long Time;
- Short Time.
Пример:
FormatDateTime(new DateTime(2024,4,2,1,30,0), "Long Date") = "2 апреля 2024 г."
FormatDateTime(new DateTime(2024,4,2), "Short Date") = "02.04.2024"
FormatDateTime(new DateTime(1,1,1,1,30,1), "Long Time") = "1:30:01"
FormatDateTime(new DateTime(1,1,1,1,30,1), "Short Time") = "01:30"
FormatNumber
| Функция | Параметры | Возвращаемое значение |
|---|---|---|
FormatNumber |
object value |
string |
Форматирует значение value как число, используя региональные установки Windows.
Пример:
FormatNumber(1234.56) = "1 234,56"
| Функция | Параметры | Возвращаемое значение |
|---|---|---|
FormatNumber |
object value, int decimalDigits |
string |
Форматирует значение value как число, округляя результат до количества знаков после запятой decimalDigits.
Пример:
FormatNumber(1234.56, 1) = "1 234,6"
FormatPercent
| Функция | Параметры | Возвращаемое значение |
|---|---|---|
FormatPercent |
object value |
string |
Форматирует значение value как процент, используя региональные установки Windows.
Пример:
FormatPercent(0.15) = "15,00%"
| Функция | Параметры | Возвращаемое значение |
|---|---|---|
FormatPercent |
object value, int decimalDigits |
string |
Форматирует значение value как процент, округляя результат до количества знаков после запятой decimalDigits.
Пример:
FormatPercent(0.15, 0) = "15%"