Megosztás:

DateValue, TimeValueés DateTimeValue függvények

A következőkre vonatkozik: Vászonalapú alkalmazások Copilot Studio Desktop folyamatok Modellalapú alkalmazások Power Platform CLI Dataverse függvények Power Pages

A sztringekben szereplő dátumot és/vagy időt dátum/idő értékké alakítja.

Ismertetés

  • DateValue a függvény egy dátumsztringet (például "2014.01.10.") dátum/idő értékké konvertál.

  • TimeValue a függvény egy idősztringet (például "12:15 PM") dátum/idő értékké konvertál.

  • DateTimeValue a függvény egy dátum- és idősztringet (például "2013. január 10. 12:13") dátum/idő értékké konvertál.

DateValue a függvény figyelmen kívül hagyja a dátumsztringben szereplő időadatokat, a függvény pedig TimeValue figyelmen kívül hagyja az idősztringben szereplő dátumadatokat.

Feljegyzés

A DateValue, TimeValueés DateTimeValue függvények alapértelmezés szerint az aktuális felhasználó beállításainak nyelvét használják. Ha a sztring megfelelő értelmezéséhez szükség van rá, felülbírálhatja a beállításokat. A "10/1/1920" kifejezés például október 1-ként van értelmezve az "en" és a január 10-i "fr" formátumban.

A dátumoknak az alábbi formátumok egyikét kell használniuk:

  • HH/NN/ÉÉÉÉ vagy HH-NN-ÉÉÉÉ
  • NN/HH/ÉÉÉÉ vagy NN-HH-ÉÉÉÉ
  • ÉÉÉÉ/HH/NN vagy ÉÉÉÉ-HH-NN
  • HH/NN/ÉÉ vagy HH-NN-ÉÉ
  • NN/HH/ÉÉ vagy NN-HH-ÉÉ
  • NN Hónap ÉÉÉÉ
  • Hónap NN, ÉÉÉÉ

A numerikus dátum, hónap és év összetevőinek átalakításáról a Date függvényre vonatkozó útmutatóban talál további információt.
A numerikus óra, perc és másodperc összetevőinek átalakításáról a Time függvényre vonatkozó útmutatóban talál további információt.

További információkért lásd:

Szintaxis

DateValue( Sztring [, Nyelv] )
DateTimeValue( Sztring [, Nyelv ] )
TimeValue( Sztring [, Nyelv ] )

  • Karakterlánc - Kötelező. Szöveges sztring, amelyben dátum, idő vagy a kettő kombinációjából álló érték szerepel.
  • Nyelv – Nem kötelező. Nyelvi sztring, amely általában a Language függvénnyel kapott eredmény első két karakteréből áll. Ha nincs megadva, az aktuális felhasználó beállításában szereplő nyelvet használja a rendszer.

DateValue( Dinamikus )
DateTimeValue( Dinamikus )
TimeValue( Dinamikus )

  • Dinamikus – Kötelező. Dátumot vagy időt jelképező dinamikus érték. Az elfogadható értékek a típus nélküli szolgáltatótól függőek. JSON esetén a dinamikus érték várhatóan egy JSON-sztring lesz, amely ISO 8601 formátumban tartalmaz dátumot és időt. A más formátumú dátumok és időpontok hibát eredményeznek. Az ilyen értékeket érdemes először Szöveggé, majd dátummá vagy időponttá alakítani. Ne feledje, hogy a külső rendszerekkel folytatott kommunikáció során fontos szempontok az időzónák és a területi beállításoknak megfelelő formátumok.

Példák

DateValue

Ha a 10/11/2014 értéket adja meg a Startdate szövegbeviteli vezérlőben, egy címke Text tulajdonsága pedig az alábbi képletekre van állítva:

  • Átalakít egy dátumot egy sztringről a felhasználó területi beállításai között, és hosszú dátumot ad eredményként.

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

    Az en területi beállítást használó eszközön a következőképpen jelenik meg a címke: Saturday, October 11, 2014.

    Feljegyzés

    A DateTimeFormat felsorolással több beállítás használható. A beállítások listájának megjelenítéséhez írja be a paramétert, majd írjon utána egy pont karaktert (.) a képletsávon, vagy tekintse meg a Text függvényre vonatkozó útmutatót.

  • Átalakít egy dátumot egy sztringről a francia területi beállításai között, és hosszú dátumot ad eredményként. Ebben a példában a hónapokat és a hónapok napjait az angoltól eltérő módon értelmezi a program.

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

    Az en területi beállítást használó eszközön a következőképpen jelenik meg a címke: Monday, November 10, 2014.

Ha ehelyett 2014. október 20-án lép be:

  • Átalakít egy dátumot egy sztringről a felhasználó területi beállításai között, és kiszámítja a két nap közötti különbséget napokban

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

    Az en területi beállítást használó eszközökön a címke megjelenő értéke 9, vagyis az október 11.-és október 20. közötti napok száma. A DateDiff függvénnyel hónapok, negyedévek vagy évek szerint is megjeleníthető a különbség.

DateTimeValue

Ha a Start nevű szövegbeviteli vezérlőben a 10/11/2014 1:50:24.765 PM szerepel, egy címke Text tulajdonsága pedig az alábbi képletre van állítva:

  • Mind a dátum-, mind az idősztringet átalakítja az aktuális területi beállításokban.

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

    Az en területi beállítást használó eszközön a következőképpen jelenik meg a címke: Saturday, October 11, 2014 1:50:24 PM.

    Feljegyzés

    A DateTimeFormat felsorolással több beállítás használható. A beállítások listájának megjelenítéséhez írja be a paramétert, majd írjon utána egy pont karaktert (.) a képletsávon, vagy tekintse meg a Text függvényre vonatkozó útmutatót.

  • Mind a dátum-, mind az idősztringet átalakítja a francia területi beállításokban. A hónap hónapjának és napjának értelmezése másképpen történik.

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

    Az en területi beállítást használó eszközön a következőképpen jelenik meg a címke: Monday, November 10, 2014 1:50:24 PM.

  • Mind a dátum-, mind az idősztringet átalakítja a felhasználó területi beállításai között, és tört másodperccel jeleníti meg az eredményt.

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

    Az en területi beállítást használó eszközön a következőképpen jelenik meg a címke: Saturday, October 11, 2014 01:50:24.765 PM.

    A hh:mm:ss.f vagy a hh:mm:ss.ff megadásával a legközelebbi tized- vagy századmásodpercre kerekítheti az időpontot.

TimeValue

Hozzon létre egy FinishedAt nevű szövegbeviteli vezérlőelemet, egy címke Text tulajdonságát pedig állítsa az alábbi képletre:

If( TimeValue( FinishedAt.Text ) < TimeValue( "5:00:00.000 PM" ),
    "You made it!",
    "Too late!"
)
  • Ha a FinishedAt vezérlőben a 4:59:59.999 PM szerepel, a címke a „Sikerült!” üzenetet jeleníti meg.
  • Ha a FinishedAt vezérlőben az 5:00:00.000 PM szerepel, a címke üzenete „Túl késő!” lesz.
  • Last updated on