Megosztás a következőn keresztül:


A dátum- és időoszlop viselkedése és formátuma

Itt Microsoft Dataverse megadhatja, hogy a dátum- és időértékek hogyan jelenjenek meg a felhasználók számára, és hogyan legyenek módosítva az időzónákhoz.

A dátum- és időoszlopokhoz két lehetőség áll rendelkezésre.

  • Viselkedés: Azt határozza meg, hogy módosítani kell-e az időzónák értékeit.
  • Formátum: Azt határozza meg, hogy megjelenjen-e az érték idő része.

Viselkedésmód

Dataverse az összes dátum- és időértéket UTC időzónában tárolja. Amikor az alkalmazás megjeleníti a felhasználók által megadott értékeket vagy feldolgozási értékeket, Dataverse és a modellvezérelt alkalmazások ezekkel a viselkedési beállításokkal alkalmazkodhatnak a felhasználó időzónájához.

  • Felhasználó helyi: A felhasználó időzónájának értékeinek módosítása. Ez az alapértelmezett eljárás. Ezt egyszer módosíthatja egy másik viselkedésre.
  • Időzónától független: Nincs időzóna-átalakítás.
  • Csak dátum: Nincs időzóna-konverzió. Az időzónától független időzónától eltérően az időrész nincs tárolva.

A felhasználó időzónája a személyes beállításokban van beállítva, nem a rendszer időzónája a Windows, Android iOS vagy a macOS rendszerben. A rendszer időzónája azonban hatással lehet a JavaScript-dátumokkal együttműködő ügyfélparancsfájlokra.

Formátum

Minden dátum- és időoszlophoz tartozik időrész, kivéve, ha a viselkedése Csak dátum. A formátum határozza meg, hogy megjelenjen-e az érték idő része.

  • Dátum és idő: Megjeleníti az érték dátumát és időpontját.
  • Csak dátum: Csak az érték dátum részét jeleníti meg.

Megjegyzés

A felhasználók továbbra is módosíthatják az idő részt, ha a formátum Csak dátum. Például webes API-hívásokkal vagy egy olyan vezérlő használatával, amely rendelkezik az idő résszel. Ez eltér a Csak dátum viselkedéstől ·, ahol az időrész egyáltalán nincs tárolva.

Használati irányelvek

Használja az időzónától független viselkedést, ha nincs szükség időzónaadatokra, például a szálloda bejelentkezési idejére. Ezzel a beállítással a felhasználók minden időzónában ugyanazt a dátum- és időértéket látják.

Csak a dátum viselkedést használja, ha nincs szükség a napszakra és az időzónára vonatkozó információkra, például születésnapokra vagy évfordulókra. Ezzel a beállítással a felhasználók minden időzónában pontosan ugyanazt a dátumértéket látják.

Az időzónától független viselkedés a Csak dátum formátummal gyakorlatilag megegyezik a Csak dátum formátummal . Használja az előbbit, ha nem biztos abban, hogy szüksége van-e az időrészre a jövőben.

Példák

Megjelenített értékek

Dataverse stores 2023-10-15T07:30:00Z (vagy 2023-10-15 csak dátum viselkedés esetén). A UTC-8 időzónában lévő felhasználók ezeket a modellvezérelt alkalmazásban vagy a formázott értékre vonatkozó webes API-kéréssel láthatják:

Viselkedésmód Formátum Megjelenített érték
Felhasználó helyi időzónája Dátum és idő 2023. október 14. 23:30
Felhasználó helyi időzónája Csak dátum 2023. október 14.
Időzóna Független Dátum és idő 2023. október 15. 7:30
Időzóna Független Csak dátum 2023. október 15.
Csak dátum - 2023. október 15.

Értékek megadása egy alkalmazásban

A UTC-8 időzónában lévő felhasználók egy modellvezérelt alkalmazásban lépnek be October 14th, 2023, 11:30 pm . Az érték a következőben kerül mentésre Dataverse :

Viselkedésmód Formátum Megtakarított érték Dataverse
Felhasználó helyi időzónája Dátum és idő 2023-10-15T07:30:00Z
Felhasználó helyi időzónája Csak dátum 2023-10-15T07:30:00Z
Időzóna Független Dátum és idő 2023-10-14T23:30:00Z
Időzóna Független Csak dátum 2023-10-14T23:30:00Z
Csak dátum - 2023-10-14

Ha a felhasználó csak a dátumot October 14th, 2023 adja meg, az időrész 12:00 AM lesz.

Viselkedésmód Formátum Megtakarított érték Dataverse
Felhasználó helyi időzónája Csak dátum 2023-10-14T08:00:00Z
Időzóna Független Csak dátum 2023-10-14T00:00:00Z
Csak dátum - 2023-10-14

Érvénytelen értékek megadása egy alkalmazásban

A különböző ügyfelek különböző módon kezelik az érvénytelen bevitelt. Például a csendes-óceáni időzónában a nyári időszámítás 2023. március 12-én hajnali 2:00-kor kezdődött, és egy órával előrehozta az időt 3:00-ra. Az adott napon 2:00 és 3:00 óra közötti idő nem létezik. Amikor a felhasználók megpróbálnak megadni egy értéket ebben az időtartományban, az alkalmazások a következők egyikét tehetik:

  • Váltás az előző vagy a következő érvényes időpontra.
  • Térjen vissza az utolsó ismert értékre.
  • Hibaüzenet megjelenítése.
  • Ne jelenítse meg a 2:00 és 3:00 óra közötti időpontokat az időválasztóban, hogy a felhasználók ne választhassák ki őket.

Hasonlóképpen, a különböző ügyfelek különböző módon kezelik az ismétlődő időtartományokat. Például a csendes-óceáni időzónában a nyári időszámítás 2023. november 5-én hajnali 2:00-kor ért véget, egy órával visszafelé haladva 1:00-ra. Az adott napon 1:00 és 2:00 óra közötti idő kétszer ismétlődik. Az olyan időpontok, mint az 1:30, bármelyik időzónára utalhatnak. Ha egyértelműen meg kell jelenítenie vagy be kell írnia az adott tartományba eső időpontokat, a legjobb, ha ideiglenesen olyan időzónára vált, amely nem használja a nyári időszámítást.

Nyers értékek lekérése webes API-val

Dataverse stores 2023-10-15T07:30:00Z (vagy 2023-10-15 csak dátum viselkedés esetén). Az összes időzóna felhasználói ezeket egy webes API-kéréssel kapják meg az értékre:

Viselkedésmód Formátum Nyers érték
Felhasználó helyi időzónája Dátum és idő 2023-10-15T07:30:00Z
Felhasználó helyi időzónája Csak dátum 2023-10-15T07:30:00Z
Időzóna Független Dátum és idő 2023-10-15T07:30:00Z
Időzóna Független Csak dátum 2023-10-15T07:30:00Z
Csak dátum - 2023-10-15

Értékek lekérte az ügyfél API-val

A UTC-8 időzónában lévő felhasználók egy modellvezérelt alkalmazásban lépnek be October 14th, 2023, 11:30 pm . Az ügyfél API-függvényei például formContext.getAttribute(<column name>).getValue() az értéket adják vissza az időzóna-módosításokkal:

Viselkedésmód Formátum JavaScript dateValue.toUTCString()
Felhasználó helyi időzónája Dátum és idő 2023-10-15 07:30 (UTC)
Felhasználó helyi időzónája Csak dátum 2023-10-15 07:30 (UTC)

Az időzónától független viselkedés esetén a JavaScript Date érték a böngésző időzónájában van:

Viselkedésmód Formátum JavaScript dateValue.toString()
Időzóna Független Dátum és idő 2023-10-14 23:30 (böngésző időzóna)
Időzóna Független Csak dátum 2023-10-14 23:30 (böngésző időzóna)

A JavaScript-dátumértékek mindig tartalmaznak időösszetevőt. Ezért a Csak dátum viselkedés időösszetevője 12:00 AM:

Viselkedésmód Formátum JavaScript dateValue.toString()
Csak dátum - 2023-10-15 00:00 (böngésző időzónája)

Megjegyzés

A JavaScript-dátumértékeket a böngésző időzónája befolyásolja, amely az eszköz operációs rendszerének beállításaiból származik.

A felhasználó helyi viselkedése esetén az ügyfél API-eredményét UTC-értékként kell értelmezni. Használja Date.getUTCDate() Date.getUTCHours() stb., hogy dolgozzon vele. A felhasználó által látottak lekéréséhez alkalmazza a getTimeZoneOffsetMinutes metódust. Ne használja Date.getDate(), Date.getHours() stb., mert ezek a böngésző időzónájában jelenítik meg az értéket.

Az Időzónától független és a Csak dátum viselkedés esetén az ügyfél API eredményét a böngésző időzónájának értékeként kell értelmezni. Használja Date.getDate() Date.getHours() stb., hogy dolgozzon vele. Ne használja Date.getUTCDate(), Date.getUTCHours(), és így tovább, mert nem kell beállítania egyetlen időzónát sem.

A felhasználó helyi viselkedésének módosítása

Ha egy felügyelt megoldás közzétevője ezt nem akadályozza meg, módosíthatja a meglévő egyéni dátumoszlopok viselkedését Felhasználó helyi értékről Csak dátum vagy Időzónától független értékre . Ez egy egyszeri változás.

Az oszlop viselkedésének megváltoztatása befolyásolja azon oszlopértékeket, amelyek az oszlopviselkedés változtatása után lettek hozzáadva vagy módosítva. A meglévő oszlopértékek UTC időzóna-formátumban maradnak az adatbázisban. Ha a meglévő oszlopértékek viselkedését UTC-ről csak dátumra szeretné módosítani, szükség lehet egy fejlesztő segítségére az adatbázisban meglévő dátum- és időértékek viselkedésének konvertálásához.

Figyelmeztetés

Figyelmeztetés: Mielőtt megváltoztatja egy meglévő dátum- és idő oszlop viselkedését, a problémák elkerülése érdekében tekintse meg az oszlop összes függőségét, pl. az üzleti szabályokat, a munkafolyamatokat, a számított és az összesítő oszlopokat. Miután módosította egy dátum- és időoszlop viselkedését, nyisson meg minden olyan üzleti szabályt, munkafolyamatot, számított oszlopot és összesítő oszlopot, amely a módosított oszloptól függ, tekintse át az adatokat, és mentse őket, hogy biztosan a legújabb dátum- és időoszlop viselkedését és értékét használja.

Viselkedés módosítása egy megoldás importálása során

Ha olyan megoldást importál, amely a felhasználó helyi viselkedését tartalmazó Dátum oszlopot tartalmaz, módosíthatja a viselkedést Csak dátum vagy Időzónától független értékre.

Megjegyzés

A meglévő felügyelt Csak dátum vagy Dátum és idő oszlop viselkedését csak akkor módosíthatja, ha Ön a közzétevő. A mezők módosításához frissíteni kell azt a megoldást, amely hozzáadta a Csak dátum vagy a Dátum és idő oszlopot. További információ: Megoldás frissítése vagy verzióváltás

A viselkedés módosításának megváltoztatása

Ha egyéni dátumoszlopot terjeszt egy felügyelt megoldás, a CanChangeDateTimeBehavior felügyelt tulajdonság False értékre állításával megakadályozhatja, hogy a megoldást használó személyek megváltoztassák a viselkedést. További információ: Az oszlopok felügyelt tulajdonságainak beállítása

A dátum- és időlekérdezési operátorok nem támogatottak a Csak dátum viselkedés esetén

A következő dátummal és idővel kapcsolatos lekérdezési operátorok érvénytelenek a Csak dátum viselkedés esetén. Érvénytelen operátor-kivétel hiba történik, amikor ezen operátorok egyikét használja a lekérdezésben.

  • X percnél régebbi
  • X óránál régebbi
  • Előző X óra
  • A következő X óra

Kapcsolódó információk

Modellvezérelt alkalmazások dátummal és idővel kapcsolatos problémáinak elhárítása
Oszlopok létrehozása és szerkesztése
Számított oszlopok definiálása a manuális számítások automatizálásához
Oszlop által felügyelt tulajdonságok
Felügyelt tulajdonságok
Blog: Időzónák használata a Dataverse
A dátum- és időoszlop viselkedésének és formátumának konfigurálása kód használatával

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).