Comparteix a través de

Funcions Date, DateTime i Time

  • Article

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

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ó Hora converteix els valors individuals d'hora, minut, segon i, opcionalment, mil·lisegons en un valor de data i 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

Data(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 - Obligatòria. Nombre d'hores, normalment 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 - Obligatòria. Nombre d'hores, normalment entre 0 (12:00) i 23 (23:00)
  • 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"
)