Správanie a formát stĺpca dátumu a času

V časti Microsoft Dataverse môžete určiť, ako sa používateľom zobrazujú hodnoty dátumu a času a ako sú upravené pre časové pásma.

Pre stĺpce dátumu a času sú k dispozícii dve možnosti.

  • Behavior: Či sa majú upraviť hodnoty pre časové pásma.
  • Formát: Či sa má zobraziť časová časť hodnoty.

Správanie

Dataverse ukladá všetky hodnoty dátumu a času v časovom pásme UTC. Keď vaša aplikácia zobrazuje hodnoty alebo hodnoty spracovania zadané používateľmi, Dataverse a aplikácie s podporou modelov sa môžu pomocou týchto možností Správanie prispôsobiť časovému pásmu používateľa.

  • Miestny používateľ: Upravte hodnoty pre časové pásmo používateľa. Toto je predvolené správanie. Môžete to raz zmeniť na iné správanie.
  • Nezávislé od časového pásma: Žiadna konverzia časového pásma.
  • Iba dátum: Bez konverzie časového pásma. Na rozdiel od Nezávislý od časového pásma sa časová časť neukladá.

Časové pásmo používateľa je nastavené v osobných možnostiach, nie systémové časové pásmo v systéme Windows, Android, iOS alebo macOS. systémové časové pásmo však môže ovplyvniť klientske skripty, ktoré pracujú s dátumami JavaScript.

Formát

Všetky stĺpce dátumu a času majú časovú časť, pokiaľ ich správanie nie je Len dátum. Formát určuje, či sa má zobraziť časová časť hodnoty.

  • Dátum a čas: Zobrazuje dátum a čas hodnoty.
  • Len dátum: Zobrazuje len časť hodnoty s dátumom.

Poznámka

Používatelia môžu stále zmeniť časovú časť, ak je Formát Len dátum. Napríklad pomocou volaní webového rozhrania API alebo pomocou ovládacieho prvku, ktorý má časovú časť. Toto sa líši od Iba dátum Správanie, kde sa časová časť neukladá vôbec.

Pokyny na použitie

Použite správanie nezávislé na časovom pásme, keď sa nevyžadujú informácie o časovom pásme, ako sú napríklad časy registrácie v hoteli. Pri tomto výbere uvidia používatelia vo všetkých časových pásmach rovnakú hodnotu dátumu a času.

Ak sa nevyžadujú informácie o čase dňa a časovom pásme, ako sú narodeniny alebo výročia, použite iba dátum správanie. Pri tomto výbere uvidia používatelia vo všetkých časových pásmach presne rovnakú hodnotu dátumu.

Nezávislé na časovom pásme správanie s Iba dátum formát je prakticky rovnaký ako Len dátum správanie. Ak si nie ste istí, či budete v budúcnosti potrebovať časovú časť, použite prvú možnosť.

Dôležité

Vyhnite sa iba dátum formátu s miestnym správaním používateľa. Používatelia v rôznych časových pásmach môžu vidieť iný dátum, čo vo väčšine scenárov nie je určené. Keď používateľ nastaví dátum v modelom riadenej aplikácii, časová časť sa automaticky nastaví na polnoc jeho časového pásma. To môže spôsobiť, že sa dátum ostatným používateľom zobrazí o deň skôr alebo neskôr.

Príklady

Zobrazte hodnoty

Dataverse obchody 2023-10-15T07:30:00Z (alebo 2023-10-15 pre iba dátum správanie). Používatelia v časovom pásme UTC-8 ich vidia v modelom riadenej aplikácii alebo s požiadavkou Web API na formátovanú hodnotu:

Správanie Formát Zobrazená hodnota
Miestne nastavenie používateľa Dátum a čas 14. októbra 2023, 23:30
Miestne nastavenie používateľa Iba dátum 14. októbra 2023
Časové pásmo Nezávislé Dátum a čas 15. októbra 2023, 7:30
Časové pásmo Nezávislé Iba dátum 15. októbra 2023
Iba dátum - 15. októbra 2023

Zadajte hodnoty v aplikácii

Používatelia v časovom pásme UTC-8 vstupujú October 14th, 2023, 11:30 pm do aplikácie riadenej modelom. Hodnota je uložená v Dataverse ako:

Správanie Formát Hodnota uložená v Dataverse
Miestne nastavenie používateľa Dátum a čas 2023-10-15T07:30:00Z
Miestne nastavenie používateľa Iba dátum 2023-10-15T07:30:00Z
Časové pásmo Nezávislé Dátum a čas 2023-10-14T23:30:00Z
Časové pásmo Nezávislé Iba dátum 2023-10-14T23:30:00Z
Iba dátum - 2023-10-14

Ak používateľ zadá iba dátum October 14th, 2023, predpokladá sa, že časová časť je 00:00.

Správanie Formát Hodnota uložená v Dataverse
Miestne nastavenie používateľa Iba dátum 2023-10-14T08:00:00Z
Časové pásmo Nezávislé Iba dátum 2023-10-14T00:00:00Z
Iba dátum - 2023-10-14

Zadajte neplatné hodnoty v aplikácii

Rôzni klienti majú rôzne spôsoby spracovania neplatného vstupu. Napríklad v tichomorskom časovom pásme sa letný čas začal 12. marca 2023 o 2:00, čím sa čas posunul o hodinu dopredu na 3:00. Čas medzi 2:00 a 3:00 v daný deň neexistuje. Keď sa používatelia pokúsia zadať hodnotu v tomto časovom rozsahu, aplikácie môžu vykonať jednu z nasledujúcich akcií:

  • Zmeňte na predchádzajúci alebo nasledujúci platný čas.
  • Vrátiť na poslednú známu hodnotu.
  • Zobraziť chybové hlásenie.
  • V nástroji na výber času nezobrazujte časy medzi 2:00 a 3:00, aby si ich používatelia nemohli vybrať.

Podobne, rôzni klienti majú rôzne spôsoby, ako zvládnuť opakované časové rozsahy. Napríklad v tichomorskom časovom pásme sa letný čas skončil 5. novembra 2023 o 2:00, čím sa čas posunul o hodinu dozadu na 1:00. Čas medzi 1:00 a 2:00 v ten deň sa opakuje dvakrát. Čas ako 1:30 sa môže vzťahovať na obe časové pásma. Ak potrebujete jednoznačne zobraziť alebo zadať časy v tomto rozsahu, je najlepšie dočasne prepnúť na časové pásmo, ktoré nepoužíva letný čas.

Získajte nespracované hodnoty pomocou webového rozhrania API

Dataverse obchody 2023-10-15T07:30:00Z (alebo 2023-10-15 pre iba dátum správanie). Používatelia vo všetkých časových pásmach ich získajú pomocou požiadavky webového rozhrania API na hodnotu:

Správanie Formát Surová hodnota
Miestne nastavenie používateľa Dátum a čas 2023-10-15T07:30:00Z
Miestne nastavenie používateľa Iba dátum 2023-10-15T07:30:00Z
Časové pásmo Nezávislé Dátum a čas 2023-10-15T07:30:00Z
Časové pásmo Nezávislé Iba dátum 2023-10-15T07:30:00Z
Iba dátum - 2023-10-15

Získajte hodnoty pomocou rozhrania API klienta

Používatelia v časovom pásme UTC-8 vstupujú October 14th, 2023, 11:30 pm do aplikácie riadenej modelom. Klientske rozhranie API funguje ako formContext.getAttribute(<column name>).getValue() vracia hodnotu s použitými úpravami časového pásma:

Správanie Formát JavaScript dateValue.toUTCString()
Miestne nastavenie používateľa Dátum a čas 2023-10-15 07:30 (UTC)
Miestne nastavenie používateľa Iba dátum 2023-10-15 07:30 (UTC)

V prípade správania nezávislého na časovom pásme je hodnota dátumu JavaScript v časovom pásme prehliadača:

Správanie Formát JavaScript dateValue.toString()
Časové pásmo Nezávislé Dátum a čas 2023-10-14 23:30 (časové pásmo prehliadača)
Časové pásmo Nezávislé Iba dátum 2023-10-14 23:30 (časové pásmo prehliadača)

Hodnoty dátumu JavaScript majú vždy časovú zložku. Preto má správanie Len dátum časovú zložku 00:00:

Správanie Formát JavaScript dateValue.toString()
Iba dátum - 2023-10-15 00:00 (časové pásmo prehliadača)

Poznámka

Hodnoty dátumu JavaScript sú ovplyvnené časovým pásmom prehliadača, ktoré pochádza z nastavení operačného systému zariadenia.

Pre miestne správanie používateľa by sa mal výsledok klientskeho rozhrania API interpretovať ako hodnota UTC. Na prácu s ním použite Date.getUTCDate(), Date.getUTCHours() atď. Ak chcete získať to, čo používateľ vidí, použite getTimeZoneOffsetMinutes. Nepoužívajte Date.getDate(), Date.getHours() atď., pretože tieto zobrazia hodnotu v časovom pásme prehliadača.

Pre správanie Nezávislé na časovom pásme a Len od dátumu by sa mal výsledok klientskeho rozhrania API interpretovať ako hodnota v prehliadači časové pásmo. Na prácu s ním použite Date.getDate(), Date.getHours() atď. Nepoužívajte Date.getUTCDate(), Date.getUTCHours() atď., pretože sa nemusíte prispôsobovať žiadnym časovým pásmam.

Zmeňte miestne správanie používateľa

Ak tomu nezabráni vydavateľ spravované riešenie, môžete zmeniť správanie existujúcich stĺpcov vlastného dátumu z Používateľ miestne na Len dátum alebo Nezávislé od časového pásma. Ide o jednorazovú zmenu.

Zmena správania stĺpca ovplyvní hodnoty stĺpca, ktoré sú pridané alebo upravené po zmene správania stĺpca. Existujúce hodnoty stĺpca zostávajú v databáze vo formáte časového pásma UTC. Ak chcete zmeniť správanie existujúcich hodnôt stĺpcov z UTC na Iba dátum, možno budete potrebovať pomoc vývojára na konvertovanie správania existujúceho dátumu a časové hodnoty v databáze.

Upozornenie

Pred zmenou existujúceho správania stĺpca dátumu a času by ste mali skontrolovať všetky závislosti tohto stĺpca, ako sú obchodné pravidlá, pracovné postupy a vypočítavané stĺpce alebo stĺpce súhrnu, a zaistiť tak, že nedôjde k žiadnym problémom z dôvodu zmeny správania. Po zmene správania stĺpca dátumu a času otvorte každé obchodné pravidlo, pracovný postup, vypočítaný stĺpec a súhrnný stĺpec v závislosti od stĺpca, ktorý ste zmenili, skontrolujte informácie a uložte ich, aby ste sa uistili, že správanie stĺpca s najnovším dátumom a časom a hodnota sa používa.

Zmena správania počas importu riešenia

Keď importujete riešenie, ktoré obsahuje stĺpec Dátum s Lokálnym správaním používateľa, toto správanie môžete zmeniť na Len dátum alebo Nezávislý od časového pásma.

Poznámka

Správanie existujúceho spravovaného stĺpca Len dátum alebo Dátum a čas môžete zmeniť iba vtedy, ak ste vlastníkom. Ak chcete vykonať zmenu v týchto poliach, musíte vykonať inováciu riešenia, ktoré pridalo Len dátum alebo Dátum a čas stĺpec. Ďalšie informácie: Inovácia alebo aktualizácia riešenia

Zabránenie zmene správania

Ak distribuujete vlastný stĺpec dátumu v spravované riešenie, zabráňte ľuďom používajúcim vaše riešenie zmeniť správanie nastavením spravovanej vlastnosti CanChangeDateTimeBehavior na hodnotu Nepravda. Ďalšie informácie: Nastavenie spravovaných vlastností pre stĺpce

Operátory dopytu dátumu a času nie sú podporované pre správanie Iba dátum

Nasledujúce operátory dopytov súvisiace s dátumom a časom sú neplatné pre správanie Len dátum . Chyba výnimky neplatného operátora sa vyskytne, keď sa jeden z operátorov použije dotazy.

  • Staršie ako X min.
  • Staršie ako X hod.
  • Počet posledných hodín: X
  • Počet nasledujúcich hodín: X

Pozrite si tiež

Riešenie problémov s dátumom a časom v aplikáciách riadených modelom
Vytvárajte a upravujte stĺpce
Definujte vypočítané stĺpce na automatizáciu manuálnych výpočtov
Vlastnosti spravované stĺpcom
Spravované nehnuteľnosti
Blog: Práca s časovými pásmami v Dataverse
Nakonfigurujte správanie a formát stĺpca dátumu a času pomocou kódu

Poznámka

Môžete nás informovať o svojich voľbách jazyka pre dokumentáciu? Absolvujte krátky prieskum. (upozorňujeme, že tento prieskum je v angličtine)

Prieskum bude trvať približne sedem minút. Nezhromažďujú sa žiadne osobné údaje (vyhlásenie o používaní osobných údajov).