Päivämäärä- ja aikasarakkeen toimintatapa ja muoto
Microsoft Dataversessa voi määrittää, miten päivämäärän ja ajan arvot näytetään käyttäjille ja miten ne muutetaan aikavyöhykkeitä varten.
Päivämäärä- ja aikasarakkeille on käytettävissä kaksi vaihtoehtoa.
- Toimintatapa: Määrittää, muutetaanko aikavyöhykkeiden arvot.
- Muoto: Määrittää, näytetäänkö arvon aikaosa.
Toiminta
Dataverse tallentaa kaikki päivämäärä- ja aika-arvot UTC-aikavyöhykkeeseen. Kun sovellus näyttää käyttäjien antamat arvot tai käsittelyarvot, Dataverse ja mallipohjaiset sovellukset voivat muuttaa käyttäjän aikavyöhykkeen näillä Toimintatapa-asetuksilla.
- Käyttäjän paikallinen: Muuttaa käyttäjän aikavyöhykkeen arvot. Tämä on oletusasetus. Voit muuttaa tämän kerran muuksi toiminnaksi.
- Aikavyöhykkeestä riippumaton: Ei aikavyöhykkeen muuntamista.
- Vain päivämäärä: Ei aikavyöhykkeen muuntamista. Toisin kuin Aikavyöhykkeestä riippumaton -asetuksessa, aikaosaa ei tallenneta.
Käyttäjän aikavyöhyke määritetään henkilökohtaisissa asetuksissa, ei Windowsin, Androidin, iOS:n tai macOS:n järjestelmäasetuksissa. Kuitenkin järjestelmän aikavyöhyke voi vaikuttaa JavaScriptin päivämäärien kanssa toimiviin asiakasohjelman komentosarjoihin.
Muotoile
Kaikilla päivämäärä- ja aikasarakkeilla on aikaosat, jos toimintatapa on jokin muu kuin Vain päivämäärä. Muoto: Määrittää, näytetäänkö arvon aikaosa.
- Päivämäärä ja aika: Näyttää päivämäärän ja ajan.
- Vain päivämäärä: Näyttää vain arvon päivämääräosan.
Huomautus
Käyttäjät voivat yhä muuttaa aikaosaa, jos muodon arvo on Vain päivämäärä. Näin voi tehdä esimerkiksi verkko-ohjelmointirajapintakutsuilla tai käyttämällä ohjausobjektia, jolla on aikaosa. Tämä eroaa Vain päivämäärä -asetuksen toiminnasta, jossa aikaosaa ei tallenneta lainkaan.
Käyttöohjeet
Käytä Aikavyöhykkeestä riippumaton -toimintatapaa, kun aikavyöhykettä ei vaadita. Tämä koskee esimerkiksi hotellien sisäänkirjausaikoja. Kun valinta on tämä, kaikkien aikavyöhykkeiden käyttäjät näkevät saman päivämäärän ja kellonajan arvon.
Vain päivämäärä -toimintatapaa käytetään silloin, kun kellonajan ja aikavyöhykkeen tietoja ei tarvita (esimerkiksi syntymäpäivissä ja vuosipäivissä). Kun valinta on tämä, kaikkien aikavyöhykkeiden käyttäjät näkevät saman päivämäärän arvon.
Aikavyöhykkeestä riippumaton -toimintatapa yhdessä Vain päivämäärä -muodon kanssa on käytännössä sama kuin Vain päivämäärä -toimintatapa. Käytä ensin mainittua, jos et ole varma, tarvitsetko aika-osuutta tulevaisuudessa.
Tärkeä
Vältä Vain päivämäärä -muotoa Käyttäjän paikallinen -käyttäytymisen kanssa. Eri aikavyöhykkeiden käyttäjät saattavat nähdä eri päivämäärän, mikä ei ole tarkoitettu useimmissa skenaarioissa. Kun käyttäjä määrittää päivämäärän mallipohjaisessa sovelluksessa, aika-arvoksi asetetaan automaattisesti hänen aikavyöhykkeensä keskiyö. Tämä voi aiheuttaa sen, että päivämäärä näkyy päivää aiemmin tai myöhemmin toisille käyttäjille.
Esimerkkejä
Näyttöarvot
Dataverse tallentaa 2023-10-15T07:30:00Z (tai 2023-10-15 Vain päivämäärä -toiminnalle). Aikavyöhykkeen UTC-8 käyttäjät näkevät nämä mallipohjaisessa sovelluksessa tai muotoiltua arvoa koskevalla verkko-ohjelmointirajapintapyynnöllä:
| Toiminta | Muotoile | Näyttöarvo |
|---|---|---|
| Käyttäjän paikallinen | Päivämäärä ja aika | 14. lokakuuta 2023, klo 23.30 |
| Käyttäjän paikallinen | Vain päivämäärä | 14. lokakuuta 2023 |
| Aikavyöhykkeestä riippumaton | Päivämäärä ja aika | 15. lokakuuta 2023 klo 7:30 |
| Aikavyöhykkeestä riippumaton | Vain päivämäärä | 15. lokakuuta 2023 |
| Vain päivämäärä | - | 15. lokakuuta 2023 |
Arvojen syöttäminen sovellukseen
Aikavyöhykkeen UTC-8 käyttäjät syöttävät mallipohjaiseen sovellukseen October 14th, 2023, 11:30 pm. Arvo tallennetaan Dataversessa seuraavasti:
| Toiminta | Muotoile | Dataversessa tallennettu arvo |
|---|---|---|
| Käyttäjän paikallinen | Päivämäärä ja aika | 2023-10-15T07:30:00Z |
| Käyttäjän paikallinen | Vain päivämäärä | 2023-10-15T07:30:00Z |
| Aikavyöhykkeestä riippumaton | Päivämäärä ja aika | 2023-10-14T23:30:00Z |
| Aikavyöhykkeestä riippumaton | Vain päivämäärä | 2023-10-14T23:30:00Z |
| Vain päivämäärä | - | 2023-10-14 |
Jos käyttäjä syöttää vain päivämäärän October 14th, 2023, aikaosan oletetaan olevan klo 0.00.
| Toiminta | Muotoile | Dataversessa tallennettu arvo |
|---|---|---|
| Käyttäjän paikallinen | Vain päivämäärä | 2023-10-14T08:00:00Z |
| Aikavyöhykkeestä riippumaton | Vain päivämäärä | 2023-10-14T00:00:00Z |
| Vain päivämäärä | - | 2023-10-14 |
Virheellisten arvojen syöttäminen sovellukseen
Eri asiakasohjelmat voivat käsitellä virheellisiä tietoja eri tavoilla. Esimerkiksi Tyynenmeren aikavyöhykkeellä kesäaika alkoi 12. maaliskuuta 2023 klo 2.00, joten kelloa siirrettiin eteenpäin yhdellä tunnilla (klo 3.00). Kyseisenä päivänä kellonaikaa välillä 2.00–3.00 ei ole olemassa. Kun käyttäjät yrittävät syöttää arvoja kyseiselle aikavälille, sovellukset voivat tehdä jonkin seuraavista vaihtoehdoista:
- Muuttaa arvon edelliseksi tai seuraavaksi sallituksi ajaksi.
- Palauttaa edellisen tunnetun arvon.
- Näyttää virhesanoman.
- Aikoja välillä 2.00–3.00 ei näytetä ajan valitsimessa, jolloin käyttäjät eivät voi valita niitä.
Eri asiakkailla on vastaavasti erilaisia tapoja käsitellä toistuvia aikavälejä. Esimerkiksi Tyynenmeren aikavyöhykkeellä kesäaika päättyi 5. marraskuuta 2023 klo 2.00, joten kelloa siirrettiin taaksepäin yhdellä tunnilla (klo 1.00). Kyseisenä päivänä kellonaika 1.00–2.00 toistuu kahdesti. Niinpä kellonaika, kuten 1.30 voi viitata kumpaan tahansa aikavyöhykkeeseen. Jos aika on näytettävä tai annettava yksiselitteisesti kyseisellä aikavälillä, paras vaihtoehto on vaihtaa väliaikaisesti aikavyöhykkeelle, joka ei käytä kesäaikaa.
Raaka-arvojen noutaminen verkko-ohjelmointirajapinnan avulla
Dataverse tallentaa 2023-10-15T07:30:00Z (tai 2023-10-15 Vain päivämäärä -toiminnalle). Kaikkien aikavyöhykkeiden käyttäjät saavat nämä verkko-ohjelmointirajapintapyynnöllä arvolle:
| Toiminta | Muotoile | Raaka-arvo |
|---|---|---|
| Käyttäjän paikallinen | Päivämäärä ja aika | 2023-10-15T07:30:00Z |
| Käyttäjän paikallinen | Vain päivämäärä | 2023-10-15T07:30:00Z |
| Aikavyöhykkeestä riippumaton | Päivämäärä ja aika | 2023-10-15T07:30:00Z |
| Aikavyöhykkeestä riippumaton | Vain päivämäärä | 2023-10-15T07:30:00Z |
| Vain päivämäärä | - | 2023-10-15 |
Arvojen noutaminen asiakasohjelman ohjelmointirajapinnan avulla
Aikavyöhykkeen UTC-8 käyttäjät syöttävät mallipohjaiseen sovellukseen October 14th, 2023, 11:30 pm. Asiakasohjelman ohjelmointirajapinnan funktiot, kuten formContext.getAttribute(<column name>).getValue(), palauttavat arvon aikavyöhykkeen oikaisut ovat käytössä seuraavasti:
| Toiminta | Muotoile | JavaScript dateValue.toUTCString() |
|---|---|---|
| Käyttäjän paikallinen | Päivämäärä ja aika | 2023-10-15 07:30 (UTC) |
| Käyttäjän paikallinen | Vain päivämäärä | 2023-10-15 07:30 (UTC) |
Aikavyöhykkeestä riippumaton -toiminnassa JavaScriptin päivämääräarvo on selaimen aikavyöhykkeessä seuraavasti:
| Toiminta | Muotoile | JavaScript dateValue.toString() |
|---|---|---|
| Aikavyöhykkeestä riippumaton | Päivämäärä ja aika | 2023-10-14 23:30 (selaimen aikavyöhyke) |
| Aikavyöhykkeestä riippumaton | Vain päivämäärä | 2023-10-14 23:30 (selaimen aikavyöhyke) |
JavaScriptin päivämääräarvoissa on aina aikakomponentti. Tämän vuoksi Vain päivämäärä -toiminnassa on klo 0.00 -aikakomponentti:
| Toiminta | Muotoile | JavaScript dateValue.toString() |
|---|---|---|
| Vain päivämäärä | - | 2023-10-15 00:00 (selaimen aikavyöhyke) |
Huomautus
Selaimen aikavyöhyke, joka saadaan laitteen käyttöjärjestelmän asetuksista, vaikuttaa JavaScriptin päivämääräarvoihin.
Käyttäjän paikallinen -toiminnassa asiakasohjelman ohjelmointirajapinta tulee tulkita UTC-arvoksi. Käytä sen kanssa esimerkiksi Date.getUTCDate()- tai Date.getUTCHours()-arvoa. Jos haluat tietää, mitä käyttäjät näkevät, käytä getTimeZoneOffsetMinutes-arvoa. Älä käytä esimerkiksi Date.getDate()- tai Date.getHours()-arvoa, koska ne näyttävät arvon selaimen aikavyöhykkeessä.
Aikavyöhykkeestä riippumaton- ja Vain päivämäärä -toiminnassa asiakasohjelman ohjelmointirajapinnan tulosta ei tule tulkita selaimen aikavyöhykkeen arvona. Käytä sen kanssa esimerkiksi Date.getDate()- tai Date.getHours()-arvoa. Älä käytä esimerkiksi Date.getUTCDate()- ja Date.getUTCHours()-arvoa, koska aikavyöhykkeiden määrittämistä ei tarvita.
Käyttäjän paikallinen -toiminnan muuttaminen
Voit muuttaa aiemmin luotujen mukautettujen päivämääräsarakkeiden toimintatavan Käyttäjän paikallinen -arvosta Vain päivämäärä- tai Aikavyöhykkeestä riippumaton -arvoksi, jos hallitun ratkaisun julkaisija ei estä tätä. Tämän muutoksen voi tehdä vain kerran.
Sarakkeen toimintatavan muuttaminen vaikuttaa niiden sarakkeiden arvoihin, jotka on lisätty tai joita on muokattu sarakkeen toimintatavan muuttamisen jälkeen. Aiemmin luodut sarakearvot säilyvät tietokannassa UTC-aikavyöhykkeen muodossa. Jos haluat muuttaa olemassa olevien sarakearvojen toimintatapaa UTC-toiminnasta Vain päivämäärä -toimintatavaksi, saatat tarvita kehittäjän apua tietokannan olemassa olevien päivämäärä- ja aika-arvojen muuntamisessa.
Varoitus
Tarkista ennen aiemmin luodun päivämäärän ja kellonajan sarakkeen toimintatavan muuttamista kaikki sarakkeen riippuvuudet, kuten liiketoimintasäännöt, työnkulut sekä laskennalliset sarakkeet tai koostesarakkeet. Näin varmistat, että toimintatavan muuttamisesta ei aiheudu ongelmia. Kun päivämäärän ja kellonajan sarakkeen toimintatapaa on muutettu, avaa jokainen liiketoimintasääntö, laskennallinen sarake ja koostesarake, jolla on riippuvuus muutettuun sarakkeeseen, tarkista tiedot ja tallenna kohde. Näin varmistat, että käytössä ovat uusin päivämäärän ja kellonajan sarakkeen toimintatapa ja arvo.
Toimintatavan muuttaminen ratkaisun tuomisen aikana
Kun tuot päivämääräsarakkeen sisältävän ratkaisun Käyttäjän paikallinen -toimintatavan avulla, voit muuttaa toimintatavaksi Vain päivämäärä tai Aikavyöhykkeestä riippumaton.
Huomautus
Voit muuttaa olemassa olevan hallitun Vain päivämäärä- tai Päivämäärä ja aika -sarakkeen -toimintatavan arvoa vain, jos olet julkaisija. Jotta voit tehdä muutoksia näihin kenttiin, ratkaisuun on ensin tehtävä päivitys, joka lisää Vain päivämäärä- ja Päivämäärä ja aika -sarakkeen. Lisätietoja: Ratkaisujen ohjelmistopäivitys tai päivittäminen
Toimintatavan muuttamisen estäminen
Jos jaat mukautetun päivämääräsarakkeen hallitussa ratkaisussa, voit estää ratkaisun käyttämisen muuttamalla toimintatapaa. Voit määrittää hallitun ominaisuuden CanChangeDateTimeBehavior arvoksi Epätosi. Lisätietoja: Sarakkeiden hallittujen ominaisuuksien määrittäminen
Päivämäärän ja kellonajan kyselyoperaattorit, joita Vain päivämäärä -toimintatapa ei tue
Seuraavat päivämäärään ja kellonaikaan liittyvät kyselyoperaattorit ovat virheellisiä Vain päivämäärä -toimintatavalle. Virheellinen operaattori aiheuttaa poikkeuksen, kun jotakin näistä operaattoreista käytetään kyselyssä.
- Yli X minuuttia vanhat
- Yli X tuntia vanhat
- Edelliset X tuntia
- Seuraavat X tuntia
Katso myös
Mallipohjaisten sovellusten päivämäärän ja ajan ongelmiin liittyvien ongelmien etsintä
Sarakkeiden luominen ja muokkaaminen
Manuaalisten laskelmien automatisointi määrittämällä laskennalliset sarakkeet
Sarakkeen hallitut ominaisuudet
Hallitut ominaisuudet
Blogi: Aikavyöhykkeiden käsitteleminen Dataversessa
Päivämäärä- ja aikasarakkeen toimintatavan ja muodon määrittäminen koodin avulla
Huomautus
Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)
Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).