Funções Date, DateTime e Time

  • Artigo

Aplica-se a: Aplicações de tela Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI

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, Segundo individuais e opcionalmente milissegundos num valor Data/Hora. O resultado não tem data associada.

A função DateTime combina as funções Date e Time numa única função, utilizando os argumentos date e time e devolvendo um valor de Data/Hora que tem componentes de data e hora.

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 – Obrigató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 – Obrigatório. Um número entre 1 e 12.
  • Dia – Obrigatório. Um número entre 1 e 31.

Time( Hora, Minuto, Segundo [, Milissegundos ] )

  • Hora – Obrigatório. Número de horas, geralmente no intervalo de 0 (00:00) a 23 (23:00).
  • Minuto – Obrigatório. Número de minutos, normalmente no intervalo de 0 a 59.
  • Segundo – Obrigatório. Número de segundos, normalmente no intervalo de 0 a 59.
  • Milissegundos – Opcional. Número de milissegundos, normalmente no intervalo de 0 a 999.

DateTime( Ano, Mês, Dia, Hora, Minuto, Segundo [, Milissegundos ] )

  • Ano – Obrigató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 – Obrigatório. Um número entre 1 e 12.
  • Dia – Obrigatório. Um número entre 1 e 31.
  • Hora – Obrigatório. Número de horas, geralmente no intervalo de 0 (00:00) a 23 (23:00)
  • Minuto – Obrigatório. Número de minutos, normalmente no intervalo de 0 a 59.
  • Segundo – Obrigatório. Número de segundos, normalmente no intervalo de 0 a 59.
  • Milissegundos – Opcional. Número de milissegundos, normalmente no intervalo de 0 a 999.

Exemplos

Date

Se um utilizador escreveu

  • 1979 num controlo de entrada de texto chamado HireYear
  • 3 num controlo de entrada de texto chamado HireMonth
  • 17 num controlo de entrada de texto chamado HireDay

esta fórmula devolveria 3/17/1979:

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

Hora

Se um utilizador escreveu

  • 14 num controlo de entrada de texto chamado BirthHour
  • 50 num controlo de entrada de texto chamado BirthMinute
  • 24 num controlo de entrada de texto chamado BirthSecond

esta fórmula devolveria 02:50:24 P:

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

DateTime

Se um utilizador escreveu

  • 2023 num controlo de entrada de texto chamado EclipseYear
  • 10 num controlo de entrada de texto chamado EclipseMonth
  • 28 num controlo de entrada de texto chamado EclipseDate
  • 13 num controlo de entrada de texto chamado EclipseHour
  • 14 num controlo de entrada de texto chamado EclipseMinute
  • 5 num controlo de entrada de texto chamado EclipseSecond
  • 231 num controlo de entrada de texto chamado EclipseMillisecond

esta fórmula devolveria 10/28/23 01:14:05.231 PM:

Text(
    DateTime(Value(EclipseYear.Text), Value(EclipseMonth.Text), Value(EclipseDate.Text), 
        Value(EclipseHour.Text), Value(EclipseMinute.Text), 
        Value(EclipseSecond.Text), Value(EclipseSecond.Millisecond)
    ), 
    "yy/mm/dd hh:mm:ss.000 AM/PM"
)