Comentários

Funções Date e Time no Power Apps

  • Artigo
  • 2 minutos para o fim da leitura

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

Descrição

A função Date converte os valores Ano, Mês e Dia individuais num valor Data/Hora. A hora é definida como meia-noite.

  • Se Ano estiver entre 0 e 1899 (inclusive), a função adiciona esse valor a 1900 para calcular o ano. 70 torna-se 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.
  • 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. Se Dia for menor do que 1, a função subtrai esses dias mais 1 ao primeiro dia do mês especificado.

A função Time converte os valores Hora, Minuto e Segundo individuais num valor Data/Hora. O resultado não tem data associada.

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

Para obter mais informações, veja também trabalhar com datas e horas.

Sintaxe

Date( Ano, Mês, Dia )

  • Ano – necessário. 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. (Por exemplo, 80 é interpretado como 1980.)
  • Mês – necessário. Um número entre 1 e 12.
  • Dia – necessário. Um número entre 1 e 31.

Time( Hora, Minuto, Segundo )

  • Hora – necessário. Um número entre 0 (12:00 AM) e 23 (11:00 PM).
  • Minuto – necessário. Um número entre 0 e 59.
  • Segundo – necessário. Um número entre 0 e 59.

Exemplos

Date

Se um utilizador escrever 1979 num controlo de introdução de texto com o nome HireYear, 3 num controlo de introdução de texto com o nome HireMonth e 17 num controlo de introdução de texto com o nome HireDay, esta função devolverá 17/3/1979:

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

Time

Se um utilizador escrever 14 num controlo de introdução de texto com o nome BirthHour, 50 num controlo de introdução de texto com o nome BirthMinute e 24 num controlo de introdução de texto com o nome BirthSecond, esta função devolverá 02:50:24 p.

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

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).