4.2.2. Строки настраиваемых числовых форматов

Описатель формата

Имя

Описание

Примеры

"0"

Знак-заместитель нуля

Заменяет ноль соответствующей цифрой, если такая имеется. В противном случае в результирующей строке будет стоять ноль.

1234.5678 ("00000") → 01235

0.45678 ("0.00", en-US) → 0.46

"#"

Заместитель цифры

Заменяет знак "#" соответствующей цифрой, если такая имеется. В противном случае в результирующей строке цифра стоять не будет.

1234.5678 ("#####") → 1235

0.45678 ("#.##", en-US) → .46

"."

Разделитель

Определяет расположение разделителя целой и дробной частей в результирующей строке.

0.45678 ("0.00", en-US) → 0.46

","

Разделитель групп и масштабиро-вание чисел

Служит в качестве описателя разделителя групп и описателя масштабирования чисел.

В качестве разделителя групп встав-ляет локализованный символ-разде-литель групп между всеми группами.

В качестве описателя масштабирова-ния чисел делит число на 1000 для всех указанных запятых.

Описатель разделителя групп:

2147483647 ("##,#", en-US) → 2,147,483,647

Описатель масштабирования:

2147483647 ("#,#,,", en-US) → 2,147

"%"

Заместитель процентов

Умножает число на 100 и вставляет локализованный символ процента в результирующую строку.

0.3697 ("%#0.00", en-US) → %36.97

0.3697 ("##.0 %", en-US) → 37.0 %

"‰"

Местозапол-нитель промилле

Умножает число на 1000 и вставляет локализованный символ промилле в результирующую строку.

0.03697 ("#0.00‰", en-US) → 36.97‰

0.03697 ("#0.00‰", ru-RU) → 36,97‰

"E0"

"E+0"

"E-0"

"e0"

"e+0"

"e-0"

Экспоненци-альная нотация

Если за этим описателем следует по меньшей мере один ноль (0), результат форматируется с использованием экспоненциальной нотации.

Регистр ("E" или "e") определяет регистр символа экспоненты в результирующей строке.

Минимальное число цифр экспоненты определяется количеством нулей, стоящих за символом "E" или "e".

Знак "+" указывает на то, что перед экспонентой всегда должен ставиться символ знака.

Знак "-" указывает на то, что символ знака должен ставиться только в случае, если экспонента имеет отрицательное значение.

987654 ("#0.0e0") → 98.8e4

1503.92311 ("0.0##e+00") → 1.504e+03

1.890138E-16 ("0.0e+00") → 1.9e-16

\

Escape-символ

Указывает на то, что следующий за ним символ должен рассматриваться как литерал, а не как описатель настраиваемого формата.

987654 ("\###00\#") → #987654#

'строка'

"строка"

Разделитель строк-литералов

Указывает на то, что заключенные в разделители символы должны быть скопированы в результирующую строку без изменений.

68 ("# ' градусов'") → 68 градусов

68 ("#' градусов'") → 68 градусов

;

Разделитель секций

Определяет секции с раздельными строками формата для положительных чисел, отрицательных чисел и нуля.

12.345 ("#0.0#;(#0.0#);-\0-") → 12.35

0 ("#0.0#;(#0.0#);-\0-") → -0-

-12.345 ("#0.0#;(#0.0#);-\0-") → (12.35)

12.345 ("#0.0#;(#0.0#)") → 12.35

0 ("#0.0#;(#0.0#)") → 0.0

-12.345 ("#0.0#;(#0.0#)") → (12.35)

Другой

Все остальные символы

Символ копируется в результирую-щую строку без изменений.

68 ("# °") → 68 °