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

De LATROMI Manuais
Ir para: navegação, pesquisa
(→‎Datas)
(→‎Ver Também)
 
(12 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 formattable"
 
{| class="wikitable formattable"
 
|-------------------------------------------
 
|-------------------------------------------
−
! Formatador
+
! Especificador
 
! Descrição  
 
! Descrição  
 
! Valor
 
! Valor
Linha 19: Linha 22:
 
|-------------------------------------------
 
|-------------------------------------------
 
| C
 
| C
−
| Mostra o número no formato de moeda corrente. Você pode especificar o número de dígitos das casas decimais. Clique [https://docs.microsoft.com/dotnet/standard/base-types/standard-numeric-format-strings#CFormatString aqui] para ler a  documentação da Microsoft.
+
| 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  
 
| 1234.567  
 
| {0:C}
 
| {0:C}
Linha 27: Linha 31:
 
|-------------------------------------------
 
|-------------------------------------------
 
| D
 
| 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. Clique [https://docs.microsoft.com/dotnet/standard/base-types/standard-numeric-format-strings#DFormatString aqui] para ler a  documentação da Microsoft.
+
| 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
 
|1234
 
|{0:D}
 
|{0:D}
Linha 35: Linha 40:
 
|-------------------------------------------
 
|-------------------------------------------
 
| N
 
| 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. Clique [https://docs.microsoft.com/dotnet/standard/base-types/standard-numeric-format-strings#NFormatString aqui] para ler a documentação da Microsoft.
+
| 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
 
| 1234.567
 
|{0:N}
 
|{0:N}
Linha 43: Linha 49:
 
|-------------------------------------------
 
|-------------------------------------------
 
| P
 
| P
−
| Mostra o número no formato percentual. Você pode especificar o número de dígitos das casas decimais. Clique [https://docs.microsoft.com/dotnet/standard/base-types/standard-numeric-format-strings#PFormatString aqui] para ler a documentação da Microsoft.
+
| 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  
 
| 1  
 
3.3333
 
3.3333
Linha 141: Linha 148:
  
 
=== Intervalos ===
 
=== 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"
 
{| class="wikitable formattable"
 
! Especificador
 
! Especificador
Linha 149: Linha 160:
 
|-------------------------------------------
 
|-------------------------------------------
 
| c
 
| c
−
| Formato Constante (invariável). Esse especificador não é sensível à cultura. Ele assume o formato <br><code>[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]</code>
+
| Formato Constante (invariável). Ele assume o formato <br><code>[-][d’.’]hh’:’mm’:’ss[‘.’fffffff]</code>
−
Clique [https://docs.microsoft.com/pt-br/dotnet/standard/base-types/standard-timespan-format-strings#the-constant-c-format-specifier aqui] para ler a documentação oficinal da Microsoft.
+
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
 
| 1000000 ms
 
| {0:c}
 
| {0:c}
Linha 156: Linha 167:
 
|-------------------------------------------
 
|-------------------------------------------
 
| g
 
| g
−
| Formato curto geral. Esse especificador gera apenas o que é necessário. Ele é sensível à cultura e assume o formato <br><code>[-][d’:’]h’:’mm’:’ss[.FFFFFFF]</code>
+
| Formato curto geral. Esse especificador gera apenas o que é necessário. Ele assume o formato <br><code>[-][d’:’]h’:’mm’:’ss[.FFFFFFF]</code>
−
Clique [https://docs.microsoft.com/dotnet/standard/base-types/standard-timespan-format-strings#GeneralShort aqui] para ler a documentação oficial da Microsoft.
+
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
 
| 1000000 ms
 
| {0:g}
 
| {0:g}
Linha 163: Linha 174:
 
|-------------------------------------------
 
|-------------------------------------------
 
| G
 
| G
−
| Esse especificador sempre gera dias e sete dígitos de fração. Ele é sensível à cultura e assume o formato <br><code>[-]d’:’hh’:’mm’:’ss.fffffff</code>.
+
| 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
 
| 1000000 ms
 
| {0:G}
 
| {0:G}
 
| 0:00:16:40,0000000
 
| 0:00:16:40,0000000
 +
|-------------------------------------------
 +
|
 +
| Exemplos de Formatações Customizadas
 +
| 1000000 ms
 +
| {0:h':'mm} <br>{0:hh':'mm} <br>{0:mm} minuto(s)
 +
| 0:16 <br>00:16 <br>16 minutos
 
|}
 
|}
 +
 +
== 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"