Funções Date e Time no Power Apps

Converte os componentes de data e hora em um valor de data/hora.

Descrição

A função Date converte valores de Year, Month e Day individuais em um valor Date/Time. A parte da hora é meia-noite.

  • Se um valor de Year estiver entre 0 e 1899 (inclusive), a função adicionará esse valor a 1900 para calcular o ano. 70 se torna 1970.
  • Se Month for menor que 1 ou maior que 12, o resultado subtrairá ou adicionará esse número de meses a partir do início do ano especificado.
  • Se o valor de Day for maior que o número de dias do mês especificado, a função adicionará esse número de dias ao primeiro dia do mês e retornará a data correspondente de um mês subsequente. Se o valor de Day for menor que 1, a função subtrairá esse número de dias, mais 1, do primeiro dia do mês especificado.

A função Time converte valores de Hour, Minute e Second individuais em um valor de Date/Time. O resultado não tem data associada a ele.

Consulte as funções DateValue, TimeValue e DateTimeValue para obter informações sobre como converter uma cadeia de caracteres em um valor.

Consulte também Trabalhar com datas e horas para obter mais informações.

Sintaxe

Date( Year, Month, Day )

  • Year – obrigatório. Números maiores que 1899 são interpretados como absolutos (1980 é interpretado como 1980); números entre 0 e 1899 são interpretados como relativos a 1900. (Por exemplo, 80 é interpretado como 1980.)
  • Month – obrigatório. Um número que varia de 1 a 12.
  • Day – obrigatório. Um número que varia de 1 a 31.

Time( Hour, Minute, Second )

  • Hour – obrigatório. Um número que varia de 0 (meia-noite) a 23 (23h).
  • Minute – obrigatório. Um número que varia de 0 a 59.
  • Second – obrigatório. Um número que varia de 0 a 59.

Exemplos

Data

Se um usuário digitou 1979 em um controle de entrada de texto chamado HireYear, 3 em um controle de entrada de texto chamado HireMonth e 17 em um controle de entrada de texto chamado HireDay, essa função retornará 17/3/1979:

Date(Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text))

Time

Se um usuário digitou 14 em um controle de entrada de texto chamado BirthHour, 50 em um controle de entrada de texto chamado BirthMinute e 24 em um controle de entrada de texto chamado BirthSecond, essa função retornará 02:50:24 p.

Text(Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), "hh:mm:ss a/p")