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")