Partilhar via


TIME

Aplica-se a:Coluna calculadaTabela calculadaMedidaCá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"ou dt"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])

DATE Funções de data e hora