Funções de Data e Hora no PowerAppsDate and Time functions in PowerApps

Converte os componentes de data e hora para um valor de data/hora.Converts date and time components to a date/time value.

DescriçãoDescription

A função Data converte valores de ano, mês e dia individuais em um valor de data/hora.The Date function converts individual Year, Month, and Day values to a Date/Time value. A parte da hora é meia-noite.The time portion is midnight.

  • Se um valor de ano estiver entre 0 e 1899 (inclusive), a função adicionará esse valor a 1900 para calcular o ano.If Year is between 0 and 1899 (inclusive), the function adds that value to 1900 to calculate the year. 70 se torna 1970.70 becomes 1970.
  • Se o mês for menor que 1 ou maior que 12, o resultado subtrai ou adiciona esse mesmo número de meses a partir do início do ano especificado.If Month is less than 1 or more than 12, the result subtracts or adds that many months from the beginning of the specified year.
  • Se o valor da opção dia 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.If Day is greater than the number of days in the specified month, the function adds that many days to the first day of the month and returns the corresponding date from a subsequent month. Se o valor da opção dia for menor que 1, a função subtrairá esse número de dias, mais 1, do primeiro dia do mês especificado.If Day is less than 1, the function subtracts that many days, plus 1, from the first day of the specified month.

A função Tempo converte valores de hora, minuto e segundo individuais em um valor de data/hora.The Time function converts individual Hour, Minute, and Second values to a Date/Time value. O resultado não tem nenhuma data associada a ele.The result has no date associated with it.

Consulte as funções DateValue, TimeValue, e DateTimeValue para obter informações sobre como converter uma cadeia de caracteres em um valor.See the DateValue, TimeValue, and DateTimeValue functions for information about how to convert a string to a value.

Consulte também Trabalhar com datas e horas para obter mais informações.Also see working with dates and times for more information.

SintaxeSyntax

Data( Ano, Mês, Dia )Date( Year, Month, Day )

  • Year - Required.Year - Required. 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.Numbers greater than 1899 are interpreted as absolute (1980 is interpreted as 1980); numbers that range from 0 to 1899 are interpreted as relative to 1900. (Por exemplo, 80 é interpretado como 1980.)(For example, 80 is interpreted as 1980.)
  • Month - Required.Month - Required. Um número que varia de 1 a 12.A number that ranges from 1 to 12.
  • Day - Required.Day - Required. Um número que varia de 1 a 31.A number that ranges from 1 to 31.

Hora( Hora, Minuto, Segundo )Time( Hour, Minute, Second )

  • Hour - Required.Hour - Required. Um número que varia de 0 (12:00 AM) a 23 (11:00 PM).A number that ranges from 0 (12:00 AM) to 23 (11:00 PM).
  • Minute - Required.Minute - Required. Um número que varia de 0 a 59.A number that ranges from 0 to 59.
  • Second - Required.Second - Required. Um número que varia de 0 a 59.A number that ranges from 0 to 59.

ExemplosExamples

DataDate

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:If a user typed 1979 in a text-input control named HireYear, 3 in a text-input control named HireMonth, and 17 in a text-input control named HireDay, this function would return 3/17/1979:

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

HoraTime

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.If a user typed 14 in a text-input control named BirthHour, 50 in a text-input control named BirthMinute, and 24 in a text-input control named BirthSecond, this function would return 02:50:24 p.

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