Obnašanje in oblika stolpca datuma in časa

V Microsoft Dataverse lahko določite, kako so vrednosti datuma in časa prikazane uporabnikom in kako so prilagojene za časovne pasove.

Za stolpce z datumom in uro sta na voljo dve možnosti.

• Vedenje: Ali je treba prilagoditi vrednosti za časovne pasove.
• Format: Ali naj se prikaže časovni del vrednosti.

Način delovanja

Dataverse shrani vse vrednosti datuma in časa v časovnem pasu UTC. Ko vaša aplikacija prikazuje vrednosti ali vrednosti obdelave, ki so jih vnesli uporabniki, Dataverse in aplikacije, ki temeljijo na modelu, se lahko prilagodijo uporabnikovemu časovnemu pasu s temi možnostmi Vedenje .

• Lokalni uporabnik: Prilagodite vrednosti za uporabnikov časovni pas. To je privzeto vedenje. To lahko enkrat spremenite v drugo vedenje.
• Neodvisno od časovnega pasu: Brez pretvorbe časovnega pasu.
• Samo datum: Brez pretvorbe časovnega pasu. Za razliko od neodvisnega od časovnega pasu, časovni del ni shranjen.

Uporabnikov časovni pas je nastavljen v osebnih možnostih, ne v sistemskem časovnem pasu v sistemu Windows, Android, iOS ali macOS. Vendar lahko sistemski časovni pas vpliva na odjemalske skripte, ki delujejo z datumi JavaScript.

Oblikovanje

Vsi stolpci z datumom in uro imajo časovni del, razen če je njegovo vedenje Samo datum. Format določa, ali naj se prikaže časovni del vrednosti.

• Datum in čas: prikaže datum in čas vrednosti.
• Samo datum: prikaže samo datumski del vrednosti.

Opomba

Uporabniki lahko še vedno spremenijo časovni del, če je Oblika Samo datum. Na primer s klici spletnega API-ja ali z uporabo kontrolnika, ki ima časovni del. To se razlikuje od Samo datum Vedenje, kjer časovni del sploh ni shranjen.

Navodila za uporabo

Uporabite neodvisno od časovnega pasu obnašanje, ko podatki o časovnem pasu niso potrebni, na primer čas prijave v hotel. S to izbiro uporabniki v vseh časovnih pasovih vidijo isto vrednost datuma in časa.

Uporabite vedenje Samo datum ko podatki o času dneva in časovnem pasu niso potrebni, kot so rojstni dnevi ali obletnice. S to izbiro uporabniki v vseh časovnih pasovih vidijo popolnoma isto vrednost datuma.

Neodvisno od časovnega pasu obnašanje z samo datumom je praktično enako kot samo datum obnašanje. Uporabite prvo, če niste prepričani, ali boste potrebovali časovni del v prihodnosti.

Primeri

Prikaz vrednosti

Dataverse trgovine 2023-10-15T07:30:00Z (ali 2023-10-15 za samo datum vedenje). Uporabniki v časovnem pasu UTC-8 to vidijo v aplikaciji, ki temelji na modelu, ali z zahtevo spletnega API-ja za oblikovano vrednost:

Način delovanja	Oblikovanje	Prikazana vrednost
Lokalno pri uporabniku	Datum in ura	14. oktober 2023, 23.30
Lokalno pri uporabniku	Samo datum	14. oktober 2023
Neodvisno od časovnega pasu	Datum in ura	15. oktober 2023, 7.30
Neodvisno od časovnega pasu	Samo datum	15. oktober 2023
Samo datum	-	15. oktober 2023

Vnesite vrednosti v aplikacijo

Uporabniki v časovnem pasu UTC-8 vstopijo October 14th, 2023, 11:30 pm v aplikacijo, ki temelji na modelu. Vrednost je shranjena v Dataverse kot:

Način delovanja	Oblikovanje	Vrednost shranjena v Dataverse
Lokalno pri uporabniku	Datum in ura	2023-10-15T07:30:00Z
Lokalno pri uporabniku	Samo datum	2023-10-15T07:30:00Z
Neodvisno od časovnega pasu	Datum in ura	2023-10-14T23:30:00Z
Neodvisno od časovnega pasu	Samo datum	2023-10-14T23:30:00Z
Samo datum	-	2023-10-14

Če uporabnik vnese samo datum October 14th, 2023, se domneva, da je časovni del 12:00.

Način delovanja	Oblikovanje	Vrednost shranjena v Dataverse
Lokalno pri uporabniku	Samo datum	2023-10-14T08:00:00Z
Neodvisno od časovnega pasu	Samo datum	2023-10-14T00:00:00Z
Samo datum	-	2023-10-14

V aplikacijo vnesite neveljavne vrednosti

Različni odjemalci imajo različne načine za obravnavanje neveljavnih vnosov. Na primer, v pacifiškem časovnem pasu se je poletni čas začel 12. marca 2023 ob 2.00 zjutraj, s čimer se je čas premaknil za eno uro naprej na 3.00 zjutraj. Čas med 2.00 in 3.00 na ta dan ne obstaja. Ko uporabniki poskušajo vnesti vrednost v tem časovnem obdobju, lahko aplikacije naredijo nekaj od naslednjega:

• Spremeni na prejšnji ali naslednji veljavni čas.
• Vrnitev na zadnjo znano vrednost.
• Prikaži sporočilo o napaki.
• Ne prikaži časov med 2.00 in 3.00 zjutraj v izbirniku časa, da jih uporabniki ne bi mogli izbrati.

Podobno imajo različne stranke različne načine za obravnavanje ponavljajočih se časovnih razponov. Na primer, v pacifiškem časovnem pasu se je poletni čas končal 5. novembra 2023 ob 2:00 zjutraj, s čimer se je čas premaknil za eno uro nazaj na 1:00 zjutraj. Čas med 1.00 in 2.00 na ta dan se dvakrat ponovi. Čas, kot je 1:30 zjutraj, se lahko nanaša na kateri koli časovni pas. Če morate nedvoumno prikazati ali vnesti čase v tem obsegu, je najbolje, da začasno preklopite na časovni pas, ki ne uporablja poletnega časa.

Pridobite neobdelane vrednosti s spletnim API-jem

Dataverse trgovine 2023-10-15T07:30:00Z (ali 2023-10-15 za samo datum vedenje). Uporabniki v vseh časovnih pasovih jih dobijo z zahtevo spletnega API-ja za vrednost:

Način delovanja	Oblikovanje	Surova vrednost
Lokalno pri uporabniku	Datum in ura	2023-10-15T07:30:00Z
Lokalno pri uporabniku	Samo datum	2023-10-15T07:30:00Z
Neodvisno od časovnega pasu	Datum in ura	2023-10-15T07:30:00Z
Neodvisno od časovnega pasu	Samo datum	2023-10-15T07:30:00Z
Samo datum	-	2023-10-15

Pridobite vrednosti z API-jem odjemalca

Uporabniki v časovnem pasu UTC-8 vstopijo October 14th, 2023, 11:30 pm v aplikacijo, ki temelji na modelu. API odjemalca deluje kot formContext.getAttribute(<column name>).getValue() vrne vrednost z uporabljenimi prilagoditvami časovnega pasu:

Način delovanja	Oblikovanje	JavaScript dateValue.toUTCString()
Lokalno pri uporabniku	Datum in ura	2023-10-15 07:30 (UTC)
Lokalno pri uporabniku	Samo datum	2023-10-15 07:30 (UTC)

Za obnašanje, neodvisno od časovnega pasu je vrednost datuma JavaScript v časovnem pasu brskalnika:

Način delovanja	Oblikovanje	JavaScript dateValue.toString()
Neodvisno od časovnega pasu	Datum in ura	2023-10-14 23:30 (časovni pas brskalnika)
Neodvisno od časovnega pasu	Samo datum	2023-10-14 23:30 (časovni pas brskalnika)

Datumske vrednosti JavaScript imajo vedno časovno komponento. Zato ima vedenje Samo datum časovno komponento 12:00:

Način delovanja	Oblikovanje	JavaScript dateValue.toString()
Samo datum	-	2023-10-15 00:00 (časovni pas brskalnika)

Opomba

Na datumske vrednosti JavaScript vpliva časovni pas brskalnika, ki izhaja iz nastavitev operacijskega sistema naprave.

Za lokalno vedenje uporabnika je treba rezultat odjemalskega API-ja razlagati kot vrednost UTC. Za delo z njim uporabite Date.getUTCDate(), Date.getUTCHours() itd. Če želite dobiti, kar vidi uporabnik, uporabite getTimeZoneOffsetMinutes. Ne uporabljajte Date.getDate(), Date.getHours() itd., ker bodo prikazali vrednost v časovnem pasu brskalnika.

Za neodvisno od časovnega pasu in samo datum obnašanje je treba rezultat odjemalskega API-ja razlagati kot vrednost v brskalniku časovni pas. Za delo z njim uporabite Date.getDate(), Date.getHours() itd. Ne uporabljajte Date.getUTCDate(), Date.getUTCHours() itd., ker se vam ni treba prilagajati nobenemu časovnemu pasu.

Spremenite lokalno vedenje uporabnika

Razen če izdajatelj upravljana rešitev tega prepreči, lahko spremenite vedenje obstoječih stolpcev z datumom po meri iz Lokalni uporabnik v Samo datum ali Neodvisno od časovnega pasu. To je enkratna sprememba.

Spreminjanje vedenja stolpca vpliva na vrednosti stolpca, ki so dodana ali spremenjena po spremembi vedenja. Vrednosti obstoječih stolpcev v zbirki podatkov ostanejo v obliki zapisa časa za časovni pas UTC. Če želite spremeniti vedenje obstoječih vrednosti stolpcev iz UTC v Samo datum, boste morda potrebovali pomoč razvijalca za pretvorbo vedenja obstoječega datuma in časovne vrednosti v bazi podatkov.

Opozorilo

Pred spreminjanjem delovanja obstoječega stolpca z datumom in časom preverite vse odvisnosti tega stolpca, vključno s pravili poslovanja, poteki dela in stolpci z izračunom ali stolpci s skupno vrednostjo, da preprečite morebitne težave zaradi spremembe delovanja. Ko spremenite vedenje stolpca z datumom in uro, odprite posamezna poslovna pravila, potek dela, izračunani stolpec in stolpec zbiranja, odvisno od stolpca, ki ste ga spremenili, preglejte informacije in jih shranite, da zagotovite, da se vedenje najnovejšega stolpca z datumom in uro in vrednosti.

Spreminjanje vedenja med uvozom rešitve

Ko uvozite rešitev, ki vsebuje stolpec Datum z vedenjem Lokalni uporabnik, lahko spremenite vedenje v Samo datum ali Neodvisno od časovnega pasu.

Opomba

Obnašanje obstoječega upravljanega stolpca Samo datum ali Datum in čas lahko spremenite le, če ste izdajatelj. Če želite spremeniti ta polja, je treba izvesti nadgradnjo rešitve, ki je dodala Samo datum ali Datum in čas stolpec. Več informacij: Nadgradnja ali posodobitev rešitve

Preprečitev spreminjanja delovanja

Če distribuirate stolpec z datumom po meri v upravljana rešitev, ljudem, ki uporabljajo vašo rešitev, preprečite, da bi spremenili vedenje, tako da nastavite upravljano lastnost CanChangeDateTimeBehavior na False. Več informacij: Nastavljanje upravljanih lastnosti za stolpce

Operatorji poizvedbe za datum in čas niso podprti za vedenje Samo datum

Naslednji operatorji poizvedb, povezani z datumom in uro, niso veljavni za vedenje Samo datum . Ko je v poizvedbi uporabljen eden od teh operatorjev, se prikaže napaka o izjemi neveljavnega operatorja.

• Starejše od X min.
• Starejše od X ur
• zadnjih X h
• naslednjih X h

Glejte tudi

Odpravite težave z datumom in uro v aplikacijah, ki temeljijo na modelu
Ustvarite in uredite stolpce
Definirajte izračunane stolpce za avtomatizacijo ročnih izračunov
Lastnosti, ki jih upravlja stolpec
Upravljane lastnosti
Blog: Delo s časovnimi pasovi v Dataverse
Konfigurirajte vedenje in obliko stolpca datuma in časa s kodo

Opomba

Ali nam lahko poveste, kateri je vaš prednostni jezik za dokumentacijo? Izpolnite kratko anketo. (upoštevajte, da je v angleščini)

Z anketo boste porabili približno sedem minut. Ne zbiramo nobenih osebnih podatkov (izjava o zasebnosti).