D365 – 日期和时间字段

前言

本文记录Dynamics CRM关于日期和时间字段的使用及其基础知识。

基本概念

Dataverse 以 UTC 时区存储所有日期和时间值。 当应用显示值或处理用户输入的值时，Dataverse 和模型驱动应用可以使用 “格式” 选项根据用户的时区进行调整。

新建“日期和时间”字段

在实体新建 日期和时间（Date and Time） 字段时，可以选择以下以下格式：仅日期或日期和时间。

在实体新建 日期和时间（Date and Time） 字段时，在 “高级选项” 中可以选择以下 “时区调整”。

此外，“时区调整” 的可选选项又根据 “格式” 变化，具体如下：

• 格式 选择 仅日期 时，“时区调整” 可以选择：

• 格式 选择 日期和时间 时，“时区调整” 可以选择：

P.S: 新建后的 “日期和时间” 字段，“格式” 和 “时区调整” 仍然可以在解决方案中修改。

“格式”和“时区调整”可以再更改吗？

已创建 的 “日期和时间” 字段，它的 “格式” 和 “时区调整” 是否还可以修改？经验证，结果如下：

“时区调整”该如何选？

小实验

我将在 Invoice 实体新添如下 5 个 “日期和时间” 字段，然后对它们进行赋值，接着到 DB 上看看存储情况。

• 目前我使用的的时区是 (GMT+08:00) Beijing, Chongqing, Hong Kong, Urumqi
• 用户 Test06 使用的的时区是 (GMT+04:00) Baku

（1）新建字段

5 个“日期和时间”字段如下：

（2）在表单中填写“日期和时间”字段

在 (GMT+08:00) Beijing, Chongqing, Hong Kong, Urumqi 时区下，对字段进行赋值：

（3）在数据库查看数据

结果如下：

为什么 D - User Local 在 DB 中存储的是 2025-03-09 16:00:00.000 ？ 我在 (GMT+08:00) Beijing, Chongqing, Hong Kong, Urumqi 时区下，对 D - User Local 进行赋值，填写的时间是 2025-03-10 但是在数据库中，时间被存储为 UTC 时区，在东八区到 UTC 之间有 8 小时的时差 所以在本地填写的 2025-03-10 日期被转换到 UTC 时区时，就变成了 2025-03-09 16:00:00.000

DT - User Local 同理。

SELECT gdh_d_userlocal AS 'D - User Local',
       gdh_d_tz_independent AS 'D - TZ independent',
       gdh_d_d AS 'D - D',
       gdh_dt_userlocal AS 'DT - User Local',
       gdh_dt_tz_independent AS 'DT - TZ independent'
FROM   gdh_invoice
WHERE  gdh_no = 'SAS-00000001';

（4）使用 Test06 查看数据

注：用户 Test06 使用的的时区是 (GMT+04:00) Baku

为什么 用户 Test06 在表单上看到的 D - User Local 是 2025-03-10 10:30:00.000 ？

D - User Local 在数据库中存储的时间是 2025-03-10 06:30:00.000 (UTC 时区)，

当这个时间转换到用户 Test06 所在的时区：“(GMT+04:00) Baku”，

时间就变成了 2025-03-10 10:30:00.000（ UTC + 4），

所以用户 Test06 在表单上看到的 D - User Local 是 2025-03-10 10:30:00.000

（4）使用 Client API 获取

a. 获取 D - User Local 和 DT - User Local

// 'Sun, 09 Mar 2025 16:00:00 GMT'
Xrm.Page.getAttribute("gdh_d_userlocal").getValue().toUTCString(); 

// 'Sun, 09 Mar 2025 16:00:00 GMT'
Xrm.Page.getAttribute("gdh_d_userlocal").getValue().toUTCString(); 

b.对于 “时区无关”，返回的是浏览器的时区

获取 D-TZ independent 和 DT-TZ independent

// 'Wed Mar 12 2025 00:00:00 GMT+0800 (中国标准时间)'
Xrm.Page.getAttribute("gdh_d_tz_independent").getValue().toString(); 

// 'Mon Mar 24 2025 09:30:00 GMT+0800 (中国标准时间)'
Xrm.Page.getAttribute("gdh_dt_tz_independent").getValue().toString(); 

（5）使用 Web API 获取

在 (GMT+08:00) Beijing, Chongqing, Hong Kong, Urumqi 时区下，对字段进行赋值，并通过 Web API 获取：

可以看出，通过 Web API 获取的原始值，和数据库存储的一样。

var req = new XMLHttpRequest();
req.open("GET", Xrm.Page.context.getClientUrl() + "/api/data/v9.1/gdh_invoices(98F83878-1E35-EF11-8409-0017FA0671FA)?$select=gdh_d_d,gdh_d_tz_independent,gdh_d_userlocal,gdh_dt_tz_independent,gdh_dt_userlocal", true);
req.setRequestHeader("OData-MaxVersion", "4.0");
req.setRequestHeader("OData-Version", "4.0");
req.setRequestHeader("Accept", "application/json");
req.setRequestHeader("Content-Type", "application/json; charset=utf-8");
req.setRequestHeader("Prefer", "odata.include-annotations=\"*\"");
req.onreadystatechange = function() {
    if (this.readyState === 4) {
        req.onreadystatechange = null;
        if (this.status === 200) {
            var result = JSON.parse(this.response);
            var gdh_d_d = result["gdh_d_d"];
            var gdh_d_tz_independent = result["gdh_d_tz_independent"];
            var gdh_d_userlocal = result["gdh_d_userlocal"];
            var gdh_dt_tz_independent = result["gdh_dt_tz_independent"];
            var gdh_dt_userlocal = result["gdh_dt_userlocal"];
        } else {
            Xrm.Utility.alertDialog(this.statusText);
        }
    }
};
req.send();

查询运算符不支持？

“仅限日期” 类型的日期和时间字段，不允许使用下面的查询运算符，当这些运算符用于查询时，会引发无效运算符异常错误。

• X 分钟以前
• X 小时以前
• 过去 X 小时
• 接下来 X 小时

例如：对 “D-D” 列进行筛选，筛选条件如下：

<condition attribute="gdh_d_d" operator="last-x-hours" value="5"/>

执行后会报错：2147779605The operator is not valid or it is not supported.

如何设置用户的时区？

右上角的设置按钮 –> 个性化设置 –> General Tab –> 选择时区

参考

1. 使用 Power Apps 解决方案资源管理器创建和编辑 Microsoft Dataverse 的列
2. Column Data types