Funktionsmåde i og format for kolonnen Dato og klokkeslæt
I Microsoft Dataverse kan du angive, hvordan dato- og klokkeslætsværdier skal vises til brugere, og hvordan de skal justeres for tidszoner.
Der findes to indstillinger for dato- og klokkeslætskolonner.
- Funktionsmåde: Om værdier skal justeres for tidszoner.
- Format: Om klokkeslætsdelen af værdien skal vises.
Adfærd
Dataverse gemmer alle dato- og klokkeslætsværdier i UTC-tidszonen. Når der vises værdier eller behandles værdier, der er angivet af brugere, kan Dataverse og modelbaserede apps justeres i forhold til brugerens tidszone med disse indstillinger for Funktionsmåde.
- Brugers lokaltid: Juster værdier for brugerens tidszone. Dette er standardfunktionsmåden. Du kan ændre dette én gang til en anden funktionsmåde.
- Tidszoneuafhængig: Ingen tidszonekonvertering.
- Kun dato: Ingen tidszonekonvertering. I modsætning til Tidszoneuafhængig lagres klokkeslætsdelen ikke.
Brugerens tidszone angives i personlige indstillinger, ikke i systemets tidszone i Windows, Android, iOS eller macOS. Men systemtidszonen kan påvirke klientscripts, der arbejder med JavaScript-datoer.
Format
Alle dato- og klokkeslætskolonner har en klokkeslætsdel, medmindre funktionsmåden er Kun dato. Format: bestemmer, om klokkeslætsdelen af værdien skal vises.
- Dato og klokkeslæt: Viser dato og klokkeslæt af værdien.
- Kun dato: Viser kun datodelen af værdien.
Bemærk
Brugere kan stadig ændre klokkeslætsdelen, hvis Format er Kun dato. Det kan f.eks. være med web-API-kald eller ved hjælp af et kontrolelement, der har klokkeslætsdelen. Dette er anderledes end, når Kun dato er angivet for Funktionsmåde, hvor klokkeslætsdelen slet ikke gemmes.
Retningslinjer for brug
Brug funktionsmåden Tidszoneuafhængig, når oplysninger om tidszone er ikke påkrævet, f.eks. tider for hotelindtjekning. Med dette valg ser alle brugere i alle tidszoner samme dato- og klokkeslætsværdi.
Brug funktionsmåden Kun dato, når oplysninger om tidspunktet på dagen og tidszonen ikke er påkrævet, f.eks. fødselsdage og mærkedage. Med dette valg ser alle brugere i alle tidszoner nøjagtig samme datoværdi.
Funktionsmåden Tidszoneuafhængig med formatet Kun dato er stort set det samme som funktionsmåden Kun dato. Brug den første, hvis du ikke er sikker på, om du skal bruge klokkeslætsdelen i fremtiden.
Vigtigt
Formatér kun Dato med brugerens brugers lokaltid funktionsmåde. Brugere i forskellige tidszoner kan se en anden dato, hvilket ikke er tilsigtet i de fleste scenarier. Når en bruger angiver en dato i en modelbaseret app, angives tidsdelen automatisk til midnat i tidszonen. Det kan medføre, at datoen vises en dag tidligere eller senere for andre brugere.
Eksempler
Vis værdier
Dataverse gemmer 2023-10-15T07:30:00Z (eller 2023-10-15 for funktionsmåden Kun dato). Brugere i tidszonen UTC-8 se disse i den modelbaserede app eller med en web-API-anmodning om den formaterede værdi:
| Adfærd | Format | Vis værdi |
|---|---|---|
| Brugers lokaltid | Dato og klokkeslæt | 14. oktober 2023, 23:30 |
| Brugers lokaltid | Kun dato | 14. oktober 2023 |
| Tidszoneuafhængig | Dato og klokkeslæt | 15. oktober 2023, 7:30 |
| Tidszoneuafhængig | Kun dato | 15. oktober 2023 |
| Kun dato | - | 15. oktober 2023 |
Angiv værdier i en app
Brugere i tidszonen UTC-8 angiver October 14th, 2023, 11:30 pm i en modelbaseret app. Værdien gemmes i Dataverse som:
| Adfærd | Format | Værdi gemt i Dataverse |
|---|---|---|
| Brugers lokaltid | Dato og klokkeslæt | 2023-10-15T07:30:00Z |
| Brugers lokaltid | Kun dato | 2023-10-15T07:30:00Z |
| Tidszoneuafhængig | Dato og klokkeslæt | 2023-10-14T23:30:00Z |
| Tidszoneuafhængig | Kun dato | 2023-10-14T23:30:00Z |
| Kun dato | - | 2023-10-14 |
Hvis brugeren kun angiver datoen October 14th, 2023, antages klokkeslætdelen at være 12:00.
| Adfærd | Format | Værdi gemt i Dataverse |
|---|---|---|
| Brugers lokaltid | Kun dato | 2023-10-14T08:00:00Z |
| Tidszoneuafhængig | Kun dato | 2023-10-14T00:00:00Z |
| Kun dato | - | 2023-10-14 |
Angiv ugyldige værdier i en app
Forskellige klienter kan håndtere ugyldigt input på forskellige måder. I tidszonen Pacific startede sommertiden f.eks. den 12. marts 2023 kl. 2:00 og flytter tiden én time frem til kl. 3:00. Tiden mellem 2:00 og 3:00 den pågældende dag findes ikke. Når brugere forsøger at angive en værdi i dette tidsinterval, kan apps gøre et af følgende:
- Skifte til det forrige eller næste gyldige tidspunkt.
- Genindlæse til den senest kendte værdi.
- Vise en fejlmeddelelse.
- Vis ikke klokkeslæt mellem kl. 2:00 og 3:00 i tidsvælgeren, så brugerne ikke kan vælge dem i første omgang.
På samme måde kan forskellige klienter håndtere gentagne tidsintervaller på forskellige måder. I tidszonen Pacific sluttede sommertiden f.eks. den 5. november 2023 kl. 2:00 og flytter tiden én tilbage frem til kl. 1:00. Tiden mellem 1:00 og 2:00 den pågældende dag gentages to gange. Et tidspunkt som 1:30 kan referere til begge tidszoner. Hvis du har brug for at få vist eller angive tidspunkter i det pågælende interval entydigt, anbefales det, at du skifter til en tidszone, hvor der ikke bruges sommertid.
Hent rå værdier med web-API
Dataverse gemmer 2023-10-15T07:30:00Z (eller 2023-10-15 for funktionsmåden Kun dato). Brugere i alle tidszoner får disse med en web-API-anmodning om værdien:
| Adfærd | Format | Rå værdi |
|---|---|---|
| Brugers lokaltid | Dato og klokkeslæt | 2023-10-15T07:30:00Z |
| Brugers lokaltid | Kun dato | 2023-10-15T07:30:00Z |
| Tidszoneuafhængig | Dato og klokkeslæt | 2023-10-15T07:30:00Z |
| Tidszoneuafhængig | Kun dato | 2023-10-15T07:30:00Z |
| Kun dato | - | 2023-10-15 |
Hent værdier med klient-API'en
Brugere i tidszonen UTC-8 angiver October 14th, 2023, 11:30 pm i en modelbaseret app. Funktioner i klient-API'en som formContext.getAttribute(<column name>).getValue() returnerer værdien, hvor tidszonetilpasninger er anvendt:
| Adfærd | Format | JavaScript dateValue.toUTCString() |
|---|---|---|
| Brugers lokaltid | Dato og klokkeslæt | 2023-10-15 07:30 (UTC) |
| Brugers lokaltid | Kun dato | 2023-10-15 07:30 (UTC) |
I forbindelse med funktionsmåden Tidszoneuafhængig er værdien for JavaScript-datoen i browserens tidszone:
| Adfærd | Format | JavaScript dateValue.toString() |
|---|---|---|
| Tidszoneuafhængig | Dato og klokkeslæt | 2023-10-14 23:30 (tidszone i browseren) |
| Tidszoneuafhængig | Kun dato | 2023-10-14 23:30 (tidszone i browseren) |
Datoværdier for JavaScript har altid en tidskomponent. Det er derfor, at funktionsmåden Kun dato har en tidskomponent på 12:00:
| Adfærd | Format | JavaScript dateValue.toString() |
|---|---|---|
| Kun dato | - | 2023-10-15 00:00 (tidszone i browseren) |
Bemærk
Datoværdier for JavaScript påvirkes af browserens tidszone, som kommer fra enhedens indstillinger for operativsystemet.
I forbindelse med funktionsmåden Brugers lokaltid skal klient-API-resultatet opfattes som en UTC-værdi. Brug Date.getUTCDate(), Date.getUTCHours() osv. til at arbejde med den. Du kan se, hvad brugeren kan se, ved at anvende getTimeZoneOffsetMinutes. Brug ikke Date.getDate(), Date.getHours() osv., da værdien så vises i browserens tidszone.
For funktionsmåderne Tidszoneuafhængig og Kun dato skal klient-API-resultatet opfattes som en værdi i browserens tidszone. Brug Date.getDate(), Date.getHours() osv. til at arbejde med den. Brug ikke Date.getUTCDate(), Date.getUTCHours() osv., da du ikke behøver at justere i forhold til tidszoner.
Ændre funktionsmåden for brugers lokaltid
Medmindre udgiveren af en administreret løsning forhindrer det, kan du ændre funktionsmåden for eksisterende brugerdefinerede datokolonner fra Brugers lokaltid til Kun dato eller Tidszoneuafhængig. Dette er en enkeltstående ændring.
Ændring af funktionsmåden for kolonnen påvirker de kolonneværdier, der er tilføjet eller ændret, efter at funktionsmåden for kolonnen blev ændret. De eksisterende kolonneværdier forbliver i databasen i UTC-tidszoneformat. Hvis du vil ændre funktionsmåden for eksisterende kolonneværdier fra kun UTC til Kun dato, skal du måske have hjælp fra en udvikler til at konvertere funktionsmåden for eksisterende dato- og klokkeslætsværdier i databasen.
Advarsel!
Før du ændrer funktionsmåden for en eksisterende dato- og klokkeslætskolonne, bør du gennemgå alle afhængigheder af kolonnen, f.eks forretningsregler, arbejdsprocesser, beregnede kolonner eller akkumuleringskolonner, for at sikre, at der er ingen problemer som følge af ændringen af funktionen. Efter ændring af funktionsmåden for en dato- og klokkeslætskolonne skal du åbne hver forretningsregel, arbejdsproces, beregnet kolonne og akkumuleringskolonne, som du ændrer, gennemse oplysningerne og gemme posten for at sikre, at den seneste funktionsmåde og værdi for dato- og klokkeslætskolonnen anvendes.
Ændre funktionsmåde under import af en løsning
Når du importerer en løsning, der indeholder en Dato-kolonne ved hjælp af funktionsmåden Brugers lokaltid, kan du ændre funktionsmåden til Kun dato eller Tidszoneuafhængig.
Bemærk
Du kan kun ændre funktionsmåden for en eksisterende administreret kolonne af typen Kun dato eller Dato og klokkeslæt, hvis du er udgiver. Hvis du vil foretage en ændring af disse felter, skal der foretages en opgradering af den løsning,der tilføjede kolonnen af typen Kun dato eller Dato og klokkeslæt. Flere oplysninger: Opgradere eller opdatere en løsning
Forhindre ændring af funktionsmåden
Hvis du distribuerer en brugerdefineret datokolonne i en administreret løsning, kan du forhindre, at personer, der bruger din løsning, kan ændre funktionsmåden, ved at indstille den administrerede egenskab CanChangeDateTimeBehavior til False. Flere oplysninger: Angive administrerede egenskaber for kolonner
Forespørgselsoperatorer for dato og klokkeslæt understøttes ikke for funktionsmåden Kun dato
Følgende dato- og klokkeslætsrelaterede forespørgselsoperatorer gælder ikke for funktionsmåden Kun dato. Der opstår en ugyldig operatorundtagelsesfejl, når en af disse operatorer bruges i forespørgslen.
- Ældre end x minutter
- Ældre end x timer
- Sidste X timer
- Næste X timer
Se også
Fejlfinding af problemer med dato og klokkeslæt i modelbaserede apps
Oprette og redigere kolonner
Definere beregnede kolonner for at automatisere manuelle beregninger
Kolonneadministrerede egenskaber
Administrerede egenskaber
Blog: Arbejde med tidszoner i Dataverse
Konfigurere funktionsmåden i og formatet for kolonnen Dato og klokkeslæt ved hjælp af kode
Bemærk
Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)
Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).