Справочные материалы. Форматы чисел и даты
В Visual Studio LightSwitch можно изменять формат отображения чисел и дат, задав свойство Format Pattern. В следующих разделах помимо примеров наиболее распространенных строк форматирования также показаны нотация и правила для свойства.
Примечание
В примерах предполагается, что свойство приложения Culture задано как Английский (США).При изменении свойства Culture в Visual Studio LightSwitch форматирование, зависящее от языка и региональных параметров, будет использоваться, только если этот параметр языка и региональных параметров совпадает с аналогичным параметром на локальном компьютере.
Числовые форматы
Можно использовать строки числовых форматов для форматирования типов данных Decimal, Double, Integer, Long Integer и Short Integer. Стандартная строка числового формата имеет вид Axx, где A является буквой, называемой спецификатором формата, а xx является необязательным целым числом, называемым описателем точности. Спецификатор точности находится в диапазоне от 0 до 99 и влияет на число цифр в результате.
Примечание
Для типа данных Decimal описатель точности не может быть больше значения свойства "Масштаб", которое определено для поля.Для типов Integer, Long Integer и Short Integer описатель точности не требуется.
Чтобы определить способ форматирования числовых данных, можно создать строку настраиваемого числового формата, состоящую из одного или нескольких описателей настраиваемого формата. Любая строка числового формата, содержащая более одной буквы, включая пробелы, интерпретируется как строка настраиваемого числового формата.
Строки стандартных числовых форматов
В следующей таблице приведены описатели стандартных числовых форматов и примеры выходных данных, формируемых каждым описателем формата. Дополнительные сведения см. в разделе Строки стандартных числовых форматов.
Описатель формата |
Имя |
Необработанное значение, тип данных |
Строка формата |
Отображаемый результат |
---|---|---|---|---|
"C" или "c" |
Валюта |
123.456, Double 123.456, Double 123.456, Double 123, Integer |
C C2 C3 C |
$123.46 $123.46 $123.456 $123.00 |
"D" или "d" |
Десятичный |
1234, Integer 1234, Short Integer -1234, Long Integer |
D D6 D6 |
1234 001234 -001234 |
"E" или "e" |
Экспоненциальный (научный) |
1052.0329112756, Double -1052.0329112756, Double |
E E2 |
1,052033E+003 -1,5e+003 |
"F" или "f" |
С фиксированной запятой |
1234.567, Double 1234, Decimal -1234.56, Double |
F F1 F4 |
1234.57 1234.0 -1234.5600 |
"G" или "g" |
Общие правила |
-123.456, Double 123.4546, Double -1,234567890e-25, Double |
G G4 G |
-123.456 123.5 --1,23456789E-25 |
"N" или "n" |
Числовой |
1234.567, Double 1234, Integer -1234.56, Double |
N N N |
1,234.57 1,234.0 -1,234.560 |
"P" или "p" |
Процент |
1, Double -0.39678, Double |
P P1 |
100.00 % -39.7 % |
"R" или "r" |
Приемо-передача |
123456789.12345678, Double -1234567890.12345678, Double |
R R |
123456789.12345678 -1234567890.1234567 |
"X" или "x" |
Шестнадцатеричный |
255, Integer -1, Integer 255, Integer -1, Integer |
X X X4 X4 |
FF ff 00ff -00FF |
Строки настраиваемых числовых форматов
В следующей таблице приведены описатели настраиваемых числовых форматов и примеры выходных данных, формируемых каждым описателем формата. Дополнительные сведения см. в разделе Строки настраиваемых числовых форматов.
Описатель формата |
Имя |
Необработанное значение, тип данных |
Строка формата |
Отображаемый результат |
---|---|---|---|---|
"0" |
Знак-заместитель нуля |
1234.5678, Double 0.45678, Double |
00000 0.00 |
01235 0.46 |
"#" |
Заместитель цифры |
1234.5678, Double 0.45678, Double |
##### #.## |
1235 .46 |
"." |
Разделитель |
0.45678, Double |
0.00 |
0.46 |
"," |
Разделитель групп и масштабирование чисел |
2147483647, Integer 2147483647, Integer |
##,# #,#,, |
2,147,483,647 2,147 |
"%" |
Заместитель процентов |
0.3697, Double 0.3697, Double |
%#0.00 ##.0 % |
%36.97 37.0 % |
"‰" |
Местозаполнитель промилле |
0.03697, Double |
#0.00‰ |
36.97‰ |
"E0" "E+0" "E-0" "e0" "e+0" "e-0" |
Экспоненциальная нотация |
987654, Double 1503.92311, Double 1,8901385E-16 ("0,0e+00"), Double |
#0,0e0 0,0##e+00 0,0e+00 |
98,8e4 1,504e+03 1,9e-16 |
\ |
Escape-символ |
987654, Integer |
\###00\# |
#987654# |
'string' "string" |
Разделитель строк-литералов |
68, Integer 68, Integer |
# ' degrees' #” degrees” |
68 degrees 68 degrees |
; |
Разделитель секций |
12.345, Double 0, Double -12.345, Double 12.345, Double 0, Double -12.345, Double |
#0.0#;(#0.0#);-\0- #0.0#;(#0.0#);-\0- #0.0#;(#0.0#);-\0- #0.0#;(#0.0#) #0.0#;(#0.0#) #0.0#;(#0.0#) |
12.35 -0- (12.35) 12.35 0.0 (12.35) |
Другой |
Все остальные символы |
68, Integer |
# ° |
68 ° |
Форматы даты и времени
Можно использовать строки форматирования даты и времени для форматирования типов данных Date и Date Time. Строка стандартного формата даты и времени использует один описатель формата для определения текстового представления значения даты и времени. Любая строка формата даты и времени, содержащая более одной буквы, включая пробелы, интерпретируется как строка пользовательского формата даты и времени.
Строки стандартных форматов даты и времени
В следующей таблице описаны спецификаторы стандартных форматов даты и времени. Дополнительные сведения см. в разделе Строки стандартных форматов даты и времени.
Описатель формата |
Описание |
Необработанное значение (Date Time) |
Строка формата |
Отображаемый результат |
---|---|---|---|---|
"d" |
Короткий шаблон даты. |
15. 06. 2009 13:45:30 |
d |
6/15/2009 |
"D" |
Полный шаблон даты. |
15. 06. 2009 13:45:30 |
D |
Понедельник, 15 июня 2009 г. |
"f" |
Полный шаблон даты и времени (короткий шаблон времени). |
15. 06. 2009 13:45:30 |
f |
Понедельник, 15 июня 2009 г., 13:45 |
"F" |
Полный шаблон даты и времени (полный шаблон времени). |
15. 06. 2009 13:45:30 |
F |
Понедельник, 15 июня 2009 г., 13:45:30 |
"g" |
Общий шаблон даты и времени (короткий шаблон времени). |
15. 06. 2009 13:45:30 |
g |
15 июня 2009 г. 13:45 |
"G" |
Общий шаблон даты и времени (полный шаблон времени). |
15. 06. 2009 13:45:30 |
G |
15. 06. 2009 13:45:30 |
"M", "m" |
Шаблон дней месяца. |
15. 06. 2009 13:45:30 |
M |
Июнь 15 г. |
"O", "o" |
Шаблон обратного преобразования даты и времени. |
15. 06. 2009 13:45:30 |
O |
2009-06-15T13:45:30.0900000 |
"R", "r" |
Шаблон RFC1123. |
15. 06. 2009 13:45:30 |
R |
Понедельник, 15 июня 2009 г. 20:45:40 GMT |
"s" |
Сортируемый шаблон времени и даты. |
15. 06. 2009 13:45:30 |
s |
62009-06-15T13:45:30 |
"t" |
Короткий шаблон времени. |
15. 06. 2009 13:45:30 |
t |
13:45 |
"T" |
Полный шаблон времени. |
15. 06. 2009 13:45:30 |
T |
13:45:30 |
"u" |
Универсальный сортируемый шаблон времени и даты. |
15. 06. 2009 13:45:30 |
u |
15.06.2009 13:45:30 -> 2009-06-15 20:45:30Z |
"U" |
Универсальный полный шаблон даты и времени. |
15. 06. 2009 13:45:30 |
U |
Понедельник, 15 июня 2009 г. 20:45:30 |
"Y", "y" |
Шаблон года и месяца. |
15. 06. 2009 13:45:30 |
Y |
Июнь 2009 г. |
Строки настраиваемых форматов даты и времени
В следующей таблице представлены описатели настраиваемых форматов даты и времени. Дополнительные сведения см. в разделе Строки настраиваемых форматов даты и времени.
Описатель формата |
Описание |
Необработанное значение (Date Time) |
Строка формата |
Отображаемый результат |
---|---|---|---|---|
"d" |
День месяца, в диапазоне от 1 до 31. |
01.06.2009 13:45:30 15. 06. 2009 13:45:30 |
d d |
1 15 |
"dd" |
День месяца, в диапазоне от 01 до 31. |
01.06.2009 13:45:30 15. 06. 2009 13:45:30 |
dd dd |
01 15 |
"ddd" |
Сокращенное название дня недели. |
15. 06. 2009 13:45:30 |
ddd |
Пнд |
"dddd" |
Полное название дня недели. |
15. 06. 2009 13:45:30 |
dddd |
Понедельник |
"f" |
Десятые доли секунды в значении даты и времени. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.050 |
f f |
6 0 |
"ff" |
Сотые доли секунды в значении даты и времени. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.005 |
ff ff |
61 00 |
"fff" |
Тысячные доли секунды в значении даты и времени. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.0005 |
fff fff |
617 000 |
"ffff" |
Десятитысячные доли секунды в значении даты и времени. |
6/15/2009 13:45:30.6175 6/15/2009 13:45:30.00005 |
ffff ffff |
6175 0000 |
"fffff" |
Стотысячные доли секунды в значении даты и времени. |
6/15/2009 13:45:30.61754 6/15/2009 13:45:30.000005 |
fffff fffff |
61754 00000 |
"ffffff" |
Миллионные доли секунды в значении даты и времени. |
6/15/2009 13:45:30.617542 6/15/2009 13:45:30.0000005 |
ffffff ffffff |
617542 000000 |
"дсссссс" |
Десятимиллионные доли секунды в значении даты и времени. |
6/15/2009 13:45:30.6175425 6/15/2009 13:45:30.0001150 |
fffffff fffffff |
6175425 0001150 |
"F" |
Если ненулевое значение, то десятые доли секунды в значении даты и времени. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.050 |
F F |
6 (без выходных данных) |
"FF" |
Если ненулевое значение, то сотые доли секунды в значении даты и времени. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.005 |
FF FF |
61 (без выходных данных) |
"FFF" |
Если ненулевое значение, то тысячные доли секунды в значении даты и времени. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.0005 |
FFF FFF |
617 (без выходных данных) |
"FFFF" |
Если ненулевое значение, то десятитысячные доли секунды в значении даты и времени. |
6/1/2009 13:45:30.5275 6/15/2009 13:45:30.00005 |
FFFF FFFF |
5275 (без выходных данных) |
"FFFFF" |
Если ненулевое значение, то стотысячные доли секунды в значении даты и времени. |
6/15/2009 13:45:30.61754 6/15/2009 13:45:30.000005 |
FFFFF FFFFF |
61754 (без выходных данных) |
"FFFFFF" |
Если ненулевое значение, то миллионные доли секунды в значении даты и времени. |
6/15/2009 13:45:30.617542 6/15/2009 13:45:30.0000005 |
FFFFFF FFFFFF |
617542 (без выходных данных) |
"FFFFFFF" |
Если ненулевое значение, то десятимиллионные доли секунды в значении даты и времени. |
6/15/2009 13:45:30.6175425 6/15/2009 13:45:30.0001150 |
FFFFFFF FFFFFFF |
6175425 000115 |
"g", "gg" |
Период или эра. |
15. 06. 2009 13:45:30 |
g |
н. э. |
"h" |
Час в 12-часовом формате от 1 до 12. |
15.06.2009 01:45:30 15. 06. 2009 13:45:30 |
h h |
1 1 |
"чч" |
Час в 12-часовом формате от 01 до 12. |
15.06.2009 01:45:30 15. 06. 2009 13:45:30 |
hh hh |
01 01 |
"H" |
Час в 24-часовом формате от 0 до 23. |
15.06.2009 01:45:30 15. 06. 2009 13:45:30 |
H H |
1 13 |
"HH" |
Час в 24-часовом формате от 00 до 23. |
15.06.2009 01:45:30 15. 06. 2009 13:45:30 |
ЧЧ ЧЧ |
01 13 |
"m" |
Минуты, в диапазоне от 0 до 59. |
15.06.2009 01:09:30 15.06.2009 13:29:30 |
m m |
9 29 |
"мм" |
Минуты, в диапазоне от 00 до 59. |
15.06.2009 01:09:30 15.06.2009 13:29:30 |
mm mm |
09 29 |
"M" |
Месяц, в диапазоне от 1 до 12. |
15. 06. 2009 13:45:30 |
M |
6 |
"MM" |
Месяц, в диапазоне от 01 до 12. |
15. 06. 2009 13:45:30 |
ММ |
06 |
"MMM" |
Сокращенное название месяца. |
15. 06. 2009 13:45:30 |
МММ: |
Июнь |
"MMMM" |
Полное название месяца. |
15. 06. 2009 13:45:30 |
ММММ: |
Июнь |
"s" |
Секунды, в диапазоне от 0 до 59. |
15.06.2009 13:45:09 |
s |
9 |
"сс" |
Секунды, в диапазоне от 00 до 59. |
15.06.2009 13:45:09 |
ss |
09 |
"t" |
Первый символ указателя AM/PM (до полудня/после полудня). |
15. 06. 2009 13:45:30 |
t |
P |
"tt" |
Указатель AM/PM (до полудня/после полудня). |
15. 06. 2009 13:45:30 |
tt |
по полудню |
"y" |
Год, в диапазоне от 0 до 99. |
15. 06. 2009 13:45:30 |
y |
9 |
"yy" |
Год, в диапазоне от 00 до 99. |
15. 06. 2009 13:45:30 |
yy |
09 |
"yyy" |
Год в виде как минимум трех цифр. |
01.01.0001 12:00:00 15. 06. 2009 13:45:30 |
ггг ггг |
001 2009 |
"yyyy" |
Год в виде четырехзначного числа. |
15. 06. 2009 13:45:30 |
yyyy |
2009 |
"yyyyy" |
Год в виде пятизначного числа. |
15. 06. 2009 13:45:30 |
ггггг |
02009 |
"z" |
Часовой сдвиг от времени в формате UTC (универсального времени), без нулей в начале. |
15.06.2009 13:45:30-07:00 |
z |
-7 |
"zz" |
Часовой сдвиг от времени в формате UTC (универсального времени) с нулями в начале для значений из одной цифры. |
15.06.2009 13:45:30-07:00 |
zz |
-07 |
"zzz" |
Сдвиг в часах и минутах от времени в формате UTC (универсального времени). |
15.06.2009 13:45:30-07:00 |
zzz |
-07:00 |
":" |
Разделитель компонентов времени. |
15. 06. 2009 13:45:30 |
чч:мм |
01:45 |
"/" |
Разделитель компонентов даты. |
15. 06. 2009 13:45:30 |
ММ/дд |
6/15 |
"string" 'string' |
Буквенный разделитель строк. |
15. 06. 2009 13:45:30 15. 06. 2009 13:45:30 |
"arr:" ч:м t 'arr:' ч:м t |
arr: 13:45 arr: 13:45 |
% |
Задает следующий символ в качестве настраиваемого описателя формата. |
15. 06. 2009 13:45:30 |
%ч |
1 |
\ |
Escape-символ. |
15. 06. 2009 13:45:30 |
ч \ч |
1 ч |
Любой другой знак |
Символ копируется в результирующую строку без изменений. |
15.06.2009 01:45:30 |
arr чч:мм t |
arr 01:45 |
Форматирование GUID
В следующей таблице приведены спецификаторы формата для типа данных глобальных уникальных идентификаторов (GUID).
Формат |
Описание |
Необработанное значение (Guid) |
Строка формата |
Отображаемый результат |
---|---|---|---|---|
N |
Отображает 32 символа. |
3261a3cfc18f4747b957e5264b6a430c |
N |
3261a3cfc18f4747b957e5264b6a430c |
D |
Отображает 32 символа, разделенные дефисами. |
3261a3cfc18f4747b957e5264b6a430c |
D |
3261a3cf-c18f-4747-b957-e5264b6a430c |
B |
Отображает 32 символа, разделенные дефисами и заключенные в фигурные скобки. |
3261a3cfc18f4747b957e5264b6a430c |
B |
{3261a3cf-c18f-4747-b957-e5264b6a430c } |
P |
Отображает 32 символа, разделенные дефисами и заключенные в круглые скобки. |
3261a3cfc18f4747b957e5264b6a430c |
P |
(3261a3cf-c18f-4747-b957-e5264b6a430c) |
X |
Четыре шестнадцатеричных значения, заключенных в фигурные скобки, где четвертое значение — подмножество из восьми шестнадцатеричных значений, также заключенных в фигурные скобки. |
3261a3cfc18f4747b957e5264b6a430c |
X |
{0x3261a3cf,0xc18f,0x4747,{0xb0,0x57,0xe5,0x26,0x4b,0x6a,0x43,0x0c}} |
См. также
Задачи
Практическое руководство. Форматирование чисел и дат в приложении LightSwitch