Compartilhar via


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çãoObservaçã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.

  1. Formatos Numéricos

  2. Cadeias de caracteres de formatação numérica padrão

  3. Cadeias de caracteres de formatação numérica personalizada

  4. Formatos de Data e Hora

  5. Cadeias de caracteres padrão de formato de data e hora

  6. Cadeias de caracteres de formatação de data e hora personalizadas

  7. Formatando Guids

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çãoObservaçã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.

Hh674024.collapse_all(pt-br,VS.110).gifCadeias 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

Hh674024.collapse_all(pt-br,VS.110).gifCadeias 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 °

Hh674024.collapse_all(pt-br,VS.110).gifFormatos 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.

Hh674024.collapse_all(pt-br,VS.110).gifCadeias 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

Hh674024.collapse_all(pt-br,VS.110).gifCadeias 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

Hh674024.collapse_all(pt-br,VS.110).gifFormatando 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

Outros recursos

Dados: Informações por trás de seu aplicativo.

Tipos de formatação.