Partajați prin

Funcțiile DateValue, TimeValue și DateTimeValue

  • Articol

Se aplică pentru: planșă de lucru aplicații Fluxuri desktop Aplicații bazate pe model Power Pages Power Platform CLI

Convertește data, ora sau ambele într-un șir la o valoare dată/oră.

Descriere

  • DateValue funcția convertește un șir de dată (de exemplu, „10/01/2014”) într-o date/ timp valoare.

  • Funcția TimeValue convertește un șir de timp (de exemplu, „12:15 PM”) într-o data/ora valoare.

  • DateTimeValue funcția convertește un șir de dată și oră (de exemplu, „10 ianuarie, 2013 12:13 AM”) în a data/ora valoare.

Funcția DateValue ignoră orice informație de oră din șirul de dată, iar funcția TimeValue ignoră orice informație de dată din șirul de timp.

Notă

Funcțiile DateValue, TimeValue și DateTimeValue folosesc în mod implicit limba din setările curente ale utilizatorului. Puteți să-l înlocuiți pentru a vă asigura că șirurile sunt interpretate corect. De exemplu, "10/1/1920" este interpretat ca 1 Octombrie în "en" și ca 10 ianuarie în "fr".

Datele trebuie să fie într-unul dintre aceste formate:

  • LL/ZZ/AAAA sau LL-ZZ-AAAA
  • ZZ/LL/AAAA sau ZZ-LL-AAAA
  • AAAA/LL/ZZ sau AAAA-LL-ZZ
  • LL/ZZ/AA sau LL-ZZ-AA
  • ZZ/LL/AA sau ZZ-LL-AA
  • ZZ lună AAAA
  • Luna ZZ, AAAA

Pentru a efectua conversia din componente numerice dată, lună și an, citiți Date.
Pentru a efectua conversia din componente numerice oră, minut și secundă, citiți Time.

Pentru mai multe informații, citiți:

Sintaxă

DateValue( Șir [, Language ])
DateTimeValue( Șir [, Language ])
TimeValue( String [, Language ])

  • String - Obligatoriu. Un șir text care conține o dată, o oră sau o combinație de dată și oră.
  • Limbă - Opțional. Un șir limbă, de exemplu, ar fi returnată de primele două caractere din funcția Language. Dacă nu este furnizată, se folosește limba setărilor curente ale utilizatorului.

DateValue( Neintrodusă )
DateTimeValue( Neintrodus )
TimeValue( Neintrodus )

  • Untyped - Obligatoriu. obiect fără tip care reprezintă o dată sau o oră. Valorile acceptabile depind de furnizorul netipificat. Pentru JSON, obiectul netipizat este de așteptat să fie un șir JSON care conține o dată și o oră în format ISO 8601. Datele sau orele în alte formate vor avea ca rezultat o eroare. Luați în considerare convertirea acestor valori în Text mai întâi, apoi într-o dată sau oră. Rețineți că fusurile orare și formatele legate de locație sunt considerații importante atunci când comunicați cu sisteme externe.

Exemple

DateValue

Dacă tastați 10/11/2014 într-un control de introducere a textului numit Startdate, apoi setați proprietatea Text a unei etichete pentru aceste formule:

  • Convertiți o dată dintr-un șir în setările regionale ale utilizatorului și afișați rezultatul ca o dată lungă.

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

    Dispozitivul setat la setările regionale ro arată eticheta ca Sâmbătă, 11 octombrie 2014.

    Notă

    Puteți utiliza mai multe opțiuni cu enumerarea DateTimeFormat. Pentru a afișa o listă de opțiuni, tastați parametrul urmat de un punct (.) în bara de formule sau bifați referința de funcție Text.

  • Convertiți o dată dintr-un șir în setările regionale în română și afișați rezultatul ca o dată lungă. În acest exemplu, lunile și ziua lunii sunt interpretate diferit de engleză.

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

    Dispozitivul setat la setările regionale ro arată eticheta ca Luni, 10 noiembrie 2014.

Dacă ați tastat 20 octombrie 2014 în loc de:

  • Convertiți o dată dintr-un șir în setările regionale ale utilizatorului și calculați diferența dintre două zile, în zile

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

    Dispozitiv setat la setările regionale ro arată eticheta ca 9, care indică numărul de zile între 11 și 20 octombrie. Funcția DateDiff poate arăta, de asemenea, diferența în luni, trimestre sau ani.

DateTimeValue

Dacă ați tastat 10/11/2014 1:50:24.765 PM într-un control de introducere a textului numit Start, apoi setați proprietatea Text a unei etichete pentru următoarea formulă:

  • Convertiți un șir dată și oră în setările regionale curente.

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

    Dispozitivul setat la setările regionale ro arată eticheta ca Sâmbătă, 11 octombrie 2014 1:50:24 PM.

    Notă

    Puteți utiliza mai multe opțiuni cu enumerarea DateTimeFormat. Pentru a afișa o listă de opțiuni, tastați parametrul urmat de un punct (.) în bara de formule sau bifați referința de funcție Text.

  • Convertiți un șir dată și oră în setările regionale în română. Luna și ziua lunii sunt interpretate diferit.

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

    Dispozitivul setat la setările regionale ro arată eticheta ca Luni, 10 noiembrie 2014 1:50:24 PM.

  • Convertiți un șir dată și oră în setările regionale ale utilizatorului și afișați rezultatul cu o secundă fracționară.

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

    Dispozitivul setat la setările regionale ro arată eticheta ca Sâmbătă, 11 octombrie 2014 01:50:24.765 PM.

    Ca alternativă puteți specifica hh:mm:ss.f sau hh:mm:ss.ff pentru a rotunji ora până la cea mai apropiată zecime sau sutime a unei secunde.

TimeValue

Denumiți un control de introducere a textului FinishedAt și setați proprietatea Text a unei etichete la această formulă:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Dacă tastați 4:59:59.999 PM în controlul FinishedAt, eticheta arată "Ai reușit!"
  • Dacă tastați 5:00:00.000 PM în controlul FinishedAt, eticheta arată "Prea târziu!"