Funções Date, DateTime e Time

  • Artigo

Aplica-se a: Aplicativos de tela Fluxos da área de trabalho Aplicativos baseados em modelo Power Platform CLI

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.

A função DateTime combina as funções Date e Time em uma única função, pegando argumentos de data e hora e retornando um valor de data/hora que possui componentes de data e hora.

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( Hora, Minuto, Segundo [, Milissegundos ] )

  • Hour - obrigatório. Número de horas, geralmente no intervalo de 0 (12h) a 23 (23h).
  • Minute - obrigatório. Número de minutos, geralmente no intervalo de 0 a 59.
  • Second - obrigatório. Número de segundos, geralmente no intervalo de 0 a 59.
  • Milissegundos - Opcional. Número de milissegundos, geralmente no intervalo de 0 a 999.

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

  • 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.
  • Hour - obrigatório. Número de horas, geralmente no intervalo de 0 (12h) a 23 (23h)
  • Minute - obrigatório. Número de minutos, geralmente no intervalo de 0 a 59.
  • Second - obrigatório. Número de segundos, geralmente no intervalo de 0 a 59.
  • Milissegundos - Opcional. Número de milissegundos, geralmente no intervalo de 0 a 999.

Exemplos

Date

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
  • 17 em um controle de entrada de texto chamado HireDay

esta fórmula retornaria 3/17/1979:

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

Hora

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
  • 24 em um controle de entrada de texto chamado BirthSecond

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

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

DateTime

Se um usuário digitou

  • 2023 em um controle de entrada de texto chamado EclipseYear
  • 10 em um controle de entrada de texto chamado EclipseMonth
  • 28 em um controle de entrada de texto chamado EclipseDate
  • 13 em um controle de entrada de texto chamado EclipseHour
  • 14 em um controle de entrada de texto chamado EclipseMinute
  • 5 em um controle de entrada de texto chamado EclipseSecond
  • 231 em um controle de entrada de texto chamado EclipseMillisecond

esta fórmula retornaria 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"
)