Formatação personalizada de colunas de período de tempo
Se o formato que você deseja utilizar não pode ser criado com as configurações dadas, os caracteres de formato personalizado permite que você crie seus próprios formatos utilizando um código, explicado nos exemplos abaixo. Há cinco valores de dados diferentes incluídos no formato TimeSpan
: dias, horas, minutos, segundos e frações de segundos.
Exemplos:
Estes podem ser combinados com um formato adequado, utilizando caracteres de formato construídos pelos caracteres especificadores seguintes:
Caractere | Descrição |
---|---|
d
|
Retorna o número de dias. |
h
|
Retorna o número de horas, com um ou dois dígitos, dependendo do valor. Isso significa que seis horas serão escritas como "6" (enquanto 11 horas serão escritas como "11") quando essa sequência de caracteres de formato for aplicada. |
hh
|
Retorna o número de horas, com dois dígitos. Isso significa que seis horas serão escritas como '06 ', quando estes caracteres de formato são aplicados. |
m
|
Retorna o número de minutos, com um ou dois dígitos, dependendo do valor. Isso significa que seis minutos serão escritos como "6" (enquanto 11 minutos serão escritos como "11") quando essa sequência de caracteres de formato for aplicada. |
mm
|
Retorna o número de minutos, com dois dígitos. Isso significa que seis minutos será escrito como '06'. |
s
|
Retorna o número de segundos, com um ou dois dígitos, dependendo do valor. Isso significa que seis segundos serão escritos como "6" (enquanto 11 segundos serão escritos como "11") quando essa sequência de caracteres de formato for aplicada. |
ss
|
Retorna o número de segundos, com dois dígitos. Isso significa que seis segundos será escrito como '06'. |
f
|
Retorna as frações de segundos. Ao especificar sequências de caracteres de formato personalizadas, é possível também adicionar um número entre 1 e 3 após o |
Entre cada caractere especificador, você precisa fornecer algum tipo de separador. Esse separador poderia ser um valor de sequência customizada; porém, se algum caractere especificador for incluído na sequência, ele deverá ser precedido por uma barra invertida (\
). Você também pode incluir caracteres iniciais e conclusivos.
Todos os exemplos abaixo usam o seguinte valor dos dados: -5 dias, 7 horas, 11 minutos, 3,1234 segundos.
Caracteres de formato | Resultado |
---|---|
d.h:m:s.f
|
-5.7:11:3.1 |
d.hh:mm:ss.f2
|
-5.07:11:03.12 |
Ti\me\span i\s d \day\s
|
Timespan são -5 dias |
d \day\s h \hour\s m \minute\s s \secon\d\s
|
-5 dias 7 horas 11 minutos 3 segundos |
f s m h d
|
123 3 11 7 -5 |