Kuupäeva ja kellaaja veeru käitumine ja vorming
Jaotises Microsoft Dataverse saate määrata, kuidas kuupäeva- ja kellaajaväärtusi kasutajatele kuvatakse ning kuidas neid ajavööndite jaoks kohandatakse.
Kuupäeva- ja kellaajaveergude jaoks on saadaval kaks võimalust.
- Käitumine: kas kohandada ajavööndite väärtusi.
- Vorming: kas soovite kuvada väärtuse ajaosa.
Käitumine
Dataverse salvestab kõik kuupäeva- ja kellaajaväärtused UTC ajavööndisse. Kui teie rakendus kuvab kasutajate Dataverse sisestatud väärtusi või töötlemisväärtusi ja mudelipõhiseid rakendusi saab nende käitumissuvandite abil kasutaja ajavööndi jaoks kohandada.
- Kohalik kasutaja: saate reguleerida kasutaja ajavööndi väärtusi. See on vaikekäitumine. Saate selle üks kord teiseks käitumiseks muuta.
- Ajavööndist sõltumatu: ajavööndi teisendamine puudub.
- Ainult kuupäev: ajavööndi teisendamine puudub. Erinevalt ajavööndist sõltumatust ajaosast ei salvestata ajaosa.
Kasutaja ajavöönd määratakse isiklikes suvandites, Android iOS mitte Windowsi või macOS-i süsteemi ajavööndis. Kuid süsteemi ajavöönd võib mõjutada klientskripte, mis töötavad JavaScripti kuupäevadega.
Vorming
Kõigil kuupäeva- ja kellaajaveergudel on kellaajaosa, välja arvatud juhul, kui nende käitumine on Ainult kuupäev. Vorming määrab, kas kuvada väärtuse ajaosa.
- Kuupäev ja kellaaeg: kuvab väärtuse kuupäeva ja kellaaja.
- Ainult kuupäev: kuvab ainult väärtuse kuupäevaosa.
Märkus
Kasutajad saavad ajaosa siiski muuta, kui vorming on ainult kuupäev. Näiteks Web API kõnede korral või kasutades juhtelementi, millel on ajaosa. See erineb ainult kuupäeva käitumisest ·, kus ajaosa ei salvestata üldse.
Kasutamise juhised
Kasutage ajavööndist sõltumatut käitumist, kui ajavöönditeavet (nt hotelli sisseregistreerimise aegu) pole vaja. Selle valiku korral näevad kasutajad kõigis ajavööndites sama kuupäeva ja kellaaja väärtust.
Kasutage käitumist Ainult kuupäev, kui kellaaja ja ajavööndi (nt sünnipäevad või tähtpäevad) kohta pole teavet vaja. Selle valiku korral näevad kasutajad kõigis ajavööndites täpselt sama kuupäevaväärtust.
Ajavööndist sõltumatu käitumine vorminguga Ainult kuupäev on praktiliselt sama, mis ainult kuupäeva käitumine. Kasutage esimest, kui te pole kindel, kas vajate ajaosa tulevikus.
Näited
Kuvatavad väärtused
Dataverse kauplused 2023-10-15T07:30:00Z (või 2023-10-15 ainult kuupäeva käitumine). Ajavööndis UTC-8 olevad kasutajad näevad neid mudelipõhises rakenduses või vormindatud väärtuse Web API taotlusega:
| Käitumine | Vorming | Kuvatav väärtus |
|---|---|---|
| Kasutaja ajavöönd | Kuupäev ja kellaaeg | 14. oktoober 2023 23:30 |
| Kasutaja ajavöönd | Ainult kuupäev | Oktoober 14th, 2023 |
| Ajavöönd Sõltumatu | Kuupäev ja kellaaeg | 15. oktoober 2023 kell 07:30 |
| Ajavöönd Sõltumatu | Ainult kuupäev | Oktoober 15th, 2023 |
| Ainult kuupäev | - | Oktoober 15th, 2023 |
Rakenduses väärtuste sisestamine
Ajavööndis UTC-8 olevad kasutajad sisenevad October 14th, 2023, 11:30 pm mudelipõhisesse rakendusse. Väärtus salvestatakse Dataverse järgmiselt:
| Käitumine | Vorming | Salvestatud väärtus Dataverse |
|---|---|---|
| Kasutaja ajavöönd | Kuupäev ja kellaaeg | 2023-10-15T07:30:00Z |
| Kasutaja ajavöönd | Ainult kuupäev | 2023-10-15T07:30:00Z |
| Ajavöönd Sõltumatu | Kuupäev ja kellaaeg | 2023-10-14T23:30:00Z |
| Ajavöönd Sõltumatu | Ainult kuupäev | 2023-10-14T23:30:00Z |
| Ainult kuupäev | - | 2023-10-14 |
Kui kasutaja sisestab ainult kuupäeva October 14th, 2023, eeldatakse, et kellaaeg on 12:00 AM.
| Käitumine | Vorming | Salvestatud väärtus Dataverse |
|---|---|---|
| Kasutaja ajavöönd | Ainult kuupäev | 2023-10-14T08:00:00Z |
| Ajavöönd Sõltumatu | Ainult kuupäev | 2023-10-14T00:00:00Z |
| Ainult kuupäev | - | 2023-10-14 |
Sobimatute väärtuste sisestamine rakendusse
Erinevatel klientidel on kehtetu sisendi käsitlemiseks erinevad viisid. Näiteks Vaikse ookeani ajavööndis algas suveaja säästmine 12. märtsil 2023 kell 2:00, nihutades aja ühe tunni võrra edasi kella 3.00-ni. Kellaaega kella 2.00 ja 3.00 vahel sellel päeval pole olemas. Kui kasutajad proovivad sellesse ajavahemikku väärtust sisestada, võivad rakendused teha ühte järgmistest.
- Eelmisele või järgmisele kehtivale ajale üleminek
- Viimase teadaoleva väärtuse ennistamine
- Tõrketeate kuvamine.
- Ärge kuvage kellaaegu ajavahemikus 2:00 kuni 3:00 AM, et kasutajad ei saaks neid üldse valida.
Samamoodi on erinevatel klientidel erinevad viisid korduvate ajavahemike käsitlemiseks. Näiteks Vaikse ookeani ajavööndis lõppes suveaja säästmine 5. novembril 2023 kell 2:00, nihutades aja ühe tunni võrra tagasi kella 1.00-ni. Aega kella 1.00 ja 2.00 vahel sellel päeval korratakse kaks korda. Selline aeg nagu 1:30 AM võib viidata mõlemale ajavööndile. Kui teil on vaja selles vahemikus kellaaegu üheselt kuvada või sisestada, on kõige parem lülituda ajutiselt ajavööndisse, mis ei kasuta suveaja säästmist.
Hankige toorväärtusi Web API-ga
Dataverse kauplused 2023-10-15T07:30:00Z (või 2023-10-15 ainult kuupäeva käitumine). Kõigi ajavööndite kasutajad saavad need koos Web API taotlusega väärtusele:
| Käitumine | Vorming | Toores väärtus |
|---|---|---|
| Kasutaja ajavöönd | Kuupäev ja kellaaeg | 2023-10-15T07:30:00Z |
| Kasutaja ajavöönd | Ainult kuupäev | 2023-10-15T07:30:00Z |
| Ajavöönd Sõltumatu | Kuupäev ja kellaaeg | 2023-10-15T07:30:00Z |
| Ajavöönd Sõltumatu | Ainult kuupäev | 2023-10-15T07:30:00Z |
| Ainult kuupäev | - | 2023-10-15 |
Väärtuste hankimine kliendi API-ga
Ajavööndis UTC-8 olevad kasutajad sisenevad October 14th, 2023, 11:30 pm mudelipõhisesse rakendusse. Kliendi API funktsioonid (nt formContext.getAttribute(<column name>).getValue() väärtuse tagastamine rakendatud ajavööndi korrigeerimistega):
| Käitumine | Vorming | JavaScript dateValue.toUTCString() |
|---|---|---|
| Kasutaja ajavöönd | Kuupäev ja kellaaeg | 2023-10-15 07:30 (UTC) |
| Kasutaja ajavöönd | Ainult kuupäev | 2023-10-15 07:30 (UTC) |
Ajavööndist sõltumatu käitumise korral on JavaScripti kuupäeva väärtus brauseri ajavööndis.
| Käitumine | Vorming | JavaScript dateValue.toString() |
|---|---|---|
| Ajavöönd Sõltumatu | Kuupäev ja kellaaeg | 2023-10-14 23:30 (brauseri ajavöönd) |
| Ajavöönd Sõltumatu | Ainult kuupäev | 2023-10-14 23:30 (brauseri ajavöönd) |
JavaScripti kuupäevaväärtustel on alati ajakomponent. Sellepärast on ainult kuupäeva käitumise ajakomponent 12:00 AM:
| Käitumine | Vorming | JavaScript dateValue.toString() |
|---|---|---|
| Ainult kuupäev | - | 2023-10-15 00:00 (brauseri ajavöönd) |
Märkus
JavaScripti kuupäevaväärtusi mõjutab brauseri ajavöönd, mis tuleneb seadme operatsioonisüsteemi seadetest.
Kasutaja kohaliku käitumise korral tuleks kliendi API tulemust tõlgendada UTC-väärtusena. Kasutage Date.getUTCDate() Date.getUTCHours() sellega töötamiseks jne. Selle saamiseks, mida kasutaja näeb, rakendage getTimeZoneOffsetMinutes. Ärge kasutage Date.getDate() jne, Date.getHours() sest need näitavad väärtust brauseri ajavööndis.
Ajavööndist sõltumatu ja ainult kuupäevaga käitumise puhul tuleks kliendi API tulemust tõlgendada väärtusena brauseri ajavööndis. Kasutage Date.getDate() Date.getHours() sellega töötamiseks jne. Ärge kasutage Date.getUTCDate() jne, Date.getUTCHours() sest te ei pea kohandama ühegi ajavööndi jaoks.
Kasutaja kohaliku käitumise muutmine
Kui hallatav lahendus avaldaja seda ei takista, saate muuta olemasolevate kohandatud kuupäevaveergude käitumist sättest Kohalik kasutaja väärtuseks Ainult kuupäev või Ajavööndist sõltumatu. See on ühekordne muutus.
Veeru käitumise muutmine mõjutab veeruväärtusi, mis lisatakse või mida muudetakse pärast veeru käitumise muutmist. Olemasoleva veeru väärtused jäävad andmebaasi UTC ajavööndi vormingusse. Kui soovite muuta olemasolevate veeruväärtuste käitumist UTC-st ainult kuupäevaks, võib teil vaja minna arendaja abi, et teisendada andmebaasis olemasolevate kuupäeva- ja kellaajaväärtuste käitumine.
Hoiatus
Enne olemasoleva kuupäeva ja kellaaja veeru käitumise muutmist tuleb vaadata üle kõik selle veeru sõltuvused nagu ärireeglid, töövood, arvutatud veerud või ümberarvestusveerud, tagamaks, et käitumise muutmise tagajärjel ei teki probleeme. Pärast kuupäeva- ja kellaajaveeru käitumise muutmist avage iga ärireegel, töövoog, arvutatud veerg ja ümberarvestusveerg sõltuvalt muudetud veerust, vaadake teave üle ja salvestage see, et tagada kuupäeva- ja kellaajaveeru käitumise ja väärtuse kasutamine.
Käitumise muutmine lahenduse importimise ajal
Kui impordite lahenduse, mis sisaldab kuupäevaveergu kasutaja kohaliku käitumisega , saate muuta käitumise väärtuseks Ainult kuupäev või Ajavööndist sõltumatu .
Märkus
Olemasoleva hallatava kuupäeva või kuupäeva ja kellaaja veeru käitumist saate muuta ainult siis, kui olete avaldaja. Nende väljade muutmiseks tuleb uuendada lahendust, mis lisas veeru Ainult kuupäev või Kuupäev ja kellaaeg . Lisateave: Lahenduse värskendamine või täiendamine
Käitumise muutmise ärahoidmine
Kui levitate kohandatud kuupäevaveergu hallatav lahendus, takistage lahendust kasutavatel inimestel käitumist muuta, määrates hallatava atribuudi CanChangeDateTimeBehavior väärtuseks Väär. Lisateave: Veergude hallatavate atribuutide määramine
Kuupäeva- ja kellaajapäringu tehtemärgid ei toeta ainult kuupäeva käitumist
Järgmised kuupäeva ja kellaajaga seotud päringutehtemärgid ei sobi käitumise Kuupäev jaoks ainult . Kui päringus kasutatakse mõnda neist tehetest, ilmneb vale tehte erandi tõrge.
- Vanemad kui X minutit
- Vanem kui X tundi
- Viimased X tundi
- Järgmised X tundi
Vaata ka
Kuupäeva- ja kellaajaprobleemide tõrkeotsing mudelipõhistes rakendustes
Veergude loomine ja redigeerimine
Arvutatud veergude määratlemine käsitsi arvutamiseks
Hallatava veeru atribuudid
Hallatavad atribuudid
Ajaveeb: ajavöönditega töötamine Dataverse
Kuupäeva- ja kellaajaveeru käitumise ja vormingu konfigureerimine koodi abil
Märkus
Kas saaksite meile dokumentatsiooniga seotud keele-eelistustest teada anda? Osalege lühikeses uuringus. (Uuring on ingliskeelne.)
Uuringus osalemine võtab umbes seitse minutit. Isikuandmeid ei koguta (privaatsusavaldus).
Tagasiside
Varsti tulekul: 2024. aasta jooksul tühistame GitHubi probleemide funktsiooni sisutagasiside mehhanismina ja asendame selle uue tagasisidesüsteemiga. Lisateabe saamiseks vt https://aka.ms/ContentUserFeedback.
Esita ja vaata tagasisidet