TIME
Aplica-se a:
Coluna calculadaTabela calculadaMedidaCálculo visual
Converte horas, minutos e segundos atribuídos como números em uma hora no formato datetime.
Sintaxe
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
Uma hora (datetime) variando de 00:00:00 (12:00:00 DA MANHÃ) a 23:59:59 (11:59:59 DA NOITE).
Comentários
Diferente do Microsoft Excel, que armazena datas e horas como números de série, o DAX trabalha 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 de datetime 12:00 é equivalente a 0,5, porque é a 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"oudt"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:
= TIME(27,0,0)
= TIME(3,0,0)
Exemplo 2
Os exemplos a seguir retornam a hora, 12:30 PM:
= TIME(0,750,0)
= TIME(12,30,0)
Exemplo 3
O exemplo a seguir cria uma hora com base nos valores nas colunas, intHours, intMinutes, intSeconds:
= TIME([intHours],[intMinutes],[intSeconds])