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.

Fontos

Kerülje a Csak dátum formátumot a felhasználó helyi viselkedésével . A különböző időzónákban lévő felhasználók eltérő dátumot láthatnak, ami a legtöbb esetben nem célszerű. Amikor egy felhasználó beállít egy dátumot egy modellvezérelt alkalmazásban, az időrész automatikusan az időzóna éjfélre lesz beállítva. Ez azt eredményezheti, hogy a dátum egy nappal korábban vagy később jelenik meg más felhasználók számára.

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.
• Visszaállít 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ónája)
Időzóna Független	Csak dátum	2023-10-14 23:30 (böngésző időzónája)

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).