Ponašanje i oblik stupca datuma i vremena

U aplikaciji Microsoft Dataverse možete odrediti kako se vrijednosti datuma i vremena prikazuju korisnicima i kako se prilagođavaju vremenskim zonama.

Dostupne su dvije mogućnosti za stupce datuma i vremena.

  • Ponašanje: Hoće li se prilagoditi vrijednosti za vremenske zone.
  • Format: Hoće li se prikazati vremenski dio vrijednosti.

Ponašanje

Dataverse pohranjuje sve vrijednosti datuma i vremena u vremenskoj zoni UTC. Kada vaša aplikacija prikazuje vrijednosti ili vrijednosti obrade koje su unijeli korisnici, Dataverse a aplikacije stvorene prema modelu mogu se prilagoditi vremenskoj zoni korisnika pomoću ovih mogućnosti ponašanja .

  • Lokalno korisnik: Prilagodite vrijednosti za vremensku zonu korisnika. Ovo je zadano ponašanje. To možete jednom promijeniti u drugo ponašanje.
  • Neovisno o vremenskoj zoni: nema pretvorbe vremenske zone.
  • Samo datum: nema pretvorbe vremenske zone. Za razliku od neovisnosti o vremenskoj zoni, vremenski dio se ne pohranjuje.

Korisnikova vremenska zona postavljena je u osobnim opcijama, a ne u vremenskoj zoni sustava u sustavu Windows, Android,, iOS ili macOS. Međutim, vremenska zona sustava može utjecati na klijentske skripte koje rade s JavaScript datumima.

Oblik

Svi stupci datuma i vremena imaju vremenski dio, osim ako je njegovo ponašanje Samo datum. Oblik određuje hoće li se prikazati vremenski dio vrijednosti.

  • Datum i vrijeme: Prikazuje datum i vrijeme vrijednosti.
  • Samo datum: Prikazuje samo dio vrijednosti datuma.

Napomena

Korisnici i dalje mogu promijeniti vremenski dio ako je Format samo datum. Na primjer, s pozivima web-API-ja ili pomoću kontrole koja ima vremenski dio. To se razlikuje od ponašanja samo datuma, gdje se vremenski dio uopće ne pohranjuje.

Smjernice za korištenje

Koristite ponašanje neovisno o vremenskoj zoni kada podaci o vremenskoj zoni nisu potrebni, kao što je vrijeme prijave u hotel. S ovim odabirom korisnici u svim vremenskim zonama vide istu vrijednost datuma i vremena.

Koristite ponašanje Datum samo kada informacije o dobu dana i vremenskoj zoni nisu potrebne, kao što su rođendani ili godišnjice. S ovim odabirom korisnici u svim vremenskim zonama vide potpuno istu vrijednost datuma.

Ponašanje neovisno o vremenskoj zoni s formatom Samo datum praktički je isto kao i ponašanje Samo datum. Koristite prvo ako niste sigurni trebate li vremenski dio u budućnosti.

Važno

Izbjegavajte oblik samo datuma s lokalnim ponašanjem korisnika. Korisnici u različitim vremenskim zonama mogu vidjeti drugačiji datum, što nije predviđeno u većini scenarija. Kada korisnik postavi datum u aplikaciji stvorenoj prema modelu, vremenski dio automatski će se postaviti na ponoć njegove vremenske zone. To može uzrokovati da se datum pojavi dan ranije ili kasnije za druge korisnike.

Primjeri

Prikaz vrijednosti

Dataverse trgovine 2023-10-15T07:30:00Z (ili 2023-10-15 za ponašanje samo datuma). Korisnici u vremenskoj zoni UTC-8 vide ih u aplikaciji stvorenoj prema modelu ili sa zahtjevom web-API-ja za oblikovanu vrijednost:

Ponašanje Oblik Prikaži vrijednost
Lokalni korisnik Datum i vrijeme 14. listopada 2023., 11:30 pm
Lokalni korisnik Samo datum 14 listopada, 2023
Vremenska zona Neovisno Datum i vrijeme 15. listopada 2023. 7:30
Vremenska zona Neovisno Samo datum 15 listopada, 2023
Samo datum - 15 listopada, 2023

Unos vrijednosti u aplikaciju

Korisnici u vremenskoj zoni UTC-8 ulaze October 14th, 2023, 11:30 pm u aplikaciju stvorenu prema modelu. Vrijednost se sprema kao Dataverse :

Ponašanje Oblik Vrijednost spremljena u Dataverse
Lokalni korisnik Datum i vrijeme 2023-10-15T07:30:00Z
Lokalni korisnik Samo datum 2023-10-15T07:30:00Z
Vremenska zona Neovisno Datum i vrijeme 2023-10-14T23:30:00Z
Vremenska zona Neovisno Samo datum 2023-10-14T23:30:00Z
Samo datum - 2023-10-14

Ako korisnik unese samo datum October 14th, 2023, pretpostavlja se da je vremenski dio 12:00 sati.

Ponašanje Oblik Vrijednost spremljena u Dataverse
Lokalni korisnik Samo datum 2023-10-14T08:00:00Z
Vremenska zona Neovisno Samo datum 2023-10-14T00:00:00Z
Samo datum - 2023-10-14

Unos nevažećih vrijednosti u aplikaciji

Različiti klijenti imaju različite načine rukovanja nevažećim unosom. Na primjer, u pacifičkoj vremenskoj zoni, ljetno računanje vremena počelo je 12. ožujka 2023. u 2:00 ujutro, pomičući vrijeme za jedan sat unaprijed na 3:00 ujutro. Vrijeme između 2:00 i 3:00 ujutro tog dana ne postoji. Kada korisnici pokušaju unijeti vrijednost u tom vremenskom rasponu, aplikacije mogu učiniti nešto od sljedećeg:

  • Promijenite na prethodno ili sljedeće valjano vrijeme.
  • Vratite se na posljednju poznatu vrijednost.
  • Prikaz poruke o pogrešci.
  • Nemojte prikazivati vremena između 2:00 i 3:00 ujutro u biraču vremena kako ih korisnici ne bi mogli odabrati.

Slično tome, različiti klijenti imaju različite načine za rukovanje ponovljenim vremenskim rasponima. Na primjer, u pacifičkoj vremenskoj zoni, ljetno računanje vremena završilo je 5. studenog 2023. u 2:00 ujutro, pomičući vrijeme unatrag jedan sat unatrag na 1:00 ujutro. Vrijeme između 1:00 i 2:00 ujutro tog dana ponavlja se dva puta. Vrijeme poput 1:30 ujutro može se odnositi na bilo koju vremensku zonu. Ako trebate nedvosmisleno prikazati ili unijeti vremena u tom rasponu, najbolje je privremeno se prebaciti na vremensku zonu koja ne koristi ljetno računanje vremena.

Dobivanje neobrađenih vrijednosti pomoću web API-ja

Dataverse trgovine 2023-10-15T07:30:00Z (ili 2023-10-15 za ponašanje samo datuma). Korisnici u svim vremenskim zonama dobivaju ih sa zahtjevom Web API-ja za vrijednost:

Ponašanje Oblik Sirova vrijednost
Lokalni korisnik Datum i vrijeme 2023-10-15T07:30:00Z
Lokalni korisnik Samo datum 2023-10-15T07:30:00Z
Vremenska zona Neovisno Datum i vrijeme 2023-10-15T07:30:00Z
Vremenska zona Neovisno Samo datum 2023-10-15T07:30:00Z
Samo datum - 2023-10-15

Dohvaćanje vrijednosti pomoću klijentskog API-ja

Korisnici u vremenskoj zoni UTC-8 ulaze October 14th, 2023, 11:30 pm u aplikaciju stvorenu prema modelu. Funkcije klijentskog API-ja poput formContext.getAttribute(<column name>).getValue() vraćanja vrijednosti s primijenjenim prilagodbama vremenske zone:

Ponašanje Oblik Javna java dateValue.toUTCString()
Lokalni korisnik Datum i vrijeme 2023-10-15 07:30 (UTC)
Lokalni korisnik Samo datum 2023-10-15 07:30 (UTC)

Za ponašanje neovisno o vremenskoj zoni, JavaScript vrijednost datuma nalazi se u vremenskoj zoni preglednika:

Ponašanje Oblik Javna java dateValue.toString()
Vremenska zona Neovisno Datum i vrijeme 2023-10-14 23:30 (vremenska zona preglednika)
Vremenska zona Neovisno Samo datum 2023-10-14 23:30 (vremenska zona preglednika)

JavaScript vrijednosti datuma uvijek imaju vremensku komponentu. Zato ponašanje Samo datum ima vremensku komponentu 12:00 sati:

Ponašanje Oblik Javna java dateValue.toString()
Samo datum - 2023-10-15 00:00 (vremenska zona preglednika)

Napomena

Na vrijednosti datuma JavaScripta utječe vremenska zona preglednika, koja dolazi iz postavki operativnog sustava uređaja.

Za lokalno ponašanje korisnika, rezultat API-ja klijenta treba protumačiti kao UTC vrijednost. Koristite Date.getUTCDate() itd Date.getUTCHours(). za rad s njim. Da biste dobili ono što korisnik vidi, primijenite getTimeZoneOffsetMinutes. Nemojte koristiti Date.getDate() Date.getHours(), itd. jer će oni prikazati vrijednost u vremenskoj zoni preglednika.

Za ponašanje Neovisno o vremenskoj zoni i Samo datum, rezultat API-ja klijenta treba protumačiti kao vrijednost u vremenskoj zoni preglednika. Koristite Date.getDate() itd Date.getHours(). za rad s njim. Nemojte koristiti Date.getUTCDate() Date.getUTCHours(), i tako dalje jer se ne morate prilagođavati za bilo koju vremensku zonu.

Promjena lokalnog ponašanja korisnika

Osim ako izdavač upravljano rješenje to ne spriječi, možete promijeniti ponašanje postojećih prilagođenih stupaca datuma iz Lokalni korisnik u Samo datum ili Neovisno o vremenskoj zoni. Ovo je jednokratna promjena.

Promjena ponašanja stupca utječe na vrijednosti stupca koje su dodane ili izmijenjene nakon promjene ponašanja stupca. Postojeće vrijednosti stupca ostaju u bazi podataka u obliku UTC vremenske zone. Da biste promijenili ponašanje postojećih vrijednosti stupca iz UTC u Samo datum, možda će vam trebati pomoć razvojnog inženjera za pretvaranje ponašanja postojećih vrijednosti datuma i vremena u bazi podataka.

Upozorenje

Prije promjene ponašanja postojećeg stupca datuma i vremena, trebali biste pregledati sve ovisnosti tog stupca, primjerice, poslovna pravila, tijekove rada, izračunate stupce ili stupce skupne vrijednosti, kako biste bili sigurni da nema problema zbog promjene ponašanja. Nakon što promijenite ponašanje stupca datuma i vremena, otvorite svako poslovno pravilo, tijek rada, izračunati stupac i stupac skupne vrijednosti ovisno o stupcu koji ste promijenili, pregledajte informacije i spremite ih da biste bili sigurni da se koriste ponašanje i vrijednost najnovijeg stupca datuma i vremena.

Promjena ponašanja tijekom uvoza rješenja

Kada uvozite rješenje koje sadrži stupac Datum s lokalnim ponašanjem korisnika, možete promijeniti ponašanje u Samo datum ili Neovisno o vremenskoj zoni.

Napomena

Ponašanje postojećeg upravljanog stupca Samo datum ili Datum i vrijeme možete promijeniti samo ako ste izdavač. Da biste promijenili ta polja, potrebno je nadograditi rješenje koje je dodalo stupac Samo datum ili Datum i vrijeme . Dodatne informacije: Nadogradnja ili ažuriranje rješenja

Sprječavanje promjena ponašanja

Ako distribuirate prilagođeni stupac datuma u upravljano rješenje, spriječite osobe koje koriste vaše rješenje da promijene ponašanje postavljanjem upravljanog svojstva CanChangeDateTimeBehavior na False. Dodatne informacije: Postavljanje upravljanih svojstava za stupce

Operatori upita za datum i vrijeme nisu podržani za ponašanje Samo datum

Sljedeći operatori upita povezani s datumom i vremenom nisu valjani za ponašanje Samo datum. Pogreška iznimke nevaljanog operatora prikazuje se kada se jedan od tih operatora koristi u upitu.

  • Starije od X min
  • Starije od X sati
  • Posljednjih X sati
  • Sljedećih X sati

Pogledajte

Otklanjanje poteškoća s datumom i vremenom u aplikacijama stvorenim prema modelu
Stvaranje i uređivanje stupaca
Definiranje izračunatih stupaca radi automatizacije ručnih izračuna
Svojstva upravljana stupcima
Upravljani objekti
Blog: Rad s vremenskim zonama u Dataverse
Konfiguriranje ponašanja i oblika stupca datuma i vremena pomoću koda

Napomena

Možete li nam reći više o željenim jezicima za dokumentaciju? Ispunite kratki upitnik. (imajte na umu da je upitnik na engleskom jeziku)

Ispunjavanje upitnika će trajati otprilike sedam minuta. Osobni podaci se ne prikupljaju (izjava o zaštiti privatnosti).