Referência: Formatos de data e o número
Você pode alterar o formato de exibição para números e datas em Visual Studio LightSwitch definindo a propriedade Format Pattern.As seções seguintes mostram a notação e as regras para essa propriedade conjuntamente com exemplos de cadeias de caracteres de formato que são normalmente usadas.
Observação |
---|
Os exemplos assumem que a propriedade Culture do aplicativo está definida como Inglês (Estados Unidos).Se você alterar a propriedade Culture no Visual Studio LightSwitch, a formatação de cultura específica será aplicada somente se for correspondente com configuração de cultura do computador local. |
Formatos Numéricos
Você pode usar cadeias de caracteres de formato numéricas para formatar os tipos de dados Decimal, Double, Integer, Long Integer e Short Integer.Uma cadeia de caracteres de formato numérica padrão assume a forma Axx, onde A é um caractere alfabético que é chamado de especificador de formato e xx é um inteiro opcional que é chamado de especificador de precisão.O especificador de precisão varia de 0 a 99 e afeta o número de dígitos no resultado.
Observação |
---|
Para o tipo de dado Decimal, o especificador de precisão não pode ser maior que o valor da propriedade de Escala especificado para o campo.Para os tipos Integer, Long Integer e Short Integer, nenhum especificador de precisão deve ser usado. |
Você também pode criar uma cadeia de caracteres de formato numérica personalizada, que consiste de um ou mais especificadores numéricos personalizados, para definir como formatar dados numéricos.Qualquer cadeia de caracteres de formato numérico que contenha mais de um caractere alfabético, incluindo espaço em branco, é interpretada como uma cadeia de caracteres de formato numérico personalizado.
Cadeias de caracteres de formatação numérica padrão
A tabela a seguir lista os especificadores de formato numérico padrão e exibe um exemplo de saída que cada cadeia de caracteres de formato produz.Para obter mais informações, consulte Cadeias de caracteres de formato numérico padrão.
Especificador de Formato |
Nome |
Valor Bruto, Tipo de Dados |
Cadeia de caracteres de Formato |
Resultado Exibido |
---|---|---|---|---|
"C" ou "c" |
Moeda |
123.456, Double 123.456, Double 123.456, Double 123, Integer |
C C2 C3 C |
$123.46 $123.46 $123.456 $123.00 |
"D" ou "d" |
Decimal |
1234, Integer 1234, Short Integer -1234, Long Integer |
D D6 D6 |
1234 001234 -001234 |
"E" ou "e" |
Exponencial (científica) |
1052.0329112756, Double -1052.0329112756, Double |
E E2 |
1.052033E+003 -1.05e+003 |
"F" ou "f" |
Ponto fixo |
1234.567, Double 1234, Decimal -1234.56, Double |
F F1 F4 |
1234.57 1234.0 -1234.5600 |
"G" ou "g" |
Geral |
-123.456, Double 123.4546, Double -1.234567890e-25, Double |
-G- G4 -G- |
-123.456 123.5 --1.23456789E-25 |
"N" ou "n" |
Número |
1234.567, Double 1234, Integer -1234.56, Double |
N N N |
1,234.57 1,234.0 -1,234.560 |
"P" ou "p" |
Porcentagem |
1, Double -0.39678, Double |
P P1 |
100.00 % -39.7 % |
"R" ou "r" |
Processamento |
123456789.12345678, Double -1234567890.12345678, Double |
R R |
123456789.12345678 -1234567890.1234567 |
"X" ou "x" |
Hexadecimal |
255, Integer -1, Integer 255, Integer -1, Integer |
X X X4 X4 |
FF ff 00ff -00FF |
Cadeias de caracteres de formatação numérica personalizada
A tabela a seguir descreve os especificadores de formato numérico personalizados e exibe um exemplo de saída que cada cadeia de caracteres de formato produz.Para obter mais informações, consulte Cadeias de caracteres de formato numérico personalizado.
Especificador de Formato |
Nome |
Valor Bruto, Tipo de Dados |
Cadeia de caracteres de Formato |
Resultado Exibido |
---|---|---|---|---|
"0" |
Espaço Reservado para Zero |
1234.5678, Double 0.45678, Double |
00000 0.00 |
01235 0.46 |
“#” |
Espaço Reservado para Dígito |
1234.5678, Double 0.45678, Double |
##### #.## |
1235 .46 |
“.” |
Ponto Decimal |
0.45678, Double |
0.00 |
0.46 |
“,” |
Separador de grupo e escala numérica |
2147483647, Integer 2147483647, Integer |
##,# #,#,, |
2,147,483,647 2,147 |
“%” |
Espaço reservado de Porcentaem |
0.3697, Double 0.3697, Double |
%#0.00 ##.0 % |
%36.97 37.0 % |
“‰” |
Espaço reservado para por milha |
0.03697, Double |
#0.00‰ |
36.97‰ |
"E0" "E+0" "E-0" "e0" "e+0" "e-0" |
Notação Exponencial |
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 |
\ |
Caractere de Escape |
987654, Integer |
\###00\# |
#987654# |
Cadeia de caracteres "Cadeia de caracteres" |
Delimitador de cadeia de caracteres literal |
68, Integer 68, Integer |
# ' graus' #” graus” |
68 graus 68 graus |
; |
Separador de Seção |
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) |
Outros |
Todos outros caracteres |
68, Integer |
# ° |
68 ° |
Formatos de Data e Hora
Você pode usar cadeias de caracteres de formato de data e hora para formatar os tipos de dados Date e Date Time.Uma cadeia de caracteres de formato padrão de data e hora usa um especificador de formato único para definir a representação do texto de um valor de data e hora.Qualquer cadeia de caracteres de formato de data e hora que contém mais de um caractere, incluindo espaço em branco, é interpretada como uma cadeia de caracteres de formato de data e hora personalizado.
Cadeias de caracteres padrão de formato de data e hora
A tabela a seguir descreve os especificadores de formato padrão de data e hora.Para obter mais informações, consulte Data padrão e seqüências de caracteres de formato de hora.
Especificador de Formato |
Descrição |
Valor Bruto (Date Time) |
Cadeia de caracteres de Formato |
Resultado Exibido |
---|---|---|---|---|
"d" |
Padrão de data abreviada. |
15 / 6/2009 1: 45: 30 PM |
d |
6/15/2009 |
"D" |
Padrão de data por extenso. |
15 / 6/2009 1: 45: 30 PM |
D |
Segunda-feira, 15 de junho de 2009 |
"f" |
Padrão completo de data/hora (tempo abreviado). |
15 / 6/2009 1: 45: 30 PM |
-F- |
Segunda-feira, 15 de junho de 2009 1:45 PM |
"F" |
Padrão completo de data/hora (tempo por extenso). |
15 / 6/2009 1: 45: 30 PM |
F |
Segunda-feira, 15 de junho de 2009 1:45:30 PM |
"g" |
Padrão geral de data/hora (tempo abreviado). |
15 / 6/2009 1: 45: 30 PM |
-g- |
15/06/2009 1:45 PM |
"G" |
Padrão geral de data/hora (tempo por extenso). |
15 / 6/2009 1: 45: 30 PM |
-G- |
15 / 6/2009 1: 45: 30 PM |
"M", "m" |
Padrão mês/dia. |
15 / 6/2009 1: 45: 30 PM |
M |
15 de Junho |
"O", "o" |
Padrão de data/hora do ciclo. |
15 / 6/2009 1: 45: 30 PM |
O |
2009-06-15T13:45:30.0900000 |
"R", "r" |
Padrão RFC1123. |
15 / 6/2009 1: 45: 30 PM |
R |
Seg, 15 de junho de 2009 20:45:30 GMT |
"s" |
Padrão de data/hora ordenável. |
15 / 6/2009 1: 45: 30 PM |
-S- |
62009-06-15T13:45:30 |
"t" |
Padrão de tempo abreviado. |
15 / 6/2009 1: 45: 30 PM |
t |
1:45 PM |
"T" |
Padrão de tempo por extenso. |
15 / 6/2009 1: 45: 30 PM |
T |
1:45:30 PM |
"u" |
Padrão classificável universal de data/hora. |
15 / 6/2009 1: 45: 30 PM |
-U |
15/06/2009 1:45:30 PM -> 2009-15-06 20:45:30Z |
"U" |
Padrão universal completo de data/hora. |
15 / 6/2009 1: 45: 30 PM |
U |
Segunda-feira, 15 de junho de 2009 8:45:30 PM |
"Y", "y" |
Padrão ano/mês. |
15 / 6/2009 1: 45: 30 PM |
Y |
Junho de 2009 |
Cadeias de caracteres de formatação de data e hora personalizadas
A tabela a seguir descreve os especificadores de formato padrão de data e hora.Para obter mais informações, consulte Data personalizada e seqüências de caracteres de formato de hora.
Especificador de Formato |
Descrição |
Valor Bruto (Date Time) |
Cadeia de caracteres de Formato |
Resultado Exibido |
---|---|---|---|---|
"d" |
O dia do mês, de 1 a 31. |
1 / 6/2009 1: 45: 30 PM 15 / 6/2009 1: 45: 30 PM |
d d |
1 15 |
"dd" |
O dia do mês, de 01 a 31. |
1 / 6/2009 1: 45: 30 PM 15 / 6/2009 1: 45: 30 PM |
dd dd |
01 15 |
"ddd" |
O nome abreviado do dia da semana. |
15 / 6/2009 1: 45: 30 PM |
ddd |
Seg |
"dddd" |
O nome completo do dia da semana. |
15 / 6/2009 1: 45: 30 PM |
dddd |
Segunda-feira |
"f" |
Os décimos de segundo em um valor de data e hora. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.050 |
-F- -F- |
6 0 |
"ff" |
Os centésimos de segundo em um valor de data e hora. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.005 |
ff ff |
61 00 |
"fff" |
Os milisegundos em um valor de data e hora. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.0005 |
fff fff |
617 000 |
"ffff" |
As dezenas de milésimos de segundo em um valor de data e hora. |
6/15/2009 13:45:30.6175 6/15/2009 13:45:30.00005 |
ffff ffff |
6175 0000 |
"fffff" |
As centenas de milésimos de segundo em um valor de data e hora. |
6/15/2009 13:45:30.61754 6/15/2009 13:45:30.000005 |
fffff fffff |
61754 00000 |
"ffffff" |
Os milionésimos de segundo em um valor de data e hora. |
6/15/2009 13:45:30.617542 6/15/2009 13:45:30.0000005 |
ffffff ffffff |
617542 000000 |
"fffffff" |
As dezenas milionésimos de segundo em um valor de data e hora. |
6/15/2009 13:45:30.6175425 6/15/2009 13:45:30.0001150 |
fffffff fffffff |
6175425 0001150 |
"F" |
Se diferente de zero, os décimos de segundo em um valor de data e hora. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.050 |
F F |
6 (sem saída) |
"FF" |
Se diferente de zero, os centésimos de segundo em um valor de data e hora. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.005 |
FF FF |
61 (sem saída) |
"FFF" |
Se diferente de zero, os milisegundos em um valor de data e hora. |
6/15/2009 13:45:30.617 6/15/2009 13:45:30.0005 |
FFF FFF |
617 (sem saída) |
"FFFF" |
Se diferente de zero, as dezenas de milésimos de segundo em um valor de data e hora. |
6/1/2009 13:45:30.5275 6/15/2009 13:45:30.00005 |
FFFF FFFF |
5275 (sem saída) |
"FFFFF" |
Se diferente de zero, as centenas de milésimos de segundo em um valor de data e hora. |
6/15/2009 13:45:30.61754 6/15/2009 13:45:30.000005 |
FFFFF FFFFF |
61754 (sem saída) |
"FFFFFF" |
Se diferente de zero, os milionésimos de segundo em um valor de data e hora. |
6/15/2009 13:45:30.617542 6/15/2009 13:45:30.0000005 |
FFFFFF FFFFFF |
617542 (sem saída) |
"FFFFFFF" |
Se diferente de zero, as dezenas de milionésimos de segundo em um valor de data e hora. |
6/15/2009 13:45:30.6175425 6/15/2009 13:45:30.0001150 |
FFFFFFF FFFFFFF |
6175425 000115 |
“g”, “gg” |
O período ou era. |
15 / 6/2009 1: 45: 30 PM |
-g- |
A.D. |
"h" |
A hora, usando um relógio de 12 horas de 1 a 12. |
15/06/2009 1:45:30 AM 15 / 6/2009 1: 45: 30 PM |
h h |
1 1 |
“hh” |
A hora, usando um relógio de 12 horas de 01 a 12. |
15/06/2009 1:45:30 AM 15 / 6/2009 1: 45: 30 PM |
hh hh |
01 01 |
"H" |
A hora, usando um relógio de 24 horas de 0 a 23. |
15/06/2009 1:45:30 AM 15 / 6/2009 1: 45: 30 PM |
H H |
1 13 |
"HH" |
A hora, usando um relógio de 24 horas de 00 a 23. |
15/06/2009 1:45:30 AM 15 / 6/2009 1: 45: 30 PM |
HH HH |
01 13 |
"m" |
O minuto, de 0 a 59. |
15/06/2009 1:09:30 AM 15 / 6/2009 1: 29: 30 PM |
m m |
9 29 |
"mm" |
O minuto, de 00 a 59. |
15/06/2009 1:09:30 AM 15 / 6/2009 1: 29: 30 PM |
mm mm |
09 29 |
“M” |
O mês, de 1 a 12. |
15 / 6/2009 1: 45: 30 PM |
M |
6 |
"MM" |
O mês, de 01 a 12. |
15 / 6/2009 1: 45: 30 PM |
MM |
06 |
"MMM" |
O nome abreviado do mês. |
15 / 6/2009 1: 45: 30 PM |
MMM |
jun |
"MMMM" |
O nome completo do mês. |
15 / 6/2009 1: 45: 30 PM |
MMMM |
Junho |
"s" |
O segundo, de 0 a 59. |
15 / 6/2009 1: 45: 09 PM |
-S- |
9 |
“ss” |
O segundo, de 00 a 59. |
15 / 6/2009 1: 45: 09 PM |
ss |
09 |
"t" |
O primeiro caractere do designador AM/PM. |
15 / 6/2009 1: 45: 30 PM |
t |
P |
“tt” |
O designador AM/PM. |
15 / 6/2009 1: 45: 30 PM |
tt |
PM |
"y" |
O ano, de 0 a 99. |
15 / 6/2009 1: 45: 30 PM |
y |
9 |
"yy" |
O ano, de 00 a 99. |
15 / 6/2009 1: 45: 30 PM |
yy |
09 |
"yyy" |
O ano, com um mínimo de três dígitos. |
1/1/0001 12:00:00 AM 15 / 6/2009 1: 45: 30 PM |
yyy yyy |
001 2009 |
"yyyy" |
O ano como um número de quatro dígitos. |
15 / 6/2009 1: 45: 30 PM |
yyyy |
2009 |
“yyyyy” |
O ano como um número de cinco dígitos. |
15 / 6/2009 1: 45: 30 PM |
yyyyy |
02009 |
"z" |
Horário deslocado do UTC, sem zeros à esquerda. |
15/06/2009 1:45:30 PM -07:00 |
z |
-7 |
"zz" |
Horário deslocado do UTC, com um zero à esquerda para um valor de um único dígito. |
15/06/2009 1:45:30 PM -07:00 |
zz |
-07 |
“zzz” |
Horas e minutos deslocados do UTC. |
15/06/2009 1:45:30 PM -07:00 |
zzz |
-07:00 |
“:” |
O separador de hora. |
15 / 6/2009 1: 45: 30 PM |
hh:mm |
01:45 |
“/” |
O separador de data. |
15 / 6/2009 1: 45: 30 PM |
MM/dd |
6/15 |
"Cadeia de caracteres" Cadeia de caracteres |
Delimitador de cadeia de caracteres literal. |
15 / 6/2009 1: 45: 30 PM 15 / 6/2009 1: 45: 30 PM |
"arr:" h:m t 'arr:' h:m t |
arr: 1:45 P arr: 1:45 P |
% |
Define o seguinte caractere como um especificador de formato personalizado. |
15 / 6/2009 1: 45: 30 PM |
%h |
1 |
\ |
O caractere de escape. |
15 / 6/2009 1: 45: 30 PM |
h \h |
1 h |
Qualquer outro caractere |
O caractere é copiado, inalterado, para a cadeia de caracteres de resultado. |
15/06/2009 1:45:30 AM |
arr hh:mm t |
arr 01:45 A |
Formatando Guids
A tabela a seguir descreve especificadores de formato para o tipo de dados do Guid.
Formato |
Descrição |
Valor Bruto (Guid) |
Cadeia de caracteres de Formato |
Resultado Exibido |
---|---|---|---|---|
N |
Exibe 32 caracteres. |
3261a3cfc18f4747b957e5264b6a430c |
N |
3261a3cfc18f4747b957e5264b6a430c |
D |
Exibe 32 caracteres separados por hífens. |
3261a3cfc18f4747b957e5264b6a430c |
D |
3261a3cf-c18f-4747-b957-e5264b6a430c |
B |
Exibe 32 caracteres entre chaves separados por hifens. |
3261a3cfc18f4747b957e5264b6a430c |
B |
{3261a3cf-c18f-4747-b957-e5264b6a430c } |
P |
Exibe 32 caracteres entre parênteses separados por hifens. |
3261a3cfc18f4747b957e5264b6a430c |
P |
(3261a3cf-c18f-4747-b957-e5264b6a430c) |
X |
Quatro valores hexadecimais colocados entre chaves, onde o quarto valor é um subconjunto de oito valores hexadecimais dentro outro conjunto de chaves. |
3261a3cfc18f4747b957e5264b6a430c |
X |
{0x3261a3cf,0xc18f,0x4747,{0xb0,0x57,0xe5,0x26,0x4b,0x6a,0x43,0x0c}} |
Consulte também
Tarefas
Como: Formatar números e datas