DateValue, TimeValue és DateTimeValue függvény

  • Cikk

A következőkre vonatkozik: Vászonalapú alkalmazások Asztali folyamatok Modellvezérelt alkalmazások Power Platform CLI

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

Ismertetés

  • A DateValue függvény a dátumsztringeket (például: 2014/10/01) dátum/idő értékké alakítja.

  • A TimeValue függvény az idősztringeket (például: 12:15) dátum/idő értékké alakítja.

  • A DateTimeValue függvény a dátumot és időt tartalmazó sztringeket (például: 2013. január 10., 12:13) dátum/idő értékké alakítja.

A DateValue függvény figyelmen kívül hagyja a dátumsztringben szereplő, időre vonatkozó információkat, a TimeValue függvény pedig az idősztring dátuminformációit nem veszi figyelembe.

Feljegyzés

A DateValue, a TimeValue és a DateTimeValue alapértelmezés szerint az aktuális felhasználó beállításai között megadott nyelvet használja. 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 karakterlánc például angol („en”) nyelven október 1-jét jelent, francia („fr”) nyelven viszont január 10-ét.

A dátumhoz a következő formátumok használhatók:

  • 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:

Szintaxis

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

  • Sztring – 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( Untyped )
DateTimeValue( Untyped )
TimeValue( Untyped )

  • Untyped – Kötelező megadni. Típus nélküli objektum, amely dátumot vagy időt jelöl. Az elfogadható értékek a típus nélküli szolgáltatótól függőek. A JSON esetében a típus nélküli objektum várhatóan egy JSON-sztring, amely dátumot és időt tartalmaz ISO 8601 formátumban. Az egyéb formátumokban megadott 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 viszont az October 20, 2014 értéket írta 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.