Função TIME (DAX)
Converte horas, minutos e segundos fornecidos como números em uma hora no formato datetime.
Sintaxe
TIME(hour, minute, second)
Parâmetros
Termo |
Definição |
|---|---|
hour |
Um número de 0 a 23 que representa a hora. Qualquer valor maior que 23 será dividido por 24 e o resto será tratado como o valor de hora. |
minute |
Um número de 0 a 59 que representa o minuto. Qualquer valor maior que 59 será convertido em horas e minutos. |
second |
Um número de 0 a 59 que representa o segundo. Qualquer valor maior que 59 será convertido em horas, minutos e segundos. |
Valor de retorno
Uma hora (datetime).
Comentários
Em contraste com o 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. Números em outros formatos são implicitamente convertidos quando você usa um valor de data/hora em uma função DAX. Se você precisar usar números de série, poderá usar a formatação para alterar a forma de visualização dos números.
Valores de hora são uma parte de um valor de data e, no sistema de número de série, são representados por um número decimal. Portanto, o valor datetime 12:00 PM equivale a 0,5, pois é metade de um dia.
Você pode fornecer os argumentos à função TIME como valores que você digita diretamente, como o resultado de outra expressão, ou por uma referência a uma coluna que contém um valor numérico. As seguintes restrições são aplicadas:
Qualquer valor de horas que for maior que 23 será dividido por 24 e o resto será tratado como o valor de hora.
Qualquer valor de minutes que seja maior que 59 será convertido em horas e minutos.
Qualquer valor de seconds que seja maior que 59 será convertido em horas, minutos e segundos.
Para minutos ou segundos, um valor maior que 24 horas será dividido por 24 e o resto será tratado como o valor de hora. Um valor que excede 24 horas não altera a parte de data.
Para melhorar legibilidade dos valores de hora retornados por esta função, é recomendável formatar a coluna ou a célula de Tabela Dinâmica que contém os resultados da fórmula usando um dos formatos de hora fornecidos pelo Microsoft Excel.
Exemplo
Estes dois exemplos retornam a hora, 3:00 AM:
=TIME(27,0,0)
=TIME(3,0,0)
Estes dois exemplos retornam a hora, 12:30 PM:
=TIME(0,750,0)
=TIME(12,30,0)
O seguinte exemplo cria uma hora com base nos valores das colunas, intHours, intMinutes, intSeconds:
=TIME([intHours],[intMinutes],[intSeconds])