Funções Date, DateTime e Time

Aplica-se a: Aplicativos Canvas Fluxos de desktop Aplicativos orientados a modelos Power Pages 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 torna-se 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

Data( Ano, Mês, Dia )

• Ano - 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.)
• Mês - Obrigatório. Um número que varia de 1 a 12.
• Dia - Obrigatório. Um número que varia de 1 a 31.

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

• Hora - Obrigatório. Número de horas, geralmente no intervalo de 0 (12h) a 23 (23h).
• Minuto - Obrigatório. Número de minutos, geralmente no intervalo de 0 a 59.
• Segundo - 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 ] )

• Ano - 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.)
• Mês - Obrigatório. Um número que varia de 1 a 12.
• Dia - Obrigatório. Um número que varia de 1 a 31.
• Hora - Obrigatório. Número de horas, geralmente no intervalo de 0 (12h) a 23 (23h)
• Minuto - Obrigatório. Número de minutos, geralmente no intervalo de 0 a 59.
• Segundo - 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"
)