Formato de apresentação de um valor

A sintaxe para definir o formato de saída de um campo segue à padrões conhecidos e compartilhados em diversos ambientes computacionais, e sendo assim, o Portal de Telemetria utiliza-se destes padrões, e para que o usuário possa formatar dados e controles, deve segui-los, conforme as descrições a seguir.

Números e strings

Para representação de grandezas numéricas e strings no Portal de Telemetria, é utilizado a sintaxe definida pelo padrão printf (vide printf references e printf format reference page), com veremos a seguir:

Representação	Descrição
%c	Um caractere
%d	Numero decimal inteiro - base 10
%e	Número exponencial com ponto flutuante
%f	Número com ponto flutuante
%i	Inteiro base 10
%o	Número octal (base 8)
%s	String de caracteres
%u	Número inteiro sem sinal decimal
%x	Número em hexadecimal (base 16)
%% ou %	Representação do sinal percentual

Exemplos de uso

Representação	Descrição	Exemplo
%d	Valor sem casas decimais	10
%04d	Valor sem casas decimais com preenchimento de zeros a esquerda	0010
%.1f	Valor com uma casa decimal	10.1
%.2f	Valor com duas casas decimais	10.12
%.3f	Valor com três casas decimais	10.123
%.4f	Valor com quatro casas decimais	10.1234
%.5f	Valor com cinco casas decimais	10.12345
%s	String

Data

Para representação de datas, em dados e controles, é utilizado o padrão ISO 8601 , como vemos a seguir:

Representação	Descrição
YYYY	Ano com 4 dígitos (2021)
YY	Ano com 2 dígitos (21)
M	Mes (1-12)
MM	Mês (01-12)
MMM	Nome do mês com 3 caracteres (Jan-Dez)
MMMM	Nome do mês completo (Janeiro-Dezembro)
D	Dia do mês (1-31)
DD	Dia do mês (01-31)
DDD	Dia do ano (1-365)
DDDD	Dia do ano (001-365)

Hora e duração

Para formatar campos com Hora e/ou tempo de duração é utilizado o mesmo padrão ISO 8601, como vemos a seguir:

Representação	Descrição
H	Hora (0-23)
HH	Hora (00-23)
h	Hora (0-12)
hh	Hora com 2 dígitos (00-12)
A	AM ou PM
m	Minutos (0-59)
mm	Minutos (00-59)
s	Segundos (0-59)
ss	Segundos (00-59)
S	Fração de segundos
[texto]	Ignora a conversão dos caracteres dentro dos colchetes

Exemplos

Representação	Descrição
DD/MM/YYYY HH:mm:ss	24/12/2019 21:15:00
DD/MM/YYYY h:mmA	24/12/2019 9:15PM
MM/DD/YY HH:mm:ss	12/24/19 21:15:00
MMM, DD YYYY HH:mm:ss	Dec, 24 2019 21:15:00
DD [de] MMMM [de] YYYY - HH:mm[h]	24 de Dezembro de 2019 - 21:15h
hh[h]:mm[m]:ss[s]	01h:01m:10s
hh:mm:ss	05:42:33
hh:mm:ss S	02:33:81 0

Atenção

Para inserir uma quebra de linha na apresentação da Data e Hora no Painel Histórico e Gráfico, utilize o símbolo [\n] no meio do formato.

Ex: DD/MM[\n]HH:mm:ss