Função TIME
Converte horas, minutos e segundos fornecidos como números para 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.
Esta função DAX pode retornar resultados diferentes quando usada em um modelo que é implantado e consultado no modo DirectQuery. Para obter mais informações sobre diferenças semânticas no modo DirectQuery, consulte https://go.microsoft.com/fwlink/?LinkId=219171.
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])