Funcions Date, DateTime i Time

S'aplica a: Aplicacions de llenç Fluxos d'escriptori Aplicacions Power Pages Power Platform basades en models CLI

Converteix els components de data i hora a un valor de data/hora.

Descripció

La funció Date converteix els valors d'un any, un mes i un dia individualment a un valor de data/hora. La part del valor corresponen a l'hora és la mitjanit.

• Si Any està entre 0 i 1899 (inclòs), la funció afegeix aquest valor a 1900 per calcular l'any. 70 es converteix en 1970.
• Si Mes és inferior a 1 o superior a 12, el resultat resta o suma tots aquests mesos des del principi de l'any especificat.
• Si Dia és superior al nombre de dies del mes especificat, la funció afegeix tots aquests dies al primer dia del mes i torna la data corresponent del mes següent. Si Dia és inferior a 1, la funció resta tots aquests dies més 1 al primer dia del mes especificat.

La funció Time converteix valors individuals d'hora, minut, segon i, opcionalment, mil·lisegon en un valor de data/hora. El resultat no té cap data associada.

La funció DateTime combina les funcions Data i hora en una sola funció, prenent arguments de data i hora i retornant un valor Data/Hora que té components de data i hora.

Vegeu les funcions DateValue, TimeValue i DateTimeValue per obtenir informació sobre com convertir una cadena en un valor.

Vegeu també Treballar amb dates i hores per obtenir més informació.

Sintaxi

Date( Any, Mes, Dia )

• Any: obligatori. Els nombres més grans que 1899 s'interpreten com a absoluts (1980 s'interpreta com a 1980); els números que oscil·len entre 0 i 1899 s'interpreten com a relatius a 1900. (Per exemple, 80 s'interpreta com a 1980.)
• Mes: obligatori. Nombre que oscil·la entre 1 i 12.
• Dia: obligatori. Nombre que oscil·la entre 1 i 31.

Temps(hora, minut, segon[, mil·lisegons] )

• Hora: obligatori. Nombre d'hores, generalment en el rang de 0 (12:00 AM) a 23 (11:00 PM).
• Minut: obligatori. Nombre de minuts, normalment en el rang de 0 a 59.
• Segon: obligatori. Nombre de segons, normalment en el rang de 0 a 59.
• Mil·lisegons - Opcional. Nombre de mil·lisegons, normalment en el rang de 0 a 999.

DateTime ( any, mes, dia, hora , minut, segon [, mil·lisegons ] )

• Any: obligatori. Els nombres més grans que 1899 s'interpreten com a absoluts (1980 s'interpreta com a 1980); els números que oscil·len entre 0 i 1899 s'interpreten com a relatius a 1900. (Per exemple, 80 s'interpreta com a 1980.)
• Mes: obligatori. Nombre que oscil·la entre 1 i 12.
• Dia: obligatori. Nombre que oscil·la entre 1 i 31.
• Hora: obligatori. Nombre d'hores, generalment en el rang de 0 (12:00 AM) a 23 (11:00 PM)
• Minut: obligatori. Nombre de minuts, normalment en el rang de 0 a 59.
• Segon: obligatori. Nombre de segons, normalment en el rang de 0 a 59.
• Mil·lisegons - Opcional. Nombre de mil·lisegons, normalment en el rang de 0 a 999.

Exemples

Date

Si un usuari ha escrit

• 1979 en un control d'entrada de text anomenat HireYear
• 3 en un control d'entrada de text anomenat HireMonth
• 17 en un control d'entrada de text anomenat HireDay

Aquesta fórmula retornaria 3/17/1979:

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

Hora

Si un usuari ha escrit

• 14 en un control d'entrada de text anomenat BirthHour
• 50 en un control d'entrada de text anomenat BirthMinute
• 24 en un control d'entrada de text anomenat BirthSecond

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

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

Data/hora

Si un usuari ha escrit

• 2023 en un control d'entrada de text anomenat EclipseYear
• 10 en un control d'entrada de text anomenat EclipseMonth
• 28 en un control d'entrada de text anomenat EclipseDate
• 13 en un control d'entrada de text anomenat EclipseHour
• 14 en un control d'entrada de text anomenat EclipseMinute
• 5 en un control d'entrada de text anomenat EclipseSecond
• 231 en un control d'entrada de text anomenat EclipseMillisecond

Aquesta 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"
)