Partajați prin


DateValue, TimeValueși DateTimeValue funcții

Se aplică la: Aplicații pânză Copilot Studio Desktop fluxuri model aplicații bazate pe modele Power Platform ClI Dataverse funcții Power Pages

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

Descriere

  • DateValue funcția convertește un șir de date (cum ar fi "01.01.1014") într-o valoare dată/oră .

  • TimeValue funcția convertește un șir de timp (cum ar fi "12:15 PM") la o valoare dată/oră .

  • DateTimeValue funcția convertește un șir de dată și oră (cum ar fi "10 ianuarie 2013 12:13 AM") într-o valoare dată/oră .

DateValue funcția ignoră informațiile de oră din șirul de dată, iar TimeValue funcția ignoră toate informațiile de dată din șirul de timp.

Notă

Funcțiile DateValue, TimeValueși DateTimeValue în mod implicit utilizează limba din setările utilizatorului curent. Puteți să-l înlocuiți pentru a vă asigura că șirurile sunt interpretate corect. De exemplu, "10.10.1920" este interpretat ca 1 octombrie în "ro" și ca 10 ianuarie în "fr".

Datele trebuie să utilizeze 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, consultați:

Sintaxă

DateValue( Șir [, Limbă] )
DateTimeValue( Șir [, Limbă ] )
TimeValue( Șir [, Limbă ] )

  • 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( Dinamic )
DateTimeValue( Dinamic )
TimeValue( Dinamic )

  • Dinamic - Obligatoriu. Valoare dinamică care reprezintă o dată sau o oră. Valorile acceptabile depind de furnizorul netipificat. Pentru JSON, se așteaptă ca valoarea dinamică să fie un șir JSON care conține o dată și o oră în format ISO 8601. Datele sau orele din alte formate au 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ă introduceți în schimb 20 octombrie 2014 :

  • 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!"