Ler em inglês

Partilhar via


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
hora 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.
minuto 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.
segundo 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 devolvido

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, o 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 digitados 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, o uso da função TIME na expressão não é necessário. Para saber mais, consulte Sintaxe DAX | 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, , intSecondsintMinutes:

= TIME([intHours],[intMinutes],[intSeconds])  

DATE
Funções de data e hora