Comparteix via


Date, DateTimei Time funcions

S'aplica a: Aplicacions de llenç Copilot Studio Fluxos d'escriptori Aplicacions basades en models CLI del Power Platform Funcions del Dataverse Power Pages

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

Descripció

La Date funció converteix els valors individuals d'any, mes i dia en un Datevalor /Time . 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 Time funció converteix els valors individuals d'hora, minut, segon i, opcionalment, mil·lisegons en un Datevalor /Time . El resultat no té cap data associada.

La DateTime funció combina les Date funcions i Time en una sola funció, prenent arguments de data i hora i retornant un Datevalor /Time 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.

Time( 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) )

Time

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

DateTime

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