Comparteix a través de

Funcions DateValue, TimeValue i DateTimeValue

  • Article

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

Converteix una data, hora o ambdós en una cadena en un valor de data i hora.

Descripció

  • La funció DateValue converteix una cadena de data (per exemple, "10/01/2014") a un valor de data i hora.

  • La funció TimeValue converteix una cadena d'hora (per exemple, "12:15 PM") a un valor de data i hora.

  • La funció DateTimeValue converteix una cadena de data i hora (per exemple, "10 de gener de 2013, 12:13 AM") a un valor de data/hora.

La funció DateValue ignora qualsevol informació de temps en la cadena de data, i la funció TimeValue ignora la informació de data a la cadena d'hora.

Nota

Les funcions DateValue, TimeValue i DateTimeValue per defecte utilitzen la llengua de la configuració de l'usuari actual. Podeu substituir-la per assegurar-vos que s'interpreten correctament les cadenes. Per exemple, "10/1/1920" s'interpreta com a 1 d'octubre a "en " i com a 10 de gener a "fr".

Les dates han d'estar en un d'aquests formats:

  • MM/DD/YYYY o MM-DD-YYYY
  • DD/MM/YYYY o DD-MM-YYYY
  • YYYY/MM/DD o YYYY-MM-DD
  • MM/DD/YY o MM-DD-YY
  • DD/MM/YY o DD-MM-YY
  • DD Mes AAAA
  • Mes DD, AAAA

Per convertir a partir de components numèrics de data, mes i any, llegiu Date.
Per convertir a partir de components numèrics d'hora, minut i segon, llegiu Time.

Per obtenir més informació, llegiu:

Sintaxi

DateValue( Cadena [, Llengua ])
DateTimeValue( Cadena [, Llengua ])
TimeValue( Cadena [, Llengua ])

  • Cadena: obligatori. Cadena de text que conté un valor de data, hora o combinació de data i hora.
  • Llengua: opcional. Una cadena de llengua, com retornaria els dos primers caràcters de la funció Language. Si no s'especifica, s'utilitza la llengua de la configuració d'usuari actual.

DateValue ( sense tipus )
DateTimeValue( sense tipus )
TimeValue ( sense tipus )

  • Sense tipus: obligatori. Objecte sense tipus que representa una data o una hora. Els valors acceptables depenen del proveïdor sense tipus. Per a JSON, està previst que l'objecte sense tipus sigui una cadena JSON que contingui una data i una hora en format ISO 8601. Les dates o les hores en altres formats produiran un error. Considereu la possibilitat de convertir aquests valors a Text primer i, a continuació, a una data o hora. Tingueu en compte que els fusos horaris i els formats relacionats amb la configuració regional són consideracions importants quan es comunica amb sistemes externs.

Exemples

DateValue

Si escriviu 10/11/2014 en un control d'entrada de text anomenat Startdate i, a continuació, definiu la propietat Text d'una etiqueta a aquestes fórmules:

  • Convertiu una data des d'una cadena en la configuració regional de l'usuari i mostreu el resultat com una data llarga.

    Text( DateValue( Startdate.Text ), DateTimeFormat.LongDate )

    El dispositiu definit a la configuració regional en mostra l'etiqueta com a dissabte, 11 d'octubre de 2014.

    Nota

    Podeu utilitzar diverses opcions amb l'enumeració DateTimeFormat. Per mostrar una llista d'opcions, escriviu el paràmetre seguit d'un punt (.) a la barra de fórmules o comproveu la referència de la funció Text.

  • Convertiu una data des d'una cadena en la configuració regional Francès i mostreu el resultat com una data llarga. En aquest exemple, els mesos i el dia del mes s'interpreten de manera diferent de l'anglès.

    Text( DateValue( Startdate.Text, "fr" ), DateTimeFormat.LongDate )

    El dispositiu definit a la configuració regional en mostra l'etiqueta com a dilluns, 10 de novembre de 2014.

Si heu escrit 20 d'octubre de 2014 en comptes d'això:

  • Convertir una data des d'una cadena a la configuració regional de l'usuari i calcular la diferència entre dos dies, en dies

    DateDiff( DateValue( Startdate.Text ), Today() )

    El dispositiu definit a la configuració regional en mostra l'etiqueta com a 9, la qual cosa indica el nombre de dies entre l'11 d'octubre i el 20 d'octubre. La funció DateDiff també pot mostrar la diferència en mesos, trimestres o anys.

DateTimeValue

Si escriviu 10/11/2014 1:50:24.765 PM en un control d'entrada de text anomenat Inici i, a continuació, definiu la propietat Text d'una etiqueta a la fórmula següent:

  • Convertiu una cadena de data i hora a la configuració regional actual.

    Text( DateTimeValue( Start.Text ), DateTimeFormat.LongDateTime )

    El dispositiu definit a la configuració regional en mostra l'etiqueta com a dissabte, 11 d'octubre de 2014, 1:50:24 PM.

    Nota

    Podeu utilitzar diverses opcions amb l'enumeració DateTimeFormat. Per mostrar una llista d'opcions, escriviu el paràmetre seguit d'un punt (.) a la barra de fórmules o comproveu la referència de la funció Text.

  • Convertiu una cadena de data i hora a la configuració regional Francès. El mes i el dia del mes s'interpreten de manera diferent.

    Text( DateTimeValue( Start.Text, "fr"), DateTimeFormat.LongDateTime )

    El dispositiu definit a la configuració regional en mostra l'etiqueta com a dilluns, 10 de novembre de 2014, 1:50:24 PM.

  • Convertiu una cadena de data i hora a la configuració regional de l'usuari, i mostreu el resultat amb un segon fraccionat.

    Text( DateTimeValue( Start.Text ), "dddd, mmmm dd, yyyy hh:mm:ss.fff AM/PM" )

    El dispositiu definit a la configuració regional en mostra l'etiqueta com a dissabte, 11 d'octubre de 2014, 01:50:24.765 PM.

    Com a alternativa, podeu especificar hh:mm:ss.f o hh:mm:ss.ff per arrodonir l'hora a la dècima o centèsima més propera d'un segon.

TimeValue

Anomeneu un control d'entrada de text FinishedAt i definiu la propietat Text d'una etiqueta a aquesta fórmula:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Si escriviu 4:59:59.999 PM al control FinishedAt, l'etiqueta mostra "Ho heu aconseguit!"
  • Si escriviu 5:00:00.000 PM al control FinishedAt, l'etiqueta mostra "Massa tard!"