Time – função de script e gráfico

Time() formata uma expressão como um valor de tempo, no formato de tempo definido nas variáveis de sistema no script de carga de dados ou no sistema operacional, a não ser que uma string de formato seja fornecida.

Sintaxe:

Time(number[, format])

Tipo de dados de retorno: dual

Argumentos
Argumento	Descrição
number	O número a ser formatado.
format	String descrevendo como a string de hora resultante será formatada. Se for omitido, serão usados o formato de hora e o separador decimal definidos no sistema operacional. A função Time aceita muitas opções de formato para diferentes estruturas de tempo, por exemplo: hh:mm:ss – formata um valor de hora em um formato de hora padrão e exibe horas, minutos e segundos com zeros à esquerda. hh:mm TT —usa um formato de 12 horas com o sufixo AM/PM. hh:mm — mostra apenas horas e minutos, omitindo os segundos. hh.mm.ss —formato de hora com separadores diferentes, como um ponto (.) em vez de dois pontos. hh TT —inclui apenas hora e AM/PM. hh "Hrs" mm "Mins" –exibe a hora com texto personalizado, como Hrs. Descrições para formatos de número e hora

Exemplo: expressões de gráfico
Exemplo	Resultado
Time( 0.375 )	Retorna 09:00:00 quando a configuração de TimeFormat é 'hh:mm:ss'.
Time( 35648.375 )	Retorna 09:00:00 quando o Timeformat fornecido é 'hh:mm:ss'.
Time( 0.99999, 'hh-mm' )	Retorna 23-59 ignorando a configuração de TimeFormat, pois o formato é fornecido na medida.

Exemplo – Fundamentos de Time

Visão geral

Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.

O script de carregamento contém:

Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
O seguinte campo em uma tabela de dados:
- TimeValue
A variável TimeFormat, que usa o formato hh:mm:ss.

Script de carregamento

SET TimeFormat='hh:mm:ss';
Example:
Load * inline [
TimeValue
0.375
35648.375
0.99999
];

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão:

TimeValue

Crie as seguintes medidas:

=Time(TimeValue ) para visualizar o valor como uma hora formatada usando a configuração do sistema.
=Time(TimeValue, 'hh-mm' ) para visualizar o valor como uma hora no formato fornecido na função.
=Time(TimeValue, 'hh:mm:ss' ) para visualizar o valor como uma hora no formato fornecido na função.
=Time(TimeValue, 'hh:mm TT' ) para visualizar o valor como uma hora no formato fornecido na função.
=Time(TimeValue, 'hh:mm' ) para visualizar o valor como uma hora no formato fornecido na função.
=Time(TimeValue, 'hh.mm.ss' ) para visualizar o valor como uma hora no formato fornecido na função.
=Time(TimeValue, 'hh TT' ) para visualizar o valor como uma hora no formato fornecido na função.
=Time(TimeValue, 'hh "Hrs" mm "Mins"' ) para visualizar o valor como uma hora no formato fornecido na função.

Tabela de resultados
TimeValue	Time(TimeValue)	Time(TimeValue, 'hh-mm')	Time(TimeValue, 'hh:mm:ss')	Time(TimeValue, 'hh:mm TT')	Time(TimeValue, 'hh:mm')	Time(TimeValue, 'hh.mm.ss')	Time(TimeValue, 'hh TT')	Time(TimeValue, 'hh "Hrs" mm "Mins"')
0.375	09:00:00	09-00	09:00:00	09:00 AM	09:00	09.00.00	09 AM	09 Hrs 00 Mins
0.99999	23:59:59	23-59	23:59:59	11:59 PM	23:59	23.59.59	11 PM	23 Hrs 59 Mins
35648.375	09:00:00	09-00	09:00:00	09:00 AM	09:00	09.00.00	09 AM	09 Hrs 00 Mins

Os resultados mostram como a função Time pode exibir valores com base no formato fornecido na expressão da função.

Exemplo – Fundamentos de tempo usando uma configuração de TimeFormat diferente