Mudanças entre as edições de "Formatação de Valores"

De LATROMI Manuais
Ir para: navegação, pesquisa
(→‎Data)
(→‎Ver Também)
 
(31 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 5: Linha 5:
 
* Marcações no Título de Consultas.
 
* Marcações no Título de Consultas.
 
* Marcações nas mensagens disparadas nos Procedimentos.
 
* Marcações nas mensagens disparadas nos Procedimentos.
 +
  
 
== Formatos ==
 
== Formatos ==
 
Cada tipo de dados oferece suporte a um conjuntos diferente de formatos. Neste tópico serão listados os formatos mais utilizados para cada tipo. Se necessário, você pode criar seu próprio formato, usando as regras da [https://docs.microsoft.com/dotnet/standard/base-types/composite-formatting Formatação Composta] do Microsoft .NET.
 
Cada tipo de dados oferece suporte a um conjuntos diferente de formatos. Neste tópico serão listados os formatos mais utilizados para cada tipo. Se necessário, você pode criar seu próprio formato, usando as regras da [https://docs.microsoft.com/dotnet/standard/base-types/composite-formatting Formatação Composta] do Microsoft .NET.
 +
 +
O resultado de alguns formatos pode sofrer alterações de acordo com o idioma utilizado para exibição. Por exemplo, o número 1.99 formatado com '''{0:C}''' resultaria em R$1,99 no Brasil, mas nos EUA seria $1.99.
  
 
=== Números ===
 
=== Números ===
−
{| class="wikitable" width="100%"  
+
{| class="wikitable formattable"
−
|-
+
|-------------------------------------------
−
! Formatador
+
! Especificador
−
! Descrição
+
! Descrição  
−
! Exemplo
+
! Valor
 +
! Formato
 +
! Resultado
 +
|-------------------------------------------
 +
| C
 +
| Mostra o número no formato de moeda corrente. Você pode especificar o número de dígitos das casas decimais.
 +
Para saber mais: [https://docs.microsoft.com/dotnet/standard/base-types/standard-numeric-format-strings#CFormatString especificador de formato de moeda ("C")].
 +
| 1234.567
 +
| {0:C}
 +
{0:C2}
 +
| R$ 1.234,5699
 +
R$ 1.234,56
 +
|-------------------------------------------
 +
| D
 +
| O especificador de formato “D” (ou decimal) converte um número em uma cadeia de caracteres de dígitos decimais (0-9), prefixados por um sinal de negativo se o número for negativo. Esse formato é compatível apenas com tipos inteiros.
 +
Para saber mais: [https://docs.microsoft.com/pt-br/dotnet/standard/base-types/standard-numeric-format-strings#DFormatString especificador de formato decimal ("D")].
 +
|1234
 +
|{0:D}
 +
{0:D6}
 +
| 1234
 +
001234
 +
|-------------------------------------------
 +
| N
 +
| Mostra o número no formato numérico, incluindo o grupo separador de milhar. Você pode especificar o número de dígitos das casas decimais.
 +
Para saber mais: [https://docs.microsoft.com/pt-br/dotnet/standard/base-types/standard-numeric-format-strings#NFormatString especificador de formato numérico ("N")].
 +
| 1234.567
 +
|{0:N}
 +
{0:N4}
 +
| 1.234
 +
1.234,5670
 +
|-------------------------------------------
 +
| P
 +
| Mostra o número no formato percentual. Você pode especificar o número de dígitos das casas decimais.
 +
Para saber mais: [https://docs.microsoft.com/pt-br/dotnet/standard/base-types/standard-numeric-format-strings#PFormatStringespecificador de formato de porcentagem ("P")].
 +
| 1
 +
3.3333
 +
|{0:P}
 +
{0:P1}
 +
| 100%
 +
3,3%
 
|-
 
|-
−
|style="width: 40px; text-align: center;"| C
 
−
|Mostra o número no formato de moeda corrente. Você pode especificar o número de dígitos das casas decimais.
 
−
|style="max-width: 280px;" | Formato: '''{0:C}''' = 1234.567 -> R$1.234,56
 
−
Formato: '''{0:C3}''' = 1234.567 -> R$1.234,567
 
−
|-
 
−
|style="text-align: center;"|D
 
−
| Mostra o número em formato decimal. Você pode especificar o número de dígitos.
 
−
|Formato: '''{0:D}''' = 1234 -> 1234
 
−
Formato: '''{0:D6}''' = 1234 -> 001234
 
−
|-
 
−
|style="text-align: center;"|N
 
−
| Mostra o número no formato numérico, incluindo o grupo separador de milhar. Você pode especificar o número de dígitos das casas decimais.
 
−
|Formato: '''{0:N}''' = 1234,567 -> 1.234,57
 
−
Formato: '''{0:N4}''' = 1234,567 -> 1.234,5670
 
−
|-
 
−
|style="text-align: center;"|P
 
−
| Mostra o número no formato percentual. Você pode especificar o número de dígitos das casas decimais.
 
−
|Formato: '''{0:P}''' = 1 -> 100.00%
 
−
Formato: '''{0:P1}''' = 0,54 -> 54.0%
 
−
|-
 
 
|
 
|
−
| Mostrando o número no formato do CPF. Adicionando zeros antes quando precisar.
+
| Mostrando o número no formato do '''CPF'''. Adicionando zeros antes quando precisar.
−
|Formato: '''{0:000\.###\.###-##}''' = <BR> 122233344 -> 001.222.333-44
+
| 12233344
 +
| {0:000\.###\.###-##}
 +
| 001.222.333-44
 
|-
 
|-
 
|
 
|
−
| Mostrando o número no formato do Telefone, adicionando o zero antes do DDD.
+
| Mostrando o número no formato do '''Telefone''', adicionando o zero antes do DDD.
−
|Formato: '''{0:\(0##\) #####-####}''' = 51999001122 -> (051) 99900-1122
+
| 51999001122
−
|-
+
| {0:\(0##\) # ####-####}
 +
| (051) 9 9900-1122
 
|}
 
|}
  
−
=== Data ===
+
=== Datas ===
−
{| class="wikitable" width="100%"
+
{| class="wikitable formattable"
−
|-
+
|-------------------------------------------
−
!Formatador
+
! Especificador
−
!Descrição
+
! Descrição  
−
!Exemplo
+
! Valor
−
|-
+
! Formato
−
|style="width: 40px;" align="center"| d
+
! Resultado
−
|Mostra a data no formato curto.
+
|-------------------------------------------
−
|style="width: 280px;" | Formato: '''{0:d}''' = 14/03/2008 11:45:14 -> 14/03/2008
+
| d
−
|-  
+
| Mostra a data no formato curto
−
|style="text-align: center;"|D
+
| 2008-03-14 11:45:14
 +
| {0:d}
 +
| 14/03/2018
 +
|-------------------------------------------
 +
| D
 
| Mostra a data no formato completo.
 
| Mostra a data no formato completo.
−
|Formato: '''{0:D}''' = 14/03/2008 11:45:14 -> sexta-feira, 14 de março de 2008
+
| 2008-03-14 11:45:14
−
|-  
+
| {0:D}
−
|style="text-align: center;"|f
+
| sexta-feira, 14 de março de 2008
 +
|-------------------------------------------
 +
| f
 
| Mostra a data no formato completo e a hora no formato curto.
 
| Mostra a data no formato completo e a hora no formato curto.
−
|Formato: '''{0:f}''' = 14/03/2008 11:45:14 -> sexta-feira, 14 de março de 2008 11:45
+
| 2008-03-14 11:45:14
−
|-
+
| {0:f}
−
|style="text-align: center;"|F
+
| sexta-feira, 14 de março de 2008 11:45
−
| Mostra a data no formato completo e a hora no formato completo.  
+
|-------------------------------------------
−
|Formato: '''{0:F}''' = 14/03/2008 11:45:14 -> sexta-feira, 14 de março de 2008 11:45:14
+
| F
−
|-
+
| Mostra a data no formato completo e a hora no formato completo.
−
|style="text-align: center;"|g
+
| 2008-03-14 11:45:14
−
| Mostra a data no formato curto e a hora no formato curto
+
| {0:F}
−
|Formato: '''{0:g}''' = 14/03/2008 11:45:14 -> sexta-feira, 14 de março de 2008 11:45
+
| sexta-feira, 14 de março de 2008 11:45:14
−
|-
+
|-------------------------------------------
−
|style="text-align: center;"|G
+
| g
 +
| Mostra a data no formato curto e a hora no formato curto.
 +
| 2008-03-14 11:45:14
 +
| {0:g}
 +
| 14/03/2008 11:45
 +
|-------------------------------------------
 +
| G
 
| Mostra a data no formato curto e a hora no formato completo
 
| Mostra a data no formato curto e a hora no formato completo
−
|Formato: '''{0:G}''' = 14/03/2008 11:45:14 -> sexta-feira, 14 de março de 2008 11:45:14
+
| 2008-03-14 11:45:14
−
|-
+
| {0:G}
−
|style="text-align: center;"|t
+
| 14/03/2008 11:45:14
 +
|-------------------------------------------
 +
| t
 
| Mostra a hora no formato curto
 
| Mostra a hora no formato curto
−
|Formato: '''{0:t}''' = 14/03/2008 11:45:14 -> 11:45
+
| 2008-03-14 11:45:14
−
|-
+
| {0:t}
−
|style="text-align: center;"|T
+
| 11:45
 +
|-------------------------------------------
 +
| T
 
| Mostra a hora no formato completo
 
| Mostra a hora no formato completo
−
|Formato: '''{0:T}''' = 14/03/2008 11:45:14 -> 11:45:14
+
| 2008-03-14 11:45:14
−
|-
+
| {0:T}
−
|style="text-align: center;"|M
+
| 11:45:14
 +
|-------------------------------------------
 +
| M
 
| Mostra a data no formato dia e mês
 
| Mostra a data no formato dia e mês
−
|Formato: '''{0:M}''' = 14/03/2008 11:45:14 -> 14 de março
+
| 2008-03-14 11:45:14
−
|-
+
| {0:M}
−
|style="text-align: center;"|Y
+
| 14 de março
 +
|-------------------------------------------
 +
| Y
 
| Mostra a data no formato mês e ano
 
| Mostra a data no formato mês e ano
−
|Formato: '''{0:Y}''' = 14/03/2008 11:45:14 -> março de 2008
+
| 2008-03-14 11:45:14
−
|-
+
| {0:Y}
−
|
+
| março de 2008
 +
|-------------------------------------------
 +
|  
 
| Mostra a data conforme configuração:
 
| Mostra a data conforme configuração:
 +
| 2008-03-14 11:45:14
 +
| {0:dd/MM/yyyy} <br>{0:dd/MM/yy} <br>{0:dd/MMM/yyyy} <br>{0:yyyy/MM/dd} <br>{0:dd/MMMM/yyyy} <br>{0:dd/MM/yyyy HH:mm}
 +
| 14/03/2008 <br>14/03/08 <br>14/mar/2008 <br>2008/03/14 <br>14/março/2008 <br>14/03/2008 11:45
 +
|}
 +
 +
=== Intervalos ===
 +
Um Intervalo é o resultado da diferença entre duas datas, equivalente ao tipo System.TimeSpan do Microsoft .NET.
 +
 +
Por exemplo <code>“01/01/2018 12:0” - “01/01/2018 00:00” = 12 horas (ou 43200000 ms)</code>
 +
 +
{| class="wikitable formattable"
 +
! Especificador
 +
! Descrição
 +
! Valor
 +
! Formato
 +
! Resultado
 +
|-------------------------------------------
 +
| c
 +
| Formato Constante (invariável). Ele assume o formato <br><code>[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]</code>
 +
Mais informações: [https://docs.microsoft.com/dotnet/standard/base-types/standard-timespan-format-strings#the-constant-c-format-specifier o especificador de formato de constante ("c")].
 +
| 1000000 ms
 +
| {0:c}
 +
| 00:16:40
 +
|-------------------------------------------
 +
| g
 +
| Formato curto geral. Esse especificador gera apenas o que é necessário. Ele assume o formato <br><code>[-][d’:’]h’:’mm’:’ss[.FFFFFFF]</code>
 +
Mais informações: [https://docs.microsoft.com/dotnet/standard/base-types/standard-timespan-format-strings#GeneralShort o especificador de formato curto geral ("g")].
 +
| 1000000 ms
 +
| {0:g}
 +
| 0:16:40
 +
|-------------------------------------------
 +
| G
 +
| Esse especificador sempre gera dias e sete dígitos de fração. Ele assume o formato <br><code>[-]d’:’hh’:’mm’:’ss.fffffff</code>.
 +
Mais informações: [https://docs.microsoft.com/pt-br/dotnet/standard/base-types/standard-timespan-format-strings#GeneralLong o especificador de formato longo geral ("G")].
 +
| 1000000 ms
 +
| {0:G}
 +
| 0:00:16:40,0000000
 +
|-------------------------------------------
 
|
 
|
−
*Formato: '''{0:dd/MM/yyyy}''' = 14/03/2008 11:45:14 -> 14/03/2008
+
| Exemplos de Formatações Customizadas
−
*Formato: '''{0:dd/MM/yy}''' = 14/03/2008 11:45:14 -> 14/03/08
+
| 1000000 ms
−
*Formato:  '''{0:dd/MMM/yyyy}''' = 14/03/2008 11:45:14 -> 14/mar/2008
+
| {0:h':'mm} <br>{0:hh':'mm} <br>{0:mm} minuto(s)
−
*Formato:  '''{0:yyyy/MM/dd}''' = 14/03/2008 11:45:14 -> 2008/03/14
+
| 0:16 <br>00:16 <br>16 minutos
−
*Formato:  '''{0:dd/MMMM/yyyy}''' = 14/03/2008 11:45:14 -> 14/março/2008
 
−
*Formato: '''{0:dd/MM/yyyy HH:mm}''' = 14/03/2008 11:45:14 -> 14/03/2008 11:45
 
−
|-
 
 
|}
 
|}
 +
 +
== Referências ==
 +
* [https://docs.microsoft.com/dotnet/standard/base-types/composite-formatting Formatação Composta do Microsoft .NET]

Edição atual tal como às 17h48min de 10 de outubro de 2018

Toda a formatação de valores do LATROMI baseia-se na Formatação Composta do Microsoft .NET.

Os locais do sistema que permitem a formatação de valores são:

  • Colunas da Consulta.
  • Marcações no Título de Consultas.
  • Marcações nas mensagens disparadas nos Procedimentos.


Formatos

Cada tipo de dados oferece suporte a um conjuntos diferente de formatos. Neste tópico serão listados os formatos mais utilizados para cada tipo. Se necessário, você pode criar seu próprio formato, usando as regras da Formatação Composta do Microsoft .NET. 

O resultado de alguns formatos pode sofrer alterações de acordo com o idioma utilizado para exibição. Por exemplo, o número 1.99 formatado com {0:C} resultaria em R$1,99 no Brasil, mas nos EUA seria $1.99.

Números

Especificador Descrição Valor Formato Resultado
C Mostra o número no formato de moeda corrente. Você pode especificar o número de dígitos das casas decimais.

Para saber mais: especificador de formato de moeda ("C").

1234.567 {0:C}

{0:C2}

R$ 1.234,5699

R$ 1.234,56

D O especificador de formato “D” (ou decimal) converte um número em uma cadeia de caracteres de dígitos decimais (0-9), prefixados por um sinal de negativo se o número for negativo. Esse formato é compatível apenas com tipos inteiros.

Para saber mais: especificador de formato decimal ("D").

1234 {0:D}

{0:D6}

1234

001234

N Mostra o número no formato numérico, incluindo o grupo separador de milhar. Você pode especificar o número de dígitos das casas decimais.

Para saber mais: especificador de formato numérico ("N").

1234.567 {0:N}

{0:N4}

1.234

1.234,5670

P Mostra o número no formato percentual. Você pode especificar o número de dígitos das casas decimais.

Para saber mais: de formato de porcentagem ("P").

1

3.3333

{0:P}

{0:P1}

100%

3,3%

Mostrando o número no formato do CPF. Adicionando zeros antes quando precisar. 12233344 {0:000\.###\.###-##} 001.222.333-44
Mostrando o número no formato do Telefone, adicionando o zero antes do DDD. 51999001122 {0:\(0##\) # ####-####} (051) 9 9900-1122

Datas

Especificador Descrição Valor Formato Resultado
d Mostra a data no formato curto 2008-03-14 11:45:14 {0:d} 14/03/2018
D Mostra a data no formato completo. 2008-03-14 11:45:14 {0:D} sexta-feira, 14 de março de 2008
f Mostra a data no formato completo e a hora no formato curto. 2008-03-14 11:45:14 {0:f} sexta-feira, 14 de março de 2008 11:45
F Mostra a data no formato completo e a hora no formato completo. 2008-03-14 11:45:14 {0:F} sexta-feira, 14 de março de 2008 11:45:14
g Mostra a data no formato curto e a hora no formato curto. 2008-03-14 11:45:14 {0:g} 14/03/2008 11:45
G Mostra a data no formato curto e a hora no formato completo 2008-03-14 11:45:14 {0:G} 14/03/2008 11:45:14
t Mostra a hora no formato curto 2008-03-14 11:45:14 {0:t} 11:45
T Mostra a hora no formato completo 2008-03-14 11:45:14 {0:T} 11:45:14
M Mostra a data no formato dia e mês 2008-03-14 11:45:14 {0:M} 14 de março
Y Mostra a data no formato mês e ano 2008-03-14 11:45:14 {0:Y} março de 2008
Mostra a data conforme configuração: 2008-03-14 11:45:14 {0:dd/MM/yyyy}
{0:dd/MM/yy}
{0:dd/MMM/yyyy}
{0:yyyy/MM/dd}
{0:dd/MMMM/yyyy}
{0:dd/MM/yyyy HH:mm} 		14/03/2008
14/03/08
14/mar/2008
2008/03/14
14/março/2008
14/03/2008 11:45

Intervalos

Um Intervalo é o resultado da diferença entre duas datas, equivalente ao tipo System.TimeSpan do Microsoft .NET.

Por exemplo “01/01/2018 12:0” - “01/01/2018 00:00” = 12 horas (ou 43200000 ms)

Especificador Descrição Valor Formato Resultado
c Formato Constante (invariável). Ele assume o formato
[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]

Mais informações: o especificador de formato de constante ("c").

1000000 ms {0:c} 00:16:40
g Formato curto geral. Esse especificador gera apenas o que é necessário. Ele assume o formato
[-][d’:’]h’:’mm’:’ss[.FFFFFFF]

Mais informações: o especificador de formato curto geral ("g").

1000000 ms {0:g} 0:16:40
G Esse especificador sempre gera dias e sete dígitos de fração. Ele assume o formato
[-]d’:’hh’:’mm’:’ss.fffffff.

Mais informações: o especificador de formato longo geral ("G").

1000000 ms {0:G} 0:00:16:40,0000000
Exemplos de Formatações Customizadas 1000000 ms {0:h':'mm}
{0:hh':'mm}
{0:mm} minuto(s) 		0:16
00:16
16 minutos

Referências

Disponível em "http://docs.latromi.com.br/index.php?title=Formatação_de_Valores&oldid=2079"