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.

Useimmissa sarakkeissa käytettävissä olevien vakio-ominaisuuksien lisäksi päivämäärä- ja aikasarakkeilla on kaksi lisäominaisuudet:

• Aikavyöhykkeen säätö: Määrittää, säädetäänkö aikavyöhykkeiden arvoja.
• Muoto: Määrittää, näytetäänkö arvon aikaosa.

Aikavyöhykkeen säätö

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 Päivämäärä ja aika -muodon oletustoimintatapa. Voit muuttaa tämän kerran muuksi toiminnaksi.
• Aikavyöhykkeestä riippumaton: Ei aikavyöhykkeen muuntamista. Tämä on Vain päivämäärä -muodon oletustoimintatapa.

Määritä käyttäjän aikavyöhyke henkilökohtaisissa asetuksissa, ei järjestelmän aikavyöhykettä Windowsissa, Androidissa, iOS:ssä tai macOS:ssä. Kuitenkin järjestelmän aikavyöhyke voi vaikuttaa JavaScriptin päivämäärien kanssa toimiviin asiakasohjelman komentosarjoihin.

Muoto

Kaikissa päivämäärä- ja aikasarakkeissa on aikaosa, elleivät ne toiminta ole Vain päivämäärä -toimintaa. 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.

Muistiinpano

Käyttäjät voivat yhä muuttaa aikaosaa, jos muodon arvo on Vain päivämäärä. Esimerkiksi käyttämällä WWW-ohjelmointirajapinnan kutsuja tai käyttämällä ohjausobjektia, jossa on aikaosa. Tämä toiminta poikkeaa vain päivämääräntoiminnasta, jossa aikaosaa ei tallenneta lainkaan.

Käyttöohjeet

Käytä aikavyöhykkeestä riippumatonta , kun aikavyöhyketietoja ei tarvita, kuten hotelliin kirjautumisajat. Kun valinta on tämä, kaikkien aikavyöhykkeiden käyttäjät näkevät saman päivämäärän ja kellonajan arvon.

Käytä Päivämäärä-toimintoa vain , jos tietoja kellonajasta ja aikavyöhykkeestä ei tarvita. Tällaisia tietoja ovat esimerkiksi syntymäpäivät ja vuosipäivät. 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 javain päivämäärä on käytännössä sama kuin sarakkeen määrittäminen vain päivämääräksi. 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, aikaosa määrittää automaattisesti aikavyöhykkeen keskiyön. 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-15Vain päivämäärä -toiminnalle). Aikavyöhykkeen UTC-8 käyttäjät näkevät nämä mallipohjaisessa sovelluksessa tai muotoillun arvon verkko-ohjelmointirajapintapyynnön kanssa:

Toiminta	Muoto	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	Muoto	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	Muoto	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.3.2023 kello 2.00 ja aika ajoin tunnin välein klo 3.00 asti. 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.11.2023 kello 2.00, jolloin kello siirtyi taaksepäin yhdellä tunnilla kello 1.00:een. 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-15Vain päivämäärä -toiminnalle). Kaikkien aikavyöhykkeiden käyttäjät saavat nämä arvot WWW-ohjelmointirajapinnan arvopyynnöllä:

Toiminta	Muoto	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	Muoto	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	Muoto	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	Muoto	Javascript dateValue.toString()
Vain päivämäärä	-	2023-10-15 00:00 (selaimen aikavyöhyke)

Muistiinpano

Selaimen aikavyöhyke, joka saadaan laitteen käyttöjärjestelmän asetuksista, vaikuttaa JavaScriptin päivämääräarvoihin.

Asiakkaan ohjelmointirajapinnan tulos tulkitaan käyttäjän paikallisessa toiminnassa UTC-arvoksi. Käytä Date.getUTCDate() tai Date.getUTCHours() käsitelläksesi sen kanssa. Jos haluat tietää, mitä käyttäjät näkevät, käytä getTimeZoneOffsetMinutes-arvoa. Älä käytä Date.getDate()Date.getHours() tai koska nämä funktiot näyttävät arvon selaimen aikavyöhykkeellä.

Jos aikavyöhykkeestä on riippumaton ja päivämäärä on vain toiminta, asiakkaan ohjelmointirajapinnan tulos tulkitaan selaimen aikavyöhykkeen arvoksi. Käytä Date.getDate() tai Date.getHours() käsittelemiseen sitä. Älä käytä - Date.getUTCDate() vyöhykettä tai Date.getUTCHours() koska sinun ei tarvitse sopeutua mihinkään aikavyöhykkeisiin.

Käyttäjän paikallinen -toiminnan muuttaminen

Ellei hallitun ratkaisun julkaisija estä paikallisen toiminnan muuttamista, voit muuttaa olemassa olevien mukautettujen päivämääräsarakkeiden toiminnan vain käyttäjän paikallisestapäivämääräksi tai Aikavyöhykkeestä riippumaton -asetukseksi. 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

Ennen kuin muutat olemassa olevan päivämäärä ja aika -sarakkeen toimintaa, tarkista kaikki sarakkeen riippuvuudet, kuten liiketoimintasäännöt, työnkulut, lasketut sarakkeet tai koostesarakkeet. Näin varmistat, että toiminnan muuttamisesta ei ilmene 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 ratkaisun, joka sisältää Päivämäärä-sarakkeen käyttäjän paikallisessa yhteydessä, voit vaihtaa toiminnaksi vain päivämäärä tai Aikavyöhykkeestä riippumaton.

Muistiinpano

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
Hallinnoidut sarakeominaisuudet
Hallitut ominaisuudet
Blogi: Aikavyöhykkeiden käsitteleminen Dataversessa
Päivämäärä- ja aikasarakkeen toimintatavan ja muodon määrittäminen koodin avulla