Ler em inglês

Compartilhar via


TIME

Aplica-se a:Coluna calculadaTabela calculadaMedidaCálculo visual

Converte horas, minutos e segundos fornecidos como números em um tempo em datetime formato.

Sintaxe

DAX
TIME(hour, minute, second)  

Parâmetros

Termo Definição
hour Modo de importação: um número de 0 a 32.767 que representa a hora.
Qualquer valor maior que 23 será dividido por 24 e o resto será tratado como o valor da hora, representado como uma fração de um dia.
Por exemplo, HORA(27,0,0) = HORA(3,0,0) = 3:00:00 DA MANHÃ

Modo do DirectQuery: um número de 0 a 23 que representa a hora.
minute Modo de importação: um número de 0 a 32.767 que representa o minuto.
Qualquer valor maior que 59 minutos será convertido em horas e minutos.
Qualquer valor maior que 1.440 (24 horas) não altera a parte de data, em vez disso, ele será dividido por 1.440 e o restante será tratado como o valor de minuto, representado como uma fração de um dia.
Por exemplo, HORA(0,2190,0) = HORA(0,750,0) = = HORA(12,30,0) = 12:30:00 DA TARDE

Modo do DirectQuery: um número de 0 a 59 que representa o minuto.
second Modo de importação: um número de 0 a 32.767 que representa o segundo.
Qualquer valor maior que 59 será convertido em horas, minutos e segundos.
Por exemplo, HORA(0,0,2000) = HORA(0,33,20) = 12:33:20 DA MANHÃ

Modo do DirectQuery: um número de 0 a 59 que representa o segundo.

Valor retornado

Um horário (datetime) que varia das 00:00:00 (00:00:00) às 23:59:59 (23:59:59).

Comentários

  • Em contraste com o Microsoft Excel, que armazena datas e horas como números de série, o DAX funciona com valores de data e hora em um formato datetime. Os números em outros formatos são convertidos implicitamente quando você usa um valor de data/hora em uma função DAX. Se precisar usar números de série, você poderá usar a formatação para alterar a forma como os números são exibidos.

  • Os valores de hora são uma parte de um valor de data e no sistema de números de série são representados por um número decimal. Portanto, o valor datetime 12:00 PM é equivalente a 0,5, pois é metade de um dia.

  • Você pode fornecer os argumentos para a função TIME como valores digitados diretamente, como o resultado de outra expressão ou por uma referência a uma coluna que contém um valor numérico.

  • Data e datetime também podem ser especificadas como literais nos formatos dt"YYYY-MM-DD", dt"YYYY-MM-DDThh:mm:ss" ou dt"YYYY-MM-DD hh:mm:ss". Quando especificado como um literal, não é necessário usar a função TIME na expressão. Para saber mais, confira Sintaxe DAX | Data e hora.

  • Não há suporte para a função ser usada no modo DirectQuery quando usada em regras RLS (segurança em nível de linha) ou colunas calculadas.

Exemplo 1

Os exemplos a seguir retornam a hora, 3:00:

DAX
= TIME(27,0,0)
DAX
= TIME(3,0,0)  

Exemplo 2

Os exemplos a seguir retornam a hora, 12:30 PM:

DAX
= TIME(0,750,0)
DAX
= TIME(12,30,0)  

Exemplo 3

O exemplo a seguir cria uma hora com base nos valores nas colunas, intHours, intMinutes, intSeconds:

DAX
= TIME([intHours],[intMinutes],[intSeconds])  

DATE
Funções de data e hora