Datuma un laika kolonnas darbība un formāts

Sadaļā Microsoft Dataverse varat norādīt, kā lietotājiem tiek rādītas datuma un laika vērtības un kā tās tiek pielāgotas laika joslām.

Papildus standarta rekvizītiem, kas pieejami lielākajā daļā kolonnu, datuma un laika kolonnām ir divi papildu rekvizīti:

• Laika joslas pielāgošana: vai pielāgot laika joslu vērtības.
• Formāts: vai parādīt vērtības laika daļu.

Laika joslas pielāgošana

Dataverse saglabā visas datuma un laika vērtības UTC laika joslā. Kad jūsu lietotnē tiek rādītas lietotāju ievadītās vērtības vai apstrādes vērtības, Dataverse modeļa vadītas programmas var pielāgoties lietotāja laika joslai, izmantojot šīs uzvedības opcijas.

• Lokāls lietotājs: pielāgojiet lietotāja laika joslas vērtības. Šī ir datuma un laika formāta noklusējuma darbība . Jūs varat to vienu reizi mainīt uz citu uzvedību.
• Neatkarīga no laika joslas: nav laika joslas konvertēšanas. Šī ir tikai datuma formāta noklusējuma darbība .

Iestatiet lietotāja laika joslu personiskajās opcijās, nevis sistēmas laika joslu operētājsistēmā Windows, Android, iOS vai macOS. Tomēr sistēmas laika josla var ietekmēt klienta skriptus, kas darbojas ar JavaScript datumiem.

Formāts

Visām datuma un laika kolonnām ir laika daļa, ja vien to darbība nav Tikai datums. Formāts nosaka, vai parādīt vērtības laika daļu.

• Datums un laiks: parāda vērtības datumu un laiku.
• Tikai datums: parāda tikai vērtības datuma daļu.

Piezīmes

Lietotāji joprojām var mainīt laika daļu, ja formāts ir tikai datums. Piemēram, izmantojot Web API zvanus vai vadīklu, kurai ir laika daļa. Šī darbība atšķiras no uzvedībastikai datums, kur laika daļa vispār netiek saglabāta.

Lietošanas vadlīnijas

Izmantojiet neatkarīgu laika joslu , ja nav nepieciešama laika joslas informācija, piemēram, reģistrēšanās laiks viesnīcā. Izmantojot šo atlasi, lietotāji visās laika joslās redz vienu un to pašu datuma un laika vērtību.

Izmantojiet datumu tikai tad, ja informācija par diennakts laiku un laika joslu nav nepieciešama, piemēram, dzimšanas dienas vai gadadienas. Izmantojot šo atlasi, lietotāji visās laika joslās redz tieši to pašu datuma vērtību.

Laika joslas neatkarība no tikai datuma ir praktiski tas pats, kas kolonnas iestatīšana kā tikai datums. Izmantojiet pirmo, ja neesat pārliecināts, vai nākotnē jums būs nepieciešama laika daļa.

Svarīgi

Izvairieties no tikai datuma formāta ar lietotāja lokālo darbību. Lietotāji dažādās laika joslās var redzēt atšķirīgu datumu, kas vairumā gadījumu nav paredzēts. Kad lietotājs modeļa vadītā programmā iestata datumu, laika daļa automātiski tiek iestatīta uz pusnakti pēc laika joslas. Tas var izraisīt datuma parādīšanu dienu agrāk vai vēlāk citiem lietotājiem.

Piemēri

Parāda vērtības

Dataverse veikalus 2023-10-15T07:30:00Z (vai 2023-10-15 tikai datuma uzvedībai). Lietotāji laika joslā UTC-8 redz šos modeļa vadītā programmā vai ar Web API pieprasījumu formatētajai vērtībai:

Rīcība	Formāts	Parādāmā vērtība
Lietotāja vietējais laiks	Datums un laiks	2023. gada 14. oktobris, 11:30
Lietotāja vietējais laiks	Tikai datums	Oktobris 14th, 2023
Laika josla Neatkarīga	Datums un laiks	2023. gada 15. oktobris, 7:30
Laika josla Neatkarīga	Tikai datums	Oktobris 15th, 2023
Tikai datums	-	Oktobris 15th, 2023

Vērtību ievadīšana programmā

Lietotāji laika joslā UTC-8 ievada October 14th, 2023, 11:30 pm modeļa vadītu programmu. Vērtība tiek saglabāta Dataverse kā:

Rīcība	Formāts	Saglabātā vērtība Dataverse
Lietotāja vietējais laiks	Datums un laiks	2023-10-15T07:30:00Z
Lietotāja vietējais laiks	Tikai datums	2023-10-15T07:30:00Z
Laika josla Neatkarīga	Datums un laiks	2023-10-14T23:30:00Z
Laika josla Neatkarīga	Tikai datums	2023-10-14T23:30:00Z
Tikai datums	-	2023-10-14

Ja lietotājs ievada tikai datumu October 14th, 2023, tiek pieņemts, ka laika daļa ir 12:00.

Rīcība	Formāts	Saglabātā vērtība Dataverse
Lietotāja vietējais laiks	Tikai datums	2023-10-14T08:00:00Z
Laika josla Neatkarīga	Tikai datums	2023-10-14T00:00:00Z
Tikai datums	-	2023-10-14

Nederīgu vērtību ievadīšana programmā

Dažādiem klientiem ir dažādi veidi, kā apstrādāt nederīgu ievadi. Piemēram, Klusā okeāna laika joslā vasaras laiks sākās 2023. gada 12. martā pulksten 2:00, pārvietojot laiku par vienu stundu uz priekšu līdz 3:00. Laiks no pulksten 2:00 līdz 3:00 šajā dienā nepastāv. Kad lietotāji mēģina ievadīt vērtību šajā laika diapazonā, programmas var veikt kādu no šīm darbībām:

• Mainīt iepriekšējo vai nākamo derīgo laiku.
• Atgriezties pie pēdējās zināmās vērtības.
• Rādīt kļūdas ziņojumu.
• Laika atlasītājā nerādījiet laikus no pulksten 2:00 līdz 3:00, lai lietotāji tos nevarētu atlasīt.

Tāpat dažādiem klientiem ir dažādi veidi, kā rīkoties ar atkārtotiem laika diapazoniem. Piemēram, Klusā okeāna laika joslā vasaras laiks beidzās 2023. gada 5. novembrī pulksten 2:00, pārvietojot laiku par vienu stundu atpakaļ uz 1:00. Laiks no 1:00 līdz 2:00 šajā dienā tiek atkārtots divas reizes. Laiks, piemēram, 1:30, varētu attiekties uz abām laika joslām. Ja jums ir nepieciešams nepārprotami rādīt vai ievadīt laiku šajā diapazonā, vislabāk ir īslaicīgi pārslēgties uz laika joslu, kurā netiek izmantota vasaras laika saglabāšana.

Neapstrādātu vērtību iegūšana, izmantojot Web API

Dataverse veikalus 2023-10-15T07:30:00Z (vai 2023-10-15 tikai datuma uzvedībai). Lietotāji visās laika joslās saņem šīs vērtības, izmantojot tīmekļa API pieprasījumu par šo vērtību:

Rīcība	Formāts	Izejvērtība
Lietotāja vietējais laiks	Datums un laiks	2023-10-15T07:30:00Z
Lietotāja vietējais laiks	Tikai datums	2023-10-15T07:30:00Z
Laika josla Neatkarīga	Datums un laiks	2023-10-15T07:30:00Z
Laika josla Neatkarīga	Tikai datums	2023-10-15T07:30:00Z
Tikai datums	-	2023-10-15

Vērtību iegūšana, izmantojot klienta API

Lietotāji laika joslā UTC-8 ievada October 14th, 2023, 11:30 pm modeļa vadītu programmu. Klienta API funkcijas, piemēram, formContext.getAttribute(<column name>).getValue() atgriež vērtību ar piemērotajām laika joslas korekcijām:

Rīcība	Formāts	JavaScript dateValue.toUTCString()
Lietotāja vietējais laiks	Datums un laiks	2023-10-15 07:30 (UTC)
Lietotāja vietējais laiks	Tikai datums	2023-10-15 07:30 (UTC)

Laika joslas neatkarīgai darbībai JavaScript datuma vērtība ir pārlūkprogrammas laika joslā:

Rīcība	Formāts	JavaScript dateValue.toString()
Laika josla Neatkarīga	Datums un laiks	2023-10-14 23:30 (pārlūkprogrammas laika josla)
Laika josla Neatkarīga	Tikai datums	2023-10-14 23:30 (pārlūkprogrammas laika josla)

JavaScript datuma vērtībām vienmēr ir laika komponents. Tāpēc tikai datuma uzvedības laika komponents ir 12:00:

Rīcība	Formāts	JavaScript dateValue.toString()
Tikai datums	-	2023-10-15 00:00 (pārlūkprogrammas laika josla)

Piezīmes

JavaScript datuma vērtības ietekmē pārlūkprogrammas laika josla, kas nāk no ierīces operētājsistēmas iestatījumiem.

Lietotāja lokālajai uzvedībai interpretējiet klienta API rezultātu kā UTC vērtību. Izmantojiet Date.getUTCDate() vai Date.getUTCHours() strādājiet ar to. Lai iegūtu lietotāja redzēto, lietojiet getTimeZoneOffsetMinutes. Neizmantojiet Date.getDate() vai Date.getHours() tāpēc, ka šīs funkcijas rāda vērtību pārlūkprogrammas laika joslā.

Uzvedībai Laika josla neatkarīga un Tikai datums interpretējiet klienta API rezultātu kā vērtību pārlūkprogrammas laika joslā. Izmantojiet Date.getDate() vai Date.getHours() strādājiet ar to. Neizmantojiet Date.getUTCDate() vai Date.getUTCHours() tāpēc, ka jums nav jāpielāgo neviena laika josla.

Lietotāja vietējās uzvedības maiņa

Ja pārvaldītā risinājuma izdevējs nenovērš lokālās darbības maiņu, varat mainīt esošo pielāgoto datumu kolonnu darbību no Lokālais lietotājs uz Tikai datums vai Neatkarīgi no laika joslas. Tās ir vienreizējas izmaiņas.

Kolonnu uzvedības maiņa ietekmē kolonnas vērtības, kas ir pievienotas vai mainītas pēc tam, kad tika mainīta kolonnas darbība. Esošās kolonnas vērtības paliek bāzē UTC laika joslas formātā. Lai mainītu esošo kolonnu vērtību darbību no UTC uz tikai datumu, iespējams, ir nepieciešama izstrādātāja palīdzība, lai konvertētu datu bāzē esošo datuma un laika vērtību darbību.

Brīdinājums

Pirms esošas datuma un laika kolonnas darbības maiņas pārskatiet visas kolonnas atkarības, piemēram, biznesa kārtulas, darbplūsmas, aprēķinātās kolonnas vai apkopojuma kolonnas, lai pārliecinātos, ka darbības maiņas rezultātā nav problēmu. Pēc datuma un laika kolonnas darbības maiņas atveriet katru biznesa kārtulu, darbplūsmu, aprēķināto kolonnu un apkopojuma kolonnu atkarībā no mainītās kolonnas, pārskatiet informāciju un saglabājiet to, lai pārliecinātos, ka tiek izmantota jaunākās datuma un laika kolonnas darbība un vērtība.

Uzvedības maiņa risinājuma importēšanas laikā

Importējot risinājumu, kurā ir kolonna Datums ar lokālo lietotāju, varat mainīt uzvedību uz Tikai datums vai Neatkarīgi no laika joslas.

Piezīmes

Esošas pārvaldītas kolonnas Datums vai Datums un laiks darbību var mainīt tikai tad, ja esat izdevējs. Lai veiktu izmaiņas šajos laukos, ir jāveic jaunināšana risinājumam, kas pievienoja kolonnu Tikai datums vai Datums un laiks . Papildinformācija: Risinājuma jaunināšana vai atjaunināšana

Uzvedības nomaiņas liegšana

Ja pārvaldītā risinājumā izplatāt pielāgotu datuma kolonnu, neļaujiet lietotājiem, kas izmanto jūsu risinājumu, mainīt darbību, iestatot pārvaldīto rekvizītu CanChangeDateTimeBehavior uz False. Papildinformācija: Kolonnu pārvaldīto rekvizītu iestatīšana

Datuma un laika vaicājuma operatori netiek atbalstīti tikai datuma darbībai

Tālāk norādītie ar datumu un laiku saistītie vaicājumu operatori ir nederīgi tikai datuma darbībai . Nederīga operatora izņēmuma kļūda parādās, kad viens no šiem operatoriem tiek izmantots vaicājumā.

• Vecāki nekā X minūtes
• Vecāki nekā X stundas
• Iepriekšējās X stundas
• Nākamās X stundas

Skatiet arī:

Datuma un laika problēmu novēršana modeļa vadītās programmās
Kolonnu izveide un rediģēšana
Aprēķināto kolonnu definēšana, lai automatizētu manuālos aprēķinus
Kolonnu pārvaldītie rekvizīti
Pārvaldītie rekvizīti
Emuārs: Darbs ar laika joslām Dataverse
Datuma un laika kolonnas darbības un formāta konfigurēšana, izmantojot kodu