Comportamento e formato da columna de data e hora
En Microsoft Dataverse, podes especificar como se mostran aos usuarios os valores de data e hora e como se axustan aos fusos horarios.
Hai dúas opcións dispoñibles para as columnas de data e hora.
- Comportamento: indica se se deben axustar os valores dos fusos horarios.
- Formato: indica se se debe mostrar a parte horaria do valor.
Comportamento
Dataverse almacena todos os valores de data e hora na zona horaria UTC. Cando a túa aplicación mostra valores ou valores de procesamento introducidos polos usuarios, Dataverse e as aplicacións baseadas en modelos pódense axustar á zona horaria do usuario con estas opcións de Comportamento .
- Usuario local: axusta os valores da zona horaria do usuario. Este é o comportamento por defecto. Podes cambiar este comportamento unha vez por outro.
- Independente da zona horaria: non hai conversión da zona horaria.
- Só data: non hai conversión de zona horaria. A diferenza de Independiente da zona horaria, a parte horaria non se almacena.
A zona horaria do usuario establécese en opcións persoais, non na zona horaria do sistema en Windows, Android, iOS ou macOS. Non obstante, a zona horaria do sistema pode afectar aos scripts de clientes que funcionan con Datas de JavaScript.
Formato
Todas as columnas de data e hora teñen unha parte horaria a non ser que o seu comportamento sexa Só data. Format determina se se mostra a parte horaria do valor.
- Data e hora: mostra a data e a hora do valor.
- Só data: mostra só a parte da data do valor.
Nota
Os usuarios aínda poden cambiar a parte horaria se o Formato é Só data. Por exemplo, con chamadas á API web ou mediante un control que teña a parte do tempo. Isto é diferente do Só data Comportamento, onde a parte horaria non se almacena en absoluto.
Pautas de uso
Usa un comportamento independente da zona horaria se non se precisa a información da zona horaria, como as horas de facturación no hotel. Con esta selección, os usuarios de todas as zonas horarias ven o mesmo valor de data e hora.
Usa o comportamento Só data se non se precisa información sobre a hora do día e a zona horaria, como aniversarios ou aniversarios. Con esta selección, os usuarios de todas as zonas horarias ven exactamente o mesmo valor de data.
O comportamento independiente da zona horaria co formato só data é practicamente o mesmo que só data comportamento. Use o primeiro se non está seguro de se necesita a parte do tempo no futuro.
Exemplos
Mostrar valores
Dataverse almacena 2023-10-15T07:30:00Z (ou 2023-10-15 para só data comportamento). Os usuarios da zona horaria UTC-8 ven estes na aplicación baseada en modelos ou cunha solicitude da API web para o valor con formato:
| Comportamento | Formato | Valor de visualización |
|---|---|---|
| Hora local do usuario | Data e hora | 14 de outubro de 2023 ás 23:30 |
| Hora local do usuario | Só data | 14 de outubro de 2023 |
| Zona horaria Independente | Data e hora | 15 de outubro de 2023 ás 07:30 |
| Zona horaria Independente | Só data | 15 de outubro de 2023 |
| Só data | - | 15 de outubro de 2023 |
Introduza valores nunha aplicación
Os usuarios da zona horaria UTC-8 entran October 14th, 2023, 11:30 pm nunha aplicación baseada en modelos. O valor gárdase en Dataverse como:
| Comportamento | Formato | Valor gardado en Dataverse |
|---|---|---|
| Hora local do usuario | Data e hora | 2023-10-15T07:30:00Z |
| Hora local do usuario | Só data | 2023-10-15T07:30:00Z |
| Zona horaria Independente | Data e hora | 2023-10-14T23:30:00Z |
| Zona horaria Independente | Só data | 2023-10-14T23:30:00Z |
| Só data | - | 2023-10-14 |
Se o usuario introduce só a data October 14th, 2023, suponse que a parte horaria é as 12:00 horas.
| Comportamento | Formato | Valor gardado en Dataverse |
|---|---|---|
| Hora local do usuario | Só data | 2023-10-14T08:00:00Z |
| Zona horaria Independente | Só data | 2023-10-14T00:00:00Z |
| Só data | - | 2023-10-14 |
Introduce valores non válidos nunha aplicación
Os diferentes clientes teñen diferentes formas de xestionar entradas non válidas. Por exemplo, na zona horaria do Pacífico, o horario de verán comezou o 12 de marzo de 2023 ás 2:00 a. m., adiantando a hora unha hora ata as 3:00 a. m. A hora entre as 2:00 e as 3:00 horas dese día non existe. Cando os usuarios tentan introducir un valor nese intervalo de tempo, as aplicacións poden facer unha das seguintes accións:
- Cambia á hora válida anterior ou seguinte.
- Volver ao último valor coñecido.
- Mostra unha mensaxe de erro.
- Non mostres as horas entre as 2:00 e as 3:00 horas no selector horario, para que os usuarios non poidan seleccionalas en primeiro lugar.
Do mesmo xeito, os diferentes clientes teñen diferentes formas de manexar intervalos de tempo repetidos. Por exemplo, na zona horaria do Pacífico, o horario de verán rematou o 5 de novembro de 2023 ás 2:00 a. m., o que retrocedeu unha hora ata a 1:00 a. m. O tempo entre a 1:00 AM e as 2:00 AM dese día repítese dúas veces. Unha hora como a 1:30 da mañá pode referirse a calquera dos fusos horarios. Se precisas mostrar ou introducir horas sen ambigüidades nese intervalo, o mellor é cambiar temporalmente a unha zona horaria que non utilice o horario de verán.
Obtén valores brutos coa API web
Dataverse almacena 2023-10-15T07:30:00Z (ou 2023-10-15 para só data comportamento). Os usuarios de todas as zonas horarias obtéñenas cunha solicitude de API web para o valor:
| Comportamento | Formato | Valor bruto |
|---|---|---|
| Hora local do usuario | Data e hora | 2023-10-15T07:30:00Z |
| Hora local do usuario | Só data | 2023-10-15T07:30:00Z |
| Zona horaria Independente | Data e hora | 2023-10-15T07:30:00Z |
| Zona horaria Independente | Só data | 2023-10-15T07:30:00Z |
| Só data | - | 2023-10-15 |
Obtén valores coa API de cliente
Os usuarios da zona horaria UTC-8 entran October 14th, 2023, 11:30 pm nunha aplicación baseada en modelos. A API do cliente funciona como formContext.getAttribute(<column name>).getValue() devolver o valor cos axustes da zona horaria aplicados:
| Comportamento | Formato | JavaScript dateValue.toUTCString() |
|---|---|---|
| Hora local do usuario | Data e hora | 2023-10-15 07:30 (UTC) |
| Hora local do usuario | Só data | 2023-10-15 07:30 (UTC) |
Para o comportamento independiente da zona horaria, o valor da data de JavaScript está no fuso horario do navegador:
| Comportamento | Formato | JavaScript dateValue.toString() |
|---|---|---|
| Zona horaria Independente | Data e hora | 2023-10-14 23:30 (zona horaria do navegador) |
| Zona horaria Independente | Só data | 2023-10-14 23:30 (zona horaria do navegador) |
Os valores de data de JavaScript sempre teñen un compoñente de hora. É por iso que o comportamento só por data ten unha compoñente horaria de 12:00 horas:
| Comportamento | Formato | JavaScript dateValue.toString() |
|---|---|---|
| Só data | - | 2023-10-15 00:00 (zona horaria do navegador) |
Nota
Os valores de data de JavaScript vense afectados pola zona horaria do navegador, que procede da configuración do sistema operativo do dispositivo.
Para o comportamento local do usuario, o resultado da API do cliente debe interpretarse como un valor UTC. Use Date.getUTCDate(), Date.getUTCHours(), etc. para traballar con el. Para obter o que ve o usuario, aplique getTimeZoneOffsetMinutes. Non use Date.getDate(), Date.getHours(), etc. porque estes mostrarán o valor na zona horaria do navegador.
Para o comportamento independente da zona horaria e só data, o resultado da API do cliente debe interpretarse como un valor no navegador franxa horaria. Use Date.getDate(), Date.getHours(), etc. para traballar con el. Non utilices Date.getUTCDate(), Date.getUTCHours(), etc. porque non tes que axustar ningún fuso horario.
Cambia o comportamento local do usuario
A menos que o editor dun solución administrada o impida, pode cambiar o comportamento das columnas de data personalizadas existentes de Usuario local a Só data ou Independiente da zona horaria. Este é un cambio dunha soa vez.
Modificar o comportamento da columna afecta aos valores de columna que se engadiron ou modificaron unha vez que se modificou o comportamento da columna. Os valores de columna existentes permanecen na base de datos no formato UTC do fuso horario. Para cambiar o comportamento dos valores de columna existentes de UTC a Só data, é posible que necesites a axuda dun programador para converter o comportamento da data existente e valores de tempo na base de datos.
Aviso
Antes de modificar o comportamento dunha columna de data e hora existente, debería revisar todas as dependencias da columna, como as regras de negocio, os fluxos de traballo, as columnas calculadas ou de resumo, para asegurar que non se producirán problemas debido ao cambio de comportamento. Despois de cambiar o comportamento dunha columna de data e hora, abra cada regra de negocio, fluxo de traballo, columna calculada e columna acumulativa que dependen da columna que cambiou, revise a información e gárdaa para asegurarse de que o comportamento da última columna de data e hora e valor utilízanse.
Modificar o comportamento durante unha importación de solución
Cando importa unha solución que contén unha columna de data co comportamento Usuario local, pode cambiar o comportamento a Só data ou Independiente da zona horaria.
Nota
Só podes cambiar o comportamento dunha columna Só data ou Data e hora se é o editor xestionada. . Para facer un cambio nestes campos, débese actualizar a solución que engadiu Só data ou Data e hora columna. Máis información: Actualizar unha solución
Evitar o cambio de comportamento
Se estás distribuíndo unha columna de data personalizada nun solución administrada, evita que as persoas que utilicen a túa solución cambien o comportamento configurando a CanChangeDateTimeBehavior propiedade xestionada en Falso. Máis información: Definir as propiedades de columnas administradas
Os operadores de consulta de data e hora non son compatibles co comportamento de só data
Os seguintes operadores de consulta relacionados coa data e a hora non son válidos para o comportamento Só data . Prodúcese un erro de excepción de operador non válido cando un destes operadores se utiliza na consulta.
- Con máis de X minutos
- Con máis de X horas
- Últimas X horas
- As próximas X horas
Consulte tamén
Soluciona problemas de data e hora nas aplicacións baseadas en modelos
Crear e editar columnas
Defina columnas calculadas para automatizar os cálculos manuais
Propiedades xestionadas por columnas
Propiedades xestionadas
Blog: Traballando con fusos horarios no Dataverse
Configure o comportamento e o formato da columna de data e hora mediante código
Nota
Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)
Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).
Comentarios
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte: https://aka.ms/ContentUserFeedback.
Enviar e ver os comentarios