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).
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: