Funções Date e Time 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 Date converte os valores Ano, Mês e Dia individuais num valor Data/Hora.The Date function converts individual Year, Month, and Day values to a Date/Time value. A parcela de tempo é a meia-noite.The time portion is midnight.

  • Se Ano estiver entre 0 e 1899 (inclusive), a função adiciona 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 torna-se 1970.70 becomes 1970.
  • Se Mês for menor do que 1 ou maior do que 12, o resultado subtrai ou adiciona esses meses ao 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 Dia for maior do que o número de dias no mês especificado, a função adiciona esses dias ao primeiro dia do mês e devolve a data correspondente do 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 Dia for menor do que 1, a função subtrai esses dias mais 1 ao 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 Time converte os valores Hora, Minuto e Segundo individuais num valor Data/Hora.The Time function converts individual Hour, Minute, and Second values to a Date/Time value. O resultado não tem data associada.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 num valor.See the DateValue, TimeValue, and DateTimeValue functions for information about how to convert a string to a value.

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

SintaxeSyntax

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

  • Ano – necessário.Year - Required. Os números maiores do que 1899 são interpretados como absolutos (1980 é interpretado como 1980) e os números dentro do intervalo de 0 a 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.)
  • Mês – necessário.Month - Required. Um número entre 1 e 12.A number that ranges from 1 to 12.
  • Dia – necessário.Day - Required. Um número entre 1 e 31.A number that ranges from 1 to 31.

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

  • Hora – necessário.Hour - Required. Um número entre 0 (12:00 AM) e 23 (11:00 PM).A number that ranges from 0 (12:00 AM) to 23 (11:00 PM).
  • Minuto – necessário.Minute - Required. Um número entre 0 e 59.A number that ranges from 0 to 59.
  • Segundo – necessário.Second - Required. Um número entre 0 e 59.A number that ranges from 0 to 59.

ExemplosExamples

DataDate

Se um utilizador escrever 1979 num controlo de introdução de texto com o nome AnoDeContratação, 3 num controlo de introdução de texto com o nome MêsDeContratação e 17 num controlo de introdução de texto com o nome DiaDeContratação, esta função devolverá 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(AnoDeContratação.Text), Value(MêsDeContratação.Text), Value(DiaDeContratação.Text))Date(Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text))

TimeTime

Se um utilizador escrever 14 num controlo de introdução de texto com o nome HoraDeNascimento, 50 num controlo de introdução de texto com o nome MinutoDeNascimento e 24 num controlo de introdução de texto com o nome SegundoDeNascimento, esta função devolverá 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(HoraDeNascimento.Text), Value(MinutoDeNascimento.Text), Value(SegundoDeNascimento.Text)), "hh:mm:ss a/p")Text(Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), "hh:mm:ss a/p")