Числовые форматы, определенные пользователем (функция Format)

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

Символ	Описание
Отсутствует.	Отображается число без форматирования.
(0)	Местозаполнитель для цифры. Отображается цифра или ноль. Если в выражении на позиции, где в строке форматирования стоит ноль, имеется цифра, то отображается цифра, в противном случае на этой позиции отображается ноль. Если в числе цифр меньше, чем нулей в выражении форматирования (с каждой стороны от разделителя), то отображаются находящиеся впереди или замыкающие нули. Если в числе цифр справа от десятичного разделителя больше, чем нулей справа от разделителя в выражении форматирования, число округляется до количества цифр, соответствующего количеству нулей. Если в числе цифр слева от десятичного разделителя больше, чем нулей слева от разделителя в выражении форматирования, лишние цифры отображаются без изменения.
(#)	Местозаполнитель для цифры. Отображается цифра или не отображается ничего. Если в выражении на позиции, где в строке форматирования стоит знак #, имеется цифра, то отображается цифра, в противном случае на этой позиции ничего не отображается. Этот символ действует так же, как местозаполнитель для цифры 0, за исключением того, что стоящие впереди или замыкающие нули не отображаются, если в числе цифр меньше, чем в выражении форматирования знаков # с каждой стороны от десятичного разделителя.
(.)	Местозаполнитель для десятичного разделителя. Местозаполнитель для десятичного разделителя определяет количество цифр, отображаемых слева и справа от десятичного разделителя. Если выражение форматирования слева от этого символа содержит только знаки #, числа меньше 1 начинаются с десятичного разделителя. Чтобы отобразить ноль, стоящий перед дробными числами, используйте ноль в качестве местозаполнителя для первой цифры слева от десятичного разделителя. В некоторых языковых и региональных стандартах в качестве десятичного разделителя используется запятая. Символ, применяемый в качестве местозаполнителя для десятичного разделителя в отформатированном выходном файле, зависит от числового формата, распознаваемого системой. Поэтому в собственных форматах следует использовать в качестве местозаполнителя для десятичного разделителя точку, даже если по региональным стандартам используется запятая. Отформатированная строка будет отображаться в соответствии с региональными стандартами.
(%)	Местозаполнитель для процентов. Умножает выражение на 100. Знак процентов (%) устанавливается на той позиции, где он отображается в строке форматирования.
(,)	Разделитель тысяч. Разделитель тысяч отделяет тысячи от сотен в числе, имеющем четыре и более цифр слева от десятичного разделителя. Разделитель тысяч обычно используется, если формат содержит разделитель тысяч, окруженный местозаполнителями для цифр (0 или #). Если разделитель тысяч стоит непосредственно слева от десятичного разделителя (независимо от того, указаны или нет десятичные знаки) или является крайним правым знаком в строке, это означает, что число следует разделить на 1 тысячу и округлить в соответствии с правилами. Числа от 500 до 1 000 отображаются как 1, а числа меньше 500 отображаются как 0. Два стоящих подряд тысячных разделителя на этой позиции означают, что число следует делить на 1 миллион, а с прибавлением каждого последующего разделителя еще раз на 1 тысячу. Если несколько разделителей стоят не слева от десятичного разделителя или не в крайней правой позиции в строке, они обрабатываются просто как один тысячный разделитель. В некоторых региональных стандартах в качестве разделителя тысяч используется точка. Символ, применяемый как тысячный разделитель в отформатированном выходном файле, зависит от числового формата, распознаваемого системой. Поэтому в собственных форматах следует использовать в качестве тысячного разделителя запятую, даже если по региональным стандартам используется точка. Отформатированная строка будет отображаться в соответствии с региональными стандартами. Рассмотрим следующие три строки форматирования: "#,0." — использует разделители тысяч для форматирования числа 100 миллионов в строку "100,000,000". "#0,." — использует деление на тысячу для форматирования числа 100 миллионов в строку "100000". "#,0,." — использует разделитель тысяч и деление на тысячу для форматирования числа 100 миллионов в строку "100,000".
(:)	Разделитель при указании времени. В некоторых региональных стандартах в качестве временного разделителя используются другие символы. Временной разделитель отделяет часы, минуты и секунды при форматировании временных значений. Символ, используемый в качестве временного разделителя в отформатированном выходном файле, определяется параметрами системы.
(/)	Разделитель при указании даты. В некоторых региональных стандартах используются другие символы для представления разделителя даты. Разделитель даты отделяет день, месяц и год при форматировании значений дат. Символ, используемый в качестве разделителя даты в отформатированном выходном файле, определяется параметрами системы.
(E-E+e-e+)	Экспоненциальный формат. Если выражение формата содержит хотя бы один местозаполнитель для цифры (0 или #) слева от E-, E+, e- или e+, число отображается в экспоненциальном формате и E или e вставляется между числом и его степенью. Число местозаполнителей для цифр слева определяет число цифр в экспоненте. Чтобы поместить знак минуса рядом с отрицательной экспонентой, следует использовать E- или e-. Чтобы поместить знак минуса рядом с отрицательной экспонентой и знак плюса рядом с положительной, следует использовать E+ или e+. Для правильного форматирования следует поместить местозаполнители для цифр справа от данного символа.
-+$ ( )	Буквенные символы. Данные символы отображаются так же, как в строке форматирования. Чтобы отобразить символ, отличающегося от перечисленных, следует поставить перед ним обратную косую черту (\) или заключить его в двойные кавычки (" ").
(\)	Отображается следующий символ в строке форматирования. Чтобы отобразить символ, обладающий в качестве буквенного знака специальным значением, следует поставить перед ним обратную косую черту (\). Сама обратная косая черта не отображается. Использование обратной косой черты аналогично заключению выводимого символа в двойные кавычки. Чтобы отобразить обратную косую черту, следует использовать ее два раза подряд (\\). В качестве буквенных символов не могут быть использованы знаки, используемые при форматировании даты и времени (a, c, d, h, m, n, p, q, s, t, w, y, / и :), числовом форматировании ((#, 0, %, E, e, запятая и точка) и форматировании строк (@, &, <, > и !).
("ABC")	Строка отображается внутри двойных кавычек (" "). Чтобы включить строку из кода в аргумент стиля, необходимо использовать Chr(34) для заключения текста в кавычки (34 — это код символа для обозначения кавычек (")).

Пример

В следующей таблице перечислены некоторые примеры выражений форматирования для чисел. (В данных примерах в качестве регионального языкового стандарта принимается параметр "Английский — США") В первом столбце содержатся строки форматирования для аргумента Style функции Format. В остальных столбцах показаны результаты, получаемые при форматировании данных со значением, указанным в заголовке столбца.

Формат (Style)	"5" форматируется как	"-5" форматируется как	"0.5" форматируется как
Zero-length string ("")	5	-5	0.5
0	5	-5	1
0.00	5.00	-5.00	0.50
#,##0	5	-5	1
$#,##0;($#,##0)	$5	($5)	$1
$#,##0.00;($#,##0.00)	$5.00	($5.00)	$0.50
0%	500%	-500%	50%
0.00%	500.00%	-500.00%	50.00%
0.00E+00	5.00E+00	-5.00E+00	5.00E-01
0.00E-00	5.00E00	-5.00E00	5.00E-01