Strings de Formato Personalizado

As strings de formato personalizado fornecem opções adicionais de formatação de colunas ou níveis de hierarquia que contêm timestamps, datas e horários.

Para definir strings de formato personalizado para uma coluna ou nível de hierarquia, use o campo Formato de Data Personalizado (para campos de data e hora) ou o campo Formato Numérico Personalizado (para campos numéricos) na caixa de diálogo Propriedades da Coluna: guia Formato de Dados.

Esta seção contém os seguintes tópicos:

Strings de Formato Personalizado para Campos de Data e Horário

É possível definir strings de formato personalizado para um nível de coluna ou hierarquia no campo Formato de Data Personalizado na caixa de diálogo Propriedades da Coluna: guia Formato de Dados.

Esta seção contém os seguintes tópicos:

Strings de Formato Personalizado Gerais

Você pode criar formatos personalizados de data ou hora usando essas strings.

A tabela mostra as strings de formato personalizado gerais e os resultados que elas exibem. Isso permite a exibição de campos de data e hora na configuração regional do usuário.

String de Formato Geral Resultado

[FMT:dateShort]

Formata a data no formato curto de data da configuração regional. Também é possível digitar [FMT:date].

[FMT:dateLong]

Formata a data no formato longo de data da configuração regional.

[FMT:dateInput]

Formata a data em um formato aceitável para entrada no sistema.

[FMT:time]

Formata a hora no formato de hora da configuração regional.

[FMT:timeHourMin]

Formata a hora no formato de hora da configuração regional, mas omite os segundos.

[FMT:timeInput]

Formata a hora em um formato aceitável para nova entrada no sistema.

[FMT:timeInputHourMin]

Formata a hora em um formato aceitável para nova entrada no sistema, mas omite os segundos.

[FMT:timeStampShort]

Equivalente a digitar [FMT:dateShort] [FMT:time]. Formata a data no formato de data curto e a hora no formato de hora da configuração regional. Você também pode digitar [FMT:timeStamp].

[FMT:timeStampLong]

Equivalente a digitar [FMT:dateLong] [FMT:time]. Formata a data no formato de data longo e a hora no formato de hora da configuração regional.

[FMT:timeStampInput]

Equivalente a [FMT:dateInput] [FMT:timeInput]. Formata a data e o horário em um formato aceitável para entrada novamente no sistema.

[FMT:timeHour]

Formata o campo de horário somente no formato da configuração regional, por exemplo, 8 PM.

AA ou aa

Exibe os dois últimos dígitos do ano, preenchido à esquerda com um zero, se for necessário, por exemplo, 01 relativo a 2001.

AAA ou aaa

Exibe o ano com quatro dígitos, preenchido com zero à esquerda, se necessário, por exemplo, 0523.

AAAA ou aaaa

Exibe o ano com quatro dígitos, por exemplo, 2011

M

Exibe o mês numérico, por exemplo, 2 para fevereiro.

MM

Exibe o mês numérico, preenchido à esquerda com zero para meses com um único dígito, por exemplo, 02 para fevereiro.

MMM

Exibe o nome abreviado do mês na configuração regional do usuário, por exemplo, Fev.

MMMM

Exibe o nome completo do mês na configuração regional do usuário, por exemplo, Fevereiro.

D ou d

Exibe o dia do mês, por exemplo, 1.

DD ou dd

Exibe o dia do mês, preenchido à esquerda com um zero para dias com um único dígito, por exemplo, 01.

DDD ou ddd

Exibe o nome abreviado do dia da semana na configuração regional do usuário, por exemplo, qui para quinta-feira.

DDDD ou dddd

Exibe o nome completo do dia da semana na configuração regional do usuário, por exemplo, Quinta-feira.

DDDDD ou ddddd

Exibe a primeira letra do nome do dia da semana na configuração regional do usuário, por exemplo, Q para quinta-feira.

h

Exibe o horário no formato de 12 horas, por exemplo, 2.

H

Exibe o horário no formato de 24 horas, por exemplo, 23.

hh

Exibe o horário no formato de 12 horas, preenchido com zero à esquerda no caso de horários com um único dígito, por exemplo, 01.

HH

Exibe o horário no formato de 24 horas, preenchido com zero à esquerda no caso de horários com um único dígito, por exemplo, 23.

m

Exibe o minuto, por exemplo, 7.

mm

Exibe o minuto, preenchido à esquerda com um zero para minutos com um único dígito, por exemplo, 07.

s

Exibe os segundos, por exemplo, 2.

Também é possível incluir decimais na string, como s.# ou s.00 (onde # significa um dígito opcional e 0 significa dígito obrigatório).

ss

Exibe os segundos, preenchidos à esquerda com um zero para segundos com um único dígito, por exemplo, 02.

Também é possível incluir decimais na string, como ss.# ou ss.00 (onde # significa um dígito opcional e 0 significa dígito obrigatório).

t

Exibe a primeira letra da abreviação de antes do meio-dia ou depois do meio-dia na configuração regional do usuário, por exemplo, a.

tt

Exibe a abreviação de ante meridiem ou post meridiem na configuração regional do usuário, por exemplo, pm.

gg

Exibe a era na configuração regional do usuário.

Strings de Formato Personalizado de ODBC

Você pode criar strings de formato personalizado usando ODBC,

A tabela mostra as strings de formato personalizado do tipo padrão ODBC e os resultados que exibem. Essas strings exibem campos de data e hora de acordo com o padrão ODBC.

String de Formato ODBC Resultado

[FMT:dateODBC]

Formata a data no formato ODBC padrão aaaa-mm-dd (ano com quatro dígitos, mês com dois dígitos e dia com dois dígitos).

[FMT:timeODBC]

Formata a hora no formato ODBC padrão hh:mm:ss (hora com dois dígitos, minuto com dois dígitos e segundo com dois dígitos).

[FMT:timeStampODBC]

Equivalente a digitar [FMT:dateODBC] [FMT:timeStampODBC]. Formata a data no formato aaaa-mm-dd e a hora no formato hh:mm:ss.

[FMT:dateTyped]

Exibe a palavra data e mostra a data, no formato ODBC padrão aaaa-mm-dd. A data é exibida entre aspas simples (').

[FMT:timeTyped]

Exibe a palavra hora e mostra a hora, no formato ODBC padrão hh:mm:ss. A hora é mostrada entre aspas simples (').

[FMT:timeStampTyped]

Exibe a palavra data/horário e depois mostra a data/horário, no formato padrão ODBC aaaa-mm-dd hh:mm:ss. A data/horário é mostrada entre os caracteres de aspas simples (').

Strings de Formato Personalizado para Campos Numéricos

A definição de strings de formato personalizado para campos numéricos assegura que os dados sejam interpretados com precisão.

É possível definir strings de formato personalizado para uma coluna ou nível de hierarquia no campo Formato Numérico Personalizado na caixa de diálogo Propriedades da Coluna: guia Formato de Dados.

Nota:

Ao aplicar um formato de tipos de dados diferentes, por exemplo, aplicar um formato de tipo de data a um campo numérico, se o valor real estiver fora dos limites, o formato não será aplicado e o valor original será exibido. Como exemplo, utilize o formato [MMMM]. Se o valor original a ser convertido for 13, esse valor estará fora dos limites porque há somente 12 meses em um ano. O valor original, 13, é exibido sem ser convertido em um nome de mês. Se o valor original for 12, aplicar o formato personalizado converterá o valor para o 12° mês, isto é, "Dezembro".

Esta seção contém os seguintes tópicos:

Strings de Formato Personalizado para Campos Integrais

Você pode exibir os valores de mês e dia usando strings de formato personalizado.

A tabela mostra as strings de formato personalizado disponíveis ao trabalhar com campos integrais. Elas permitem a exibição de nomes de mês e dia na configuração regional do usuário.

O campos integrais contêm números inteiros que representam o mês do ano ou o dia da semana. Para os meses, 1 representa janeiro, 2 representa fevereiro e e assim por diante, sendo que 12 representa dezembro. Para os dias da semana, 1 representa domingo, 2 representa segunda-feira e assim por diante, sendo que 7 representa sábado.

String de Formato de Campo Integral Resultado

[MMM]

Exibe o nome abreviado do mês na configuração regional do usuário.

[MMMM]

Exibe o nome completo do mês na configuração regional do usuário.

[DDD]

Exibe o nome abreviado do dia da semana na configuração regional do usuário.

[DDDD]

Exibe o nome completo do dia da semana na configuração regional do usuário.

Strings de Formato Personalizado para Conversão em Horas

Você pode converter diversos períodos em formatos de hora.

A tabela mostra as strings de formato personalizado que podem ser usadas para formatar dados em horas. Use essas strings nos seguintes tipos de campo:

  • O campos que contêm números inteiros ou números reais que representam o tempo decorrido desde o início do dia (12:00 AM).

  • Os campos cujo formato de saída é [FMT:timeHour], conforme descrito na tabela. (Esse formato exibe o campo de hora somente no formato da configuração regional, por exemplo, 8 PM).

Strings de Formato para Conversão de Dados Resultado

[FMT:timeHour]

Considera-se que o valor representa o número de horas decorridas desde o início do dia e formata o número de horas na exibição hh, onde hh corresponde ao número de horas. As frações são retiradas do valor. Por exemplo, o valor 2 é formatado como 2 AM e o valor 12,24 como 12 PM.

[FMT:timeHour(min)]

Considera-se que o valor representa o número de minutos decorridos desde o início do dia e formata o número de minutos na exibição hh, onde hh corresponde número de horas. As frações são retiradas do valor. Por exemplo, o valor 2 é formatado como 12 AM e o valor 363,10 como 6 AM.

[FMT:timeHour(sec)]

Considera-se que o valor representa o número de segundos decorridos desde o início do dia e formata o número de segundos na exibição hh, onde hh corresponde ao número de horas. As frações são retiradas do valor. Por exemplo, o valor 600 é formatado como 12 AM e o valor 3600 como 1 AM e o valor 61214,30 como 5 PM.

Strings de Formato Personalizado para Conversão em Horas e Minutos

Você pode converter diversos períodos em formatos de hora e minuto.

A tabela mostra as strings de formato personalizado que podem ser usadas para formatar dados em horas e minutos. Use essas strings em campos que contêm números inteiros ou números reais que representam o tempo decorrido desde o início do dia (12:00 AM).

Elas também podem ser usadas quando a saída é no formato [FMT:timeHourMin], descrito na tabela. (Esse formato exibe a hora no formato de hora da configuração regional, mas omite os segundos.)

Strings de Formato para Conversão de Dados Resultado

[FMT:timeHourMin]

Considera-se que o valor representa o número de minutos decorridos desde o início do dia e converte o valor na exibição hh:mm, onde hh corresponde ao número de horas e mm ao número de minutos. As frações são retiradas do valor. Por exemplo, o valor 12 é formatado como 12:12 AM, o valor 73 como 1:13 AM e o valor 750 como 12:30 PM.

[FMT:timeHourMin(sec)]

Considera-se que o valor representa o número de segundos decorridos desde o início do dia e converte o valor na exibição hh:mm, onde hh corresponde ao número de horas e mm ao número de minutos. As frações são retiradas do valor. Por exemplo, o valor 60 é formatado como 12:01 AM, o valor 120 como 12:02 AM e o valor 43200 como 12:00 PM.

[FMT:timeHourMin(hour)]

Considera-se que o valor representa o número de horas decorridas desde o início do dia e converte o número de horas na exibição hh:mm, onde hh corresponde ao número de horas e mm ao número de minutos restantes. Por exemplo, o valor 0 é formatado como 12:00 AM, o valor 1,5 como 1:30 AM e o valor 13,75 como 1:45 PM.

Strings de Formato Personalizado para Conversão em Horas, Minutos e Segundos

Você pode converter diversos períodos em formatos de hora, minuto e segundo.

A tabela mostra as strings de formato personalizado que podem ser usadas para formatar dados em horas, minutos e segundos. Use essas strings em campos que contêm números inteiros ou números reais que representam o tempo.

Elas também podem ser usadas quando o resultado está no formato [FMT:time], descrito em Strings de Formato Personalizado Gerais. (Esse formato exibe a hora no formato de hora da configuração regional.)

Strings de Formato para Conversão de Dados Resultado

[FMT:time]

Considera-se que o valor representa o número de segundos decorridos desde o início do dia e converte o valor na exibição hh:mm:ss, onde hh corresponde ao número de horas, mm ao número de minutos e ss ao número de segundos. Por exemplo, o valor 60 é formatado como 12:01:00 AM, o valor 126 como 12:02:06 AM e o valor 43200 como 12:00:00 PM.

[FMT:time(min)]

Considera-se que o valor representa o número de minutos decorridos desde o início do dia e converte o valor na exibição hh:mm:ss, onde hh corresponde ao número de horas, mm ao número de minutos e ss ao número de segundos. Por exemplo, o valor 60 é formatado como 1:00:00 AM, o valor 126 como 2:06:00 AM e o valor 1400 como 11:20:00 PM.

[FMT:time(hour)]

Considera-se que o valor representa o número de horas decorridas desde o início do dia e converte o valor na exibição hh:mm:ss, onde hh corresponde ao número de horas, mm ao número de minutos e ss ao número de segundos. Por exemplo, o valor 6,5 é formatado como 6:30:00 AM e o valor 12 como 12:00:00 PM.

Strings de Formato Personalizado para Exibir a Duração

Você pode converter uma variedade de períodos para descrever uma duração de tempo.

A tabela mostra as strings de formato personalizado que podem ser usadas para formatar dados de duração em dias, horários, minutos e segundos. Use essas strings em campos que contêm números inteiros ou números reais que representam o tempo.

Permite a view da duração, como a duração de uma chamada telefônica. Você pode formatar um campo numérico como DD:HH:MM:SS.

Você pode adicionar valores literais na string para tornar o resultado mais claro, conforme no exemplo a seguir:

  • [duration][opt:dd"d":][opt:hh"h":]mm"m":ss"s"
  • Quando a entrada é = 15000, a saída é: 04h:10m:00s

Dessa forma, os valores literais h, m e s representam horas, minutos e segundos no resultado.

Adicionar [opt:...] em qualquer lugar na string torna o campo opcional, e ele não será exibido se não tiver um valor. No exemplo anterior, [opt:dd] significa que um valor para dias não é exibido porque não tem um valor.

Strings de Formato para Conversão de Dados Resultado

[duration(sec)][opt:dd]:hh:mm:ss

Formata o total de segundos como duração. Por exemplo, um valor de duração de 16500.00 é exibido como 04:35:00, o que significa uma duração de quatro horas, 35 minutos e zero segundos.

opt:dd exibe vários dias, mas se opt não tiver valor, ela não será exibida.

Segundo é a unidade padrão de tempo.

[duration(min)][opt:dd]:hh:mm:ss

Formata o total de minutos como duração. Por exemplo, um valor de duração de 275.00 é exibido como 04:35:00, o que significa uma duração de quatro horas, 35 minutos e zero segundos.

opt:dd exibe vários dias, mas se opt não tiver valor, ela não será exibida.

[duration(hour)][opt:dd]:hh:mm:ss

Formata o total de horas como duração. Por exemplo, um valor de duração de 4.58 é exibido como 04:35:00, o que significa uma duração de quatro horas, 34 minutos e 48 segundos.

opt:dd exibe vários dias, mas se opt não tiver valor, ela não será exibida.

[duration(day)][opt:dd]:hh:mm:ss

Formata o total de dias como duração. Por exemplo, um valor de duração de 2.13 é exibido como 02:03:07:12, o que significa uma duração de dois dias, três horas, sete minutos e doze segundos.

opt:dd exibe vários dias, mas se opt não tiver valor, ela não será exibida.