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
TIME(hour, minute, second)
Parâmetros
Termo | Definição |
---|---|
hour |
modo de importação: um número de 0 a 32767 que representa a hora. Qualquer valor maior que 23 será dividido por 24 e o restante será tratado como o valor de hora, representado como uma fração de um dia. Por exemplo, TIME(27,0,0) = TIME(3,0,0) = 3:00:00 AM modo DirectQuery: um número de 0 a 23 representando a hora. |
minute |
modo de importação: um número de 0 a 32767 que representa o minuto. Qualquer valor maior que 59 minutos será convertido em horas e minutos. Qualquer valor maior que 1440 (24 horas) não altera a parte de data - em vez disso, ela será dividida por 1440 e o restante será tratado como o valor de minuto, representado como uma fração de um dia. Por exemplo, TIME(0.2190,0) = TIME(0.750,0) = TIME(12.30,0) = 12:30:00 PM modo DirectQuery: um número de 0 a 59 representando o minuto. |
second |
modo de importação: um número de 0 a 32767 representando o segundo. Qualquer valor maior que 59 será convertido em horas, minutos e segundos. Por exemplo, TIME(0,0.2000) = TIME(0,33,20) = 12:33:20 AM modo DirectQuery: um número de 0 a 59 representando o segundo. |
Valor de retorno
Um horário (datetime
) que varia das 00:00:00 (00:00:00) às 23:59:59 (23:59:59).
Comentários
Ao contrário do Microsoft Excel, que armazena datas e horas como números de série, 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 você precisar usar números de série, 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 que você digita diretamente, como 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 especificados como literais no formato
dt"YYYY-MM-DD"
,dt"YYYY-MM-DDThh:mm:ss"
oudt"YYYY-MM-DD hh:mm:ss"
. Quando especificado como literal, o uso da função TIME na expressão não é necessário. Para saber mais, consulte DAX Sintaxe | Data e hora.Essa função não tem suporte para uso no modo DirectQuery quando usada em colunas calculadas ou regras de RLS (segurança em nível de linha).
Exemplo 1
Os exemplos a seguir retornam a hora, às 3:00:
= TIME(27,0,0)
= TIME(3,0,0)
Exemplo 2
Os exemplos a seguir retornam a hora, 12h30:
= TIME(0,750,0)
= TIME(12,30,0)
Exemplo 3
O exemplo a seguir cria um tempo com base nos valores nas colunas, intHours
, intMinutes
, intSeconds
:
= TIME([intHours],[intMinutes],[intSeconds])