Nota
L'accés a aquesta pàgina requereix autorització. Podeu provar d'iniciar la sessió o de canviar els directoris.
L'accés a aquesta pàgina requereix autorització. Podeu provar de canviar els directoris.
A , Microsoft Dataverse podeu especificar com es mostren els valors de data i hora als usuaris i com s'ajusten per a les zones horàries.
A més de les propietats estàndard disponibles amb la majoria de columnes, les columnes de data i hora tenen dues propietats addicionals:
- Ajust de fus horari: si s'han d'ajustar els valors per a les zones horàries.
- Format: si es mostra la part de temps del valor.
Ajust de fus horari
Dataverse emmagatzema tots els valors de data i hora a la zona horària UTC. Quan l'aplicació mostra valors o valors de processament introduïts pels usuaris, Dataverse les aplicacions basades en models poden ajustar-se a la zona horària de l'usuari amb aquestes opcions de comportament .
- Local de l'usuari: ajusta els valors de la zona horària de l'usuari. Aquest és el comportament per defecte per al format de data i hora . Podeu canviar-ho una vegada per un altre comportament.
- Independent de la zona horària: no hi ha conversió de fus horari. Aquest és el comportament per defecte per al format Només data.
Configura el fus horari de l'usuari a les opcions personals, no el fus horari del sistema a Windows, Android, iOS o macOS. Tanmateix, la zona horària del sistema pot afectar els scripts de client que funcionen amb dates de JavaScript.
Format
Totes les columnes de data i hora tenen una part horària, tret que el seu comportament sigui només de data. El format determina si es mostra la part de temps del valor.
- Data i hora: mostra la data i l'hora del valor.
- Només data: mostra només la part de data del valor.
Nota
Els usuaris encara poden canviar la part de temps si el format és Només data. Per exemple, utilitzant crides a l'API web o utilitzant un control que tingui la part de temps. Aquest comportament és diferent del de només data, on la part de temps no s'emmagatzema gens.
Directrius d'ús
Utilitza la zona horària independent quan no es requereix informació sobre la zona horària, com ara l'hora d'entrada de l'hotel. Amb aquesta selecció, els usuaris de totes les zones horàries veuen el mateix valor de data i hora.
Utilitza la data només quan no sigui necessària informació sobre l'hora del dia i el fus horari, com ara aniversaris o aniversaris. Amb aquesta selecció, els usuaris de totes les zones horàries veuen exactament el mateix valor de data.
Independent de fus horari amb només data és pràcticament el mateix que posar la columna només com a data. Utilitzeu el primer si no esteu segur de si necessiteu la part de temps en el futur.
Important
Eviteu el format només de data amb el comportament local de l'usuari. Els usuaris de diferents zones horàries poden veure una data diferent, cosa que no està prevista en la majoria d'escenaris. Quan un usuari estableix una data en una aplicació basada en models, la part horària es fixa automàticament a mitjanit de la seva zona horària. Això pot fer que la data aparegui un dia abans o més tard per a altres usuaris.
Exemples
Valors de visualització
Dataverse ( 2023-10-15T07:30:00Z o per al 2023-10-15 comportament de només data). Els usuaris de la zona horària UTC-8 els veuen a l'aplicació basada en models o amb una sol·licitud d'API web per al valor formatat:
| Comportament | Format | Mostra el valor |
|---|---|---|
| Local de l'usuari | Data i hora | 14 d'octubre de 2023 a les 23:30 |
| Local de l'usuari | Només la data | 14 d'octubre de 2023 |
| Zona horària Independent | Data i hora | 15 d'octubre de 2023 a les 07:30 |
| Zona horària Independent | Només la data | 15 d'octubre de 2023 |
| Només la data | - | 15 d'octubre de 2023 |
Introduir valors en una aplicació
Els usuaris de la zona horària UTC-8 entren October 14th, 2023, 11:30 pm en una aplicació basada en models. El valor es desa com Dataverse :
| Comportament | Format | Valor desat a Dataverse |
|---|---|---|
| Local de l'usuari | Data i hora | 2023-10-15T07:30:00Z |
| Local de l'usuari | Només la data | 2023-10-15T07:30:00Z |
| Zona horària Independent | Data i hora | 2023-10-14T23:30:00Z |
| Zona horària Independent | Només la data | 2023-10-14T23:30:00Z |
| Només la data | - | 2023-10-14 |
Si l'usuari introdueix només la data October 14th, 2023, se suposa que la part de l'hora és 12:00.
| Comportament | Format | Valor desat a Dataverse |
|---|---|---|
| Local de l'usuari | Només la data | 2023-10-14T08:00:00Z |
| Zona horària Independent | Només la data | 2023-10-14T00:00:00Z |
| Només la data | - | 2023-10-14 |
Introduir valors no vàlids en una aplicació
Els diferents clients tenen diferents maneres de gestionar les entrades no vàlides. Per exemple, a la zona horària del Pacífic, l'horari d'estiu va començar el 12 de març de 2023 a les 2:00 de la matinada, avançant l'hora fins a les 3:00 de la matinada. L'hora entre les 2:00 i les 3:00 d'aquest dia no existeix. Quan els usuaris intenten introduir un valor en aquest interval de temps, les aplicacions poden fer una de les accions següents:
- Canvia a l'hora vàlida anterior o següent.
- Torna a l'últim valor conegut.
- Mostra un missatge d'error.
- No mostreu les hores entre les 2:00 i les 3:00 al selector d'hora, de manera que els usuaris no puguin seleccionar-les en primer lloc.
De la mateixa manera, diferents clients tenen diferents maneres de gestionar intervals de temps repetits. Per exemple, a la zona horària del Pacífic, l'horari d'estiu va acabar el 5 de novembre de 2023 a les 2:00 de la matinada, avançant l'hora una hora fins a la 1:00 AM. El temps entre la 1:00 i les 2:00 d'aquest dia es repeteix dues vegades. Una hora com la 1:30 AM podria referir-se a qualsevol de les dues zones horàries. Si necessites mostrar o introduir hores d'aquest interval sense ambigüitats, el millor és canviar temporalment a una zona horària que no utilitzi l'horari d'estiu.
Obtenir valors sense processar amb l'API web
Dataverse ( 2023-10-15T07:30:00Z o per al 2023-10-15 comportament de només data). Els usuaris de totes les zones horàries obtenen aquests valors amb una petició de l'API web pel valor:
| Comportament | Format | Valor brut |
|---|---|---|
| Local de l'usuari | Data i hora | 2023-10-15T07:30:00Z |
| Local de l'usuari | Només la data | 2023-10-15T07:30:00Z |
| Zona horària Independent | Data i hora | 2023-10-15T07:30:00Z |
| Zona horària Independent | Només la data | 2023-10-15T07:30:00Z |
| Només la data | - | 2023-10-15 |
Obtenir valors amb l'API de client
Els usuaris de la zona horària UTC-8 entren October 14th, 2023, 11:30 pm en una aplicació basada en models.
Les funcions de l'API de client com formContext.getAttribute(<column name>).getValue() ara retornen el valor amb els ajustos de fus horari aplicats:
| Comportament | Format | JavaScript dateValue.toUTCString() |
|---|---|---|
| Local de l'usuari | Data i hora | 15/10/2023 07:30 (UTC) |
| Local de l'usuari | Només la data | 15/10/2023 07:30 (UTC) |
Per al comportament independent de la zona horària, el valor de la data de JavaScript es troba a la zona horària del navegador:
| Comportament | Format | JavaScript dateValue.toString() |
|---|---|---|
| Zona horària Independent | Data i hora | 2023-10-14 23:30 (zona horària del navegador) |
| Zona horària Independent | Només la data | 2023-10-14 23:30 (zona horària del navegador) |
Els valors de data de JavaScript sempre tenen un component de temps. És per això que el comportament de només data té un component d'hora de 12:00 AM:
| Comportament | Format | JavaScript dateValue.toString() |
|---|---|---|
| Només la data | - | 2023-10-15 00:00 (zona horària del navegador) |
Nota
Els valors de data de JavaScript es veuen afectats per la zona horària del navegador, que prové de la configuració del sistema operatiu del dispositiu.
Per al comportament local de l'usuari , interpreteu el resultat de l'API del client com un valor UTC. Utilitza-la Date.getUTCDate() o Date.getUTCHours() per treballar-hi. Per obtenir el que veu l'usuari, apliqueu getTimeZoneOffsetMinutes. No l'utilitzis Date.getDate() o Date.getHours() perquè aquestes funcions mostren el valor en la zona horària del navegador.
Per a comportaments independents de la zona horària i només per data, interpreteu el resultat de l'API del client com un valor dins del fus horari del navegador. Utilitza-la Date.getDate() o Date.getHours() per treballar-hi. No l'utilitzis Date.getUTCDate() ni Date.getUTCHours() perquè no has d'ajustar per cap fus horari.
Canviar el comportament local de l'usuari
A menys que l'editor d'una solució gestionada impedeixi canviar el comportament local, pots canviar el comportament de les columnes de dates personalitzades existents de local d'usuari a només de data o independent de fus horari. Aquest és un canvi únic.
Canviar el comportament de la columna afecta els valors de columna que s'afegeixen o es modifiquen després que hagi canviat el comportament de la columna. Els valors de columna existents romanen a la base de dades en el format de fus horari d'UTC. Per canviar el comportament dels valors de columna existents de UTC a Data només, potser necessiteu l'ajuda d'un desenvolupador per convertir el comportament dels valors de data i hora existents a la base de dades.
Advertiment
Abans de canviar el comportament d'una columna de data i hora existent, revisa totes les dependències d'aquesta columna, com ara regles de negoci, fluxos de treball, columnes calculades o columnes de rollup, per assegurar-te que no hi ha problemes com a resultat de canviar el comportament. Després de canviar el comportament d'una columna de data i hora, obriu cada regla de negoci, flux de treball, columna calculada i columna d'informe en funció de la columna que hàgiu canviat, reviseu la informació i deseu-la per assegurar-vos que s'utilitzen el comportament i el valor de la columna de data i hora més recent.
Canviar el comportament en importar la solució
Quan importes una solució que conté una columna de Data amb User local, pots canviar el comportament a només Data o independent de la zona horària.
Nota
Només podeu canviar el comportament d'una columna Només data o data i hora gestionada existent si sou l'editor. Per fer un canvi en aquests camps, s'ha de fer una actualització a la solució que ha afegit la columna Només data o Data i hora . Més informació: Actualitzar o actualitzar una solució
Impedir el canvi de comportament
Si esteu distribuint una columna de data personalitzada en una solució administrada, eviteu que les persones que utilitzen la solució canviïn el comportament definint la propietat administrada CanChangeDateTimeBehavior com a False. Més informació: Definir les propietats administrades per a les columnes
Els operadors de consulta de data i hora no s'admeten per al comportament Només data
Els operadors de consulta relacionats amb la data i l'hora següents no són vàlids per al comportament Només data. Quan un d'aquests operadors es fa servir en una consulta, es llança un error d'excepció d'operador no vàlid.
- Amb més de X minuts d'antiguitat
- Amb més d'X hores d'antiguitat
- Últimes X hores
- Següents X hores
Consulteu també
Resoldre problemes de data i hora a les aplicacions basades en models
Crear i editar columnes
Definiu columnes calculades per automatitzar càlculs manuals
Propietats administrades per columnes
Propietats gestionades
Blog: Treballar amb fusos horaris a la Dataverse
Configurar el comportament i el format de la columna de data i hora mitjançant el codi