TIME
Aplica-se a:Coluna calculada
Tabela calculada
Medida
Cálculo visual
Converte horas, minutos e segundos dados 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 32767 que representa a hora. Qualquer valor superior a 23 será dividido por 24 e o restante será tratado como o valor da 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 que representa a hora. |
minute |
Modo de importação: Um número de 0 a 32767 que representa o minuto. Qualquer valor superior a 59 minutos será convertido em horas e minutos. Qualquer valor superior a 1440 (24 horas) não altera a parte da data - em vez disso, será dividido por 1440 e o restante será tratado como o valor 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 que representa o minuto. |
second |
Modo de importação: Um número de 0 a 32767 que representa o segundo. Qualquer valor superior a 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 que representa o segundo. |
Valor de retorno
Um horário (datetime
) que varia de 00:00:00 (12:00:00 AM) a 23:59:59 (11:59:59 PM).
Observações
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
. Números em outros formatos são implicitamente convertidos quando você usa um valor de data/hora em uma função DAX. Se precisar de utilizar números de série, pode utilizar a formatação para alterar a forma como os números são apresentados.Os valores de tempo 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, porque é 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 data/hora também podem ser especificadas como literais no formato
dt"YYYY-MM-DD"
,dt"YYYY-MM-DDThh:mm:ss"
oudt"YYYY-MM-DD hh:mm:ss"
. Quando especificado como um literal, usar a função TIME na expressão não é necessário. Para saber mais, consulte DAX Sintaxe | Data e hora.Esta função não é suportada para utilização no modo DirectQuery quando utilizada em colunas calculadas ou regras de segurança ao nível da linha (RLS).
Exemplo 1
Os exemplos a seguir retornam o horário, 3:00 AM:
= TIME(27,0,0)
= TIME(3,0,0)
Exemplo 2
Os exemplos a seguir retornam o horário, 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])