Kuupäeva ja kellaaja veeru käitumine ja vorming

Sisse Microsoft Dataverse saate määrata, kuidas kuupäeva ja kellaaja väärtusi kasutajatele kuvatakse ning kuidas neid ajavööndite jaoks kohandatakse.

Lisaks enamiku veergude standardsetele omadustele on kuupäeva ja kellaaja veergudel kaks lisaomadust:

• Ajavööndi kohandamine: kas kohandada väärtusi ajavööndite jaoks.
• Vorming: kas kuvada väärtuse ajaosa.

Ajavööndi kohandamine

Dataverse talletab kõik kuupäeva ja kellaaja väärtused UTC ajavööndis. Kui teie rakendus kuvab kasutajate Dataverse sisestatud väärtusi või töötlemisväärtusi ja mudelipõhised rakendused saavad nende käitumissuvandite abil kohandada kasutaja ajavööndit.

• Kasutaja kohalik: kohandage kasutaja ajavööndi väärtusi. See on kuupäeva ja kellaaja vormingu vaikekäitumine . Saate selle ühe korra muuta mõneks muuks käitumiseks.
• Ajavööndist sõltumatu: ajavööndi teisendamine puudub. See on vormingu Ainult kuupäev vaikekäitumine .

Määra kasutaja ajavöönd isiklikes valikutes, mitte Windowsi, Androidi, iOS-i või macOS-i süsteemi ajavööndis. Süsteemi ajavöönd võib aga mõjutada kliendi skripte, mis töötavad JavaScripti kuupäevadega.

Vorming

Kõigil kuupäeva ja kellaaja veergudel on ajaosa, välja arvatud juhul, kui nende käitumine on ainult kuupäev. Vorming määrab, kas kuvada väärtuse ajaosa.

• Date and time (Kuupäev ja kellaaeg): kuvab väärtuse kuupäeva ja kellaaja.
• Ainult kuupäev: kuvab ainult väärtuse kuupäevaosa.

Märkus.

Kasutajad saavad endiselt kellaajaosa muuta, kui vorming on Ainult kuupäev. Näiteks kasutades veebipõhiseid API kutseid või juhtimist, millel on ajaosa. See käitumine erineb ainult kuupäevakäitumisest, kus ajaosa üldse ei salvestata.

Kasutamise juhised

Kasuta ajavööndi sõltumatut , kui ajavööndi info pole vajalik, näiteks hotelli sisseregistreerimise ajad. Selle valiku korral näevad kõigi ajavööndite kasutajad sama kuupäeva ja kellaaja väärtust.

Kasuta kuupäeva ainult siis, kui teave päeva aja ja ajavööndi kohta pole vajalik, näiteks sünnipäevade või aastapäevade puhul. Selle valiku korral näevad kõigi ajavööndite kasutajad täpselt sama kuupäevaväärtust.

Ajavööndist sõltumatu valik ainult kuupäevaga on praktiliselt sama, mis veeru määramine ainult kuupäevaks. Kasutage esimest, kui te pole kindel, kas vajate ajaosa tulevikus.

Oluline

Vältige ainult kuupäevavormingut kasutaja kohaliku käitumisega . Erinevates ajavööndites olevad kasutajad võivad näha erinevat kuupäeva, mis pole enamiku stsenaariumide puhul ette nähtud. Kui kasutaja määrab kuupäeva mudelipõhises rakenduses, muutub ajaosa automaatselt tema ajavööndi keskööle. See võib põhjustada kuupäeva kuvamise teiste kasutajate jaoks päev varem või hiljem.

Näited

Kuvatavad väärtused

Dataverse kauplused 2023-10-15T07:30:00Z (või 2023-10-15 ainult kuupäeva käitumise jaoks ). Ajavööndi UTC-8 kasutajad näevad neid mudelipõhises rakenduses või vormindatud väärtuse veebi-API päringuga.

Käitumine	Vorming	Kuva väärtus
Kasutaja ajavöönd	Kuupäev ja kellaaeg	Oktoober 14th, 2023, 11: 30 pm
Kasutaja ajavöönd	Ainult kuupäev	Oktoober 14th, 2023
Ajavöönd Sõltumatu	Kuupäev ja kellaaeg	Oktoober 15th, 2023, 7: 30 am
Ajavöönd Sõltumatu	Ainult kuupäev	Oktoober 15, 2023
Ainult kuupäev	-	Oktoober 15, 2023

Väärtuste sisestamine rakendusse

Ajavööndi UTC-8 kasutajad sisestavad October 14th, 2023, 11:30 pm mudelipõhise rakenduse. 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 kellaaja osa on 12:00.

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 rakenduses

Erinevatel klientidel on kehtetu sisendi käsitlemiseks erinevad viisid. Näiteks Vaikse ookeani ajavööndis algas suveaeg 12. märtsil 2023 kell 2:00 öösel, nihutades aega ühe tunni võrra edasi kell 3:00 öösel. Kellaaega vahemikus 2:00 kuni 3:00 sel päeval pole olemas. Kui kasutajad proovivad sisestada väärtust selles ajavahemikus, võivad rakendused teha ühte järgmistest.

• Eelmise või järgmise kehtiva aja muutmine.
• Viimase teadaoleva väärtuse taastamine.
• Veateate kuvamine.
• Ärge kuvage kellaajavalijas kellaaegu vahemikus 2:00 kuni 3:00, et kasutajad ei saaks neid üldse valida.

Samamoodi on erinevatel klientidel korduvate ajavahemike käsitlemiseks erinevad viisid. Näiteks Vaikse ookeani ajavööndis lõppes suveaeg 5. novembril 2023 kell 2:00 öösel, nihutades aega ühe tunni võrra tagasi kell 1:00 öösel. Kellaaega vahemikus 1:00 kuni 2:00 sel päeval korratakse kaks korda. Kellaaeg nagu 1:30 võib viidata mõlemale ajavööndile. Kui teil on vaja selles vahemikus üheselt kuvada või sisestada kellaajad, on kõige parem lülituda ajutiselt ajavööndile, mis ei kasuta suveaega.

Hankige töötlemata väärtused veebi API abil

Dataverse kauplused 2023-10-15T07:30:00Z (või 2023-10-15 ainult kuupäeva käitumise jaoks ). Kõikide ajavööndite kasutajad saavad need väärtused veebipõhise API päringuga selle väärtuse jaoks:

Käitumine	Vorming	Toorvää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

Hankige väärtusi kliendi API abil

Ajavööndi UTC-8 kasutajad sisestavad October 14th, 2023, 11:30 pm mudelipõhise rakenduse. Kliendi API funktsioonid (nt formContext.getAttribute(<column name>).getValue() tagastavad väärtuse koos rakendatud ajavööndi korrigeerimisega):

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 puhul 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 kellaajakomponent. Sellepärast on ainult kuupäeva käitumise ajakomponent 12:00.

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 puhul tõlgenda kliendi API tulemust UTC väärtusena. Kasuta Date.getUTCDate() või Date.getUTCHours() tööta sellega. Kasutaja kuvatava saamiseks rakendage getTimeZoneOffsetMinutes. Ära kasuta Date.getDate() või Date.getHours() sest need funktsioonid näitavad väärtust brauseri ajavööndis.

Ajavööndist sõltumatu ja ainult kuupäeva käitumise korral tõlgendage kliendi API tulemust kui väärtust brauseri ajavööndis. Kasuta Date.getDate() või Date.getHours() tööta sellega. Ära kasuta Date.getUTCDate() või Date.getUTCHours() sest sa ei pea ajavööndiga kohanema.

Kasutaja kohaliku käitumise muutmine

Kui hallatava lahenduse avaldaja ei takista kohaliku käitumise muutmist, saab olemasolevate kohandatud kuupäevaveergude käitumist muuta kasutaja kohalikust ainult kuupäevaks või ajavööndist sõltumatuks. See on ühekordne muudatus.

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. Olemasolevate veeruväärtuste käitumise muutmiseks UTC-lt väärtusele Ainult kuupäev võib teil olla vaja arendaja abi, et teisendada andmebaasis olemasolevate kuupäeva- ja kellaajaväärtuste käitumine.

Hoiatus

Enne olemasoleva kuupäeva ja kellaaja veeru käitumise muutmist vaata üle kõik veeru sõltuvused, nagu ärireeglid, töövood, arvutatud veerud või rollup-veerud, et veenduda, et käitumise muutmisega ei teki probleeme. Pärast kuupäeva ja kellaaja veeru käitumise muutmist avage iga ärireegel, töövoog, arvutatud veerg ja ümberarvestusveerg, mis sõltub muudetud veerust, vaadake teave üle ja salvestage see, et veenduda, et kasutatakse viimase kuupäeva ja kellaaja veeru käitumist ja väärtust.

Käitumise muutmine lahenduse importimise ajal

Kui impordid lahenduse, mis sisaldab kuupäevaveeru kasutaja lokaalselt, saad käitumist muuta ainult kuupäevaks või ajavööndist sõltumatuks.

Märkus.

Olemasoleva hallatava veeru Ainult kuupäev või Kuupäev ja kellaaeg käitumist saate muuta ainult siis, kui olete avaldaja. Nende väljade muutmiseks tuleb täiendada lahendust, mis lisas veeru Ainult kuupäev või Kuupäev ja kellaaeg . Lisateave: Lahenduse täiendamine või värskendamine

Käitumise muutmise ärahoidmine

Kui levitate hallatavas lahenduses kohandatud kuupäevaveergu, takistage teie lahendust kasutavatel inimestel käitumist muutmast, määrates hallatava atribuudi CanChangeDateTimeBehavior väärtuseks Väär. Lisateave: Veergude hallatavate atribuutide seadmine

Kuupäeva ja kellaaja päringu tehtemärke ei toetata ainult kuupäeva käitumise puhul

Järgmised kuupäeva ja kellaajaga seotud päringutehtemärgid on käitumise Ainult kuupäev puhul kehtetud. 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

Vt ka

Kuupäeva ja kellaaja probleemide tõrkeotsing mudelipõhistes rakendustes
Veergude loomine ja redigeerimine
Arvutatud veergude määratlemine käsitsi arvutuste automatiseerimiseks
Veeru hallatavad atribuudid
Hallatavad omadused
Ajaveeb: Ajavöönditega töötamine Dataverse
Kuupäeva ja kellaaja veeru käitumise ja vormingu konfigureerimine koodi abil