Datuma un laika kolonnas izturēšanās un formāts
Varat Microsoft Dataverse 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.
Datuma un laika kolonnām ir pieejamas divas opcijas.
- Izturēšanās: vai pielāgot vērtības laika joslām.
- Formāts: vai parādīt vērtības laika daļu.
Izturēšanās
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 un modeļa vadītas programmas var pielāgoties lietotāja laika joslai, Dataverse izmantojot tālāk norādītās uzvedības opcijas.
- Lietotāja lokālā atrašanās vieta: pielāgojiet lietotāja laika joslas vērtības. Šī ir noklusējuma uzvedība. To var mainīt vienu reizi uz citu uzvedību.
- No laika joslas neatkarīgs: nav laika joslas pārveidošanas.
- Tikai datums: nav laika joslas konvertēšanas. Atšķirībā no neatkarīgas laika joslas, laika daļa netiek saglabāta.
Lietotāja laika josla ir iestatīta personiskajās opcijās, nevis sistēmas laika joslā 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.
Formatēt
Visām datuma un laika kolonnām ir laika daļa, ja vien tās 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īme
Lietotāji joprojām var mainīt laika daļu, ja formāts ir Tikai datums. Piemēram, ar Web API izsaukumiem vai izmantojot vadīklu, kurai ir laika daļa. Tas atšķiras no darbības tikai datuma režīmā, kur laika daļa vispār netiek saglabāta.
Lietošanas vadlīnijas
Izmantojiet no laika joslas neatkarīgu uzvedību, ja laika joslas informācija nav nepieciešama, piemēram, reģistrēšanās viesnīcā laikus. Izmantojot šo atlasi, lietotāji visās laika joslās redz vienu un to pašu datuma un laika vērtību.
Izmantojiet darbību Tikai datums, ja informācija par diennakts laiku un laika joslu nav nepieciešama, piemēram, dzimšanas dienas vai jubilejas. Izmantojot šo atlasi, lietotāji visās laika joslās redz tieši tādu pašu datuma vērtību.
No laika joslas neatkarīga darbība ar formātu Tikai datums ir praktiski tāda pati kā tikai datuma darbība. Izmantojiet pirmo, ja neesat pārliecināts, vai jums nākotnē būs nepieciešama laika daļa.
Svarīgi
Izvairieties no formāta Tikai datums, izmantojot lietotāja lokālo uzvedību. Lietotājiem dažādās laika joslās var tikt rādīts cits datums, kas nav paredzēts lielākajā daļā scenāriju. Kad lietotājs modeļa vadītā programmā iestata datumu, laika daļa tiek automātiski iestatīta uz laika joslas pusnakti. Tas var izraisīt datuma parādīšanos dienu agrāk vai vēlāk citiem lietotājiem.
Piemēri
Parādāmās vērtības
Dataverse stores 2023-10-15T07:30:00Z (vai 2023-10-15 darbībai Tikai datums). Laika joslas UTC-8 lietotāji tos redz modeļa vadītā programmā vai ar tīmekļa API pieprasījumu formatētajai vērtībai:
| Izturēšanās | Formatēt | Parādāmā vērtība |
|---|---|---|
| Lietotāja vietējais laiks | Datums un laiks | 11:30 2023. gada 14. oktobrī |
| Lietotāja vietējais laiks | Tikai datums | 2023. gada 14. oktobrī |
| Laika josla Neatkarīgs | Datums un laiks | 7:30 2023. gada 15. oktobrī |
| Laika josla Neatkarīgs | Tikai datums | 2023. gada 15. oktobrī |
| Tikai datums | - | 2023. gada 15. oktobrī |
Vērtību ievadīšana lietojumprogrammā
Laika joslas UTC-8 lietotāji ievada October 14th, 2023, 11:30 pm modeļa vadītu programmu. Vērtība tiek saglabāta Dataverse kā:
| Izturēšanās | Formatēt | 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īgs | Datums un laiks | 2023-10-14T23:30:00Z |
| Laika josla Neatkarīgs | 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 AM.
| Izturēšanās | Formatēt | Saglabātā vērtība Dataverse |
|---|---|---|
| Lietotāja vietējais laiks | Tikai datums | 2023-10-14T08:00:00Z |
| Laika josla Neatkarīgs | Tikai datums | 2023-10-14T00:00:00Z |
| Tikai datums | - | 2023-10-14 |
Nederīgu vērtību ievadīšana lietojumprogrammā
Dažādiem klientiem ir dažādi veidi, kā rīkoties ar nederīgu ievadi. Piemēram, Klusā okeāna laika joslā vasaras laika taupīšana sākās 2023. gada 12. martā pulksten 2:00, pārceļot laiku par vienu stundu uz priekšu līdz 3:00 AM. Laiks starp 2:00 AM un 3:00 AM š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:
- Mainiet uz iepriekšējo vai nākamo derīgo laiku.
- Atjaunot iepriekšējo versiju līdz pēdējai zināmajai vērtībai.
- Rādīt kļūdas ziņojumu.
- Laika atlasītājā nerādiet laikus no 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 laika taupīšana beidzās 5. gada 2023. novembrī pulksten 2:00 AM, pārvietojot laiku atpakaļ par vienu stundu atpakaļ uz 1:00 AM. Laiks no 1:00 AM līdz 2:00 AM šajā dienā tiek atkārtots divas reizes. Laiks, piemēram, 1:30 AM, varētu attiekties uz abām laika joslām. Ja jums ir nepārprotami jārāda vai jāievada laiki šajā diapazonā, ieteicams īslaicīgi pārslēgties uz laika joslu, kurā netiek izmantota vasaras laika saglabāšana.
Neapstrādātu vērtību iegūšana, izmantojot tīmekļa API
Dataverse stores 2023-10-15T07:30:00Z (vai 2023-10-15 darbībai Tikai datums). Lietotāji visās laika joslās tos iegūst ar Web API pieprasījumu par vērtību:
| Izturēšanās | Formatēt | Neapstrādāta vē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īgs | Datums un laiks | 2023-10-15T07:30:00Z |
| Laika josla Neatkarīgs | Tikai datums | 2023-10-15T07:30:00Z |
| Tikai datums | - | 2023-10-15 |
Vērtību iegūšana, izmantojot Client API
Laika joslas UTC-8 lietotāji ievada October 14th, 2023, 11:30 pm modeļa vadītu programmu. Klienta API funkcijas, piemēram formContext.getAttribute(<column name>).getValue() , vērtības atgriešana, piemērojot laika joslas korekcijas:
| Izturēšanās | Formatēt | 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) |
No laika joslas neatkarīgai darbībai JavaScript datuma vērtība atrodas pārlūkprogrammas laika joslā:
| Izturēšanās | Formatēt | JavaScript dateValue.toString() |
|---|---|---|
| Laika josla Neatkarīgs | Datums un laiks | 2023-10-14 23:30 (pārlūka laika josla) |
| Laika josla Neatkarīgs | Tikai datums | 2023-10-14 23:30 (pārlūka laika josla) |
JavaScript datumu vērtībām vienmēr ir laika komponents. Tāpēc tikai datuma darbības laika komponents ir 12:00 AM:
| Izturēšanās | Formatēt | JavaScript dateValue.toString() |
|---|---|---|
| Tikai datums | - | 2023-10-15 00:00 (pārlūka laika josla) |
Piezīme
JavaScript datumu vērtības ietekmē pārlūkprogrammas laika josla, kas nāk no ierīces operētājsistēmas iestatījumiem.
Lietotāja lokālās uzvedības gadījumā Klienta API rezultāts ir jāinterpretē kā UTC vērtība. Izmantojiet Date.getUTCDate(), Date.getUTCHours(), utt., lai strādātu ar to. Lai iegūtu to, ko lietotājs redz, lietojiet getTimeZoneOffsetMinutes. Nelietojiet Date.getDate() utt Date.getHours()., Jo tie parādīs vērtību pārlūkprogrammas laika joslā.
Ja darbība ir neatkarīga no laika joslas un darbojas tikai datumā, Klienta API rezultāts ir jāinterpretē kā vērtība pārlūkprogrammas laika joslā. Izmantojiet Date.getDate(), Date.getHours(), utt., lai strādātu ar to. Neizmantojiet Date.getUTCDate() un tā tālāk, Date.getUTCHours() jo jums nav jāpielāgojas nevienai laika joslai.
Lietotāja lokālās darbības maiņa
Ja vien pārvaldīts risinājums izdevējs to neliedz, varat mainīt esošo pielāgoto datumu kolonnu darbību no Lietotājs lokāls uz Tikai datums vai Neatkarīgs 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 datums, iespējams, būs 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ša datuma un laika kolonnas darbības maiņas pārskatiet visas šīs kolonnas atkarības, piemēram, biznesa kārtulas, darbplūsmas un aprēķinātās vai apkopojuma kolonnas, lai pārliecinātos, ka darbības maiņas rezultātā neradīsies problēmas. Pēc datuma un laika kolonnas darbības maiņas atveriet katru biznesa kārtulu, darbplūsmu, aprēķināto kolonnu un apkopojuma kolonnu, kas ir atkarīga no mainītās kolonnas, pārskatiet informāciju un saglabājiet to, lai nodrošinātu, 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 lietotāja lokālo uzvedību, varat mainīt darbību uz Tikai datums vai Neatkarīgs no laika joslas.
Piezīme
Esošas pārvaldītas kolonnas Tikai datums vai kolonnas 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 uz risinājumu, kas pievienoja kolonnu Tikai datums vai Datums un laiks . Papildu informācija: Risinājuma importēšana, atjaunināšana un eksportēšana
Uzvedības nomaiņas liegšana
Ja pārvaldīts risinājums izplatāt pielāgotu datumu kolonnu, neļaujiet lietotājiem, kuri izmanto jūsu risinājumu, mainīt darbību, iestatot pārvaldītā rekvizīta CanChangeDateTimeBehavior vērtību Aplams. Papildinformācija: Pārvaldīto rekvizītu kolonnu iestatīšana
Datuma un laika vaicājumu operatori, kas netiek atbalstīti darbībai tikai datumā
Tālāk norādītie ar datumu un laiku saistītie vaicājumu operatori darbībai Tikai datums nav derīgi . 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ālus aprēķinus
Kolonnas 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
Piezīme
Kādas ir jūsu dokumentācijas valodas preferences? Aizpildiet īsu aptauju. (ņemiet vērā, ka aptauja ir angļu valodā)
Aptaujai būs nepieciešamas aptuveni septiņas minūtes. Nekādi personas dati netiks vākti (paziņojums par konfidencialitāti).
Atsauksmes
Drīzumā: 2024. gada laikā mēs pakāpeniski pārtrauksim izmantot “GitHub problēmas” kā atsauksmju par saturu mehānismu un aizstāsim to ar jaunu atsauksmju sistēmu. Papildinformāciju skatiet: https://aka.ms/ContentUserFeedback.
Iesniegt un skatīt atsauksmes par