Dynamics AX 2012 R2 在AIF服务契约中使用DateTime

      Reinhard在AIF中使用DateTime作为服务契约的参数，与DotNet程序进行交互时，总是因为时区的问题，导致DotNet提交的System.DateTime与AIF中接收的DateTime 不一致。

    这个问题着实困扰了Reinhard 许久。为了解决这个问题，Reinhard这次专门写一篇博文，通过一系列的实验，找到通过AIF服务契约，对DateTime进行存储、获取、比较的最佳方式。

1、DateTime存储实验

    在AX中，Reinhard写了三个存储DateTime方法，分别测试了System.DateTime和UtcDateTime作为服务契约参数的不同情况。这三个服务契约如下：

[SysEntryPointAttribute]

public void saveSystemDateTime(System.DateTime _dt)

{

    ReinhardTest_Table table;

    table.UtcDateTime=_dt;

    table.insert();

}

[SysEntryPointAttribute]

public void saveSystemDateTime2(System.DateTime _dt)

{

    ReinhardTest_Table table;

    table.UtcDateTime=Global::clrSystemDateTime2UtcDateTime( _dt);

    table.insert();

}

[SysEntryPointAttribute]

public void saveUtcDateTime( utcDateTime _utcDateTime)

{

    ReinhardTest_Table table;

    table.UtcDateTime=_utcDateTime;

    table.insert();

}

    接着，在VS中，Reinhard调用这三个服务契约，分别存储三个不同的System.DateTime实例，看哪个服务契约能够正确地存储DateTime。这三个日期分别是：

DateTime saveSystemDateTimeDT = new DateTime(2013, 3, 3, 3, 3, 3);

DateTime saveSystemDateTime2DT = new DateTime(2014, 4, 4, 4, 4, 4);

DateTime saveUtcDateTimeDT = new DateTime(2015, 5, 5, 5, 5, 5);

    调用完毕后，到AX中，查看ReinhardTest_Table中保存的日期。

    Reinhard发现，只有SaveUtcDateTime这个服务契约，正确保存了DotNet中System.DateTime的值。

结论：正确的日期存储方式是SaveUtcDateTime。

2、DateTime对比实验

    在AX中，Reinhard写了两个比较DateTime方法，分别测试了System.DateTime和UtcDateTime作为服务契约参数的不同情况。这两个服务契约如下：

[SysEntryPointAttribute]

public boolean compareUtcDateTime(utcDateTime _utcDateTime)

{

    ReinhardTest_Table table;

    select table order by table.UtcDateTime desc;

    return table.UtcDateTime==_utcDateTime;

}

[SysEntryPointAttribute]

public boolean compareSystemDateTime(System.DateTime _dt)

{

    ReinhardTest_Table table;

    utcDateTime dt= Global::clrSystemDateTime2UtcDateTime(_dt);

    select table order by table.UtcDateTime desc;

    return table.UtcDateTime==dt;

}

    这里，Reinhard选择了ReinhardTest_Table表中的最后一条记录，进行比较，也就是2015-05-05 05:05:05那条。

    接着，在VS中，Reinhard调用这两个服务契约，与同一个System.DateTime实例做比较，这个DateTime是：

DateTime saveUtcDateTimeDT = new DateTime(2015, 5, 5, 5, 5, 5);

    这个DateTime其实就是Reinhard在第一个实验中，最后一个保存的那个DateTime。不出意外的话，它应该与ReinhardTest_Table表中的最后一条记录是等价的。那么，我们来看看调用的结果吧。

    Reinhard发现，只有CompareUtcDateTime这个服务契约，正确比较了DotNet中System.DateTime与AX中UtcDateTime的值。

    结论：正确的日期比较方式是CompareUtcDateTime。

3、DateTime获取实验

    在AX中，Reinhard写了七个获取DateTime方法，分别测试了System.DateTime和UtcDateTime作为服务契约返回值的不同情况。这七个服务契约如下：

[SysEntryPointAttribute]

public utcDateTime getUtcDateTime()

{

    ReinhardTest_Table table;

    select table order by table.UtcDateTime desc;

    return table.UtcDateTime;

}

[SysEntryPointAttribute]

public utcDateTime getUtcDateTime2()

{

    ReinhardTest_Table table;

    select table order by table.UtcDateTime desc;

    return DateTimeUtil::applyTimeZoneOffset(table.UtcDateTime ,DateTimeUtil::getUserPreferredTimeZone());

}

[SysEntryPointAttribute]

public utcDateTime getUtcDateTime3()

{

    ReinhardTest_Table table;

    str strDT;

    select table order by table.UtcDateTime desc;

    return DateTimeUtil::applyTimeZoneOffset(table.UtcDateTime ,DateTimeUtil::getCompanyTimeZone());

}

[SysEntryPointAttribute]

public System.DateTime getSystemDateTime()

{

    ReinhardTest_Table table;

    select table order by table.UtcDateTime desc;

    return table.UtcDateTime;

}

[SysEntryPointAttribute]

public System.DateTime getSystemDateTime2()

{

    ReinhardTest_Table table;

    select table order by table.UtcDateTime desc;

    return DateTimeUtil::removeTimeZoneOffset(table.UtcDateTime,DateTimeUtil::getCompanyTimeZone());

}

[SysEntryPointAttribute]

public System.DateTime getSystemDateTime3()

{

    ReinhardTest_Table table;

    System.DateTime dt;

    utcDateTime utcDT;

    select table order by table.UtcDateTime desc;

    utcDT=DateTimeUtil::removeTimeZoneOffset(table.UtcDateTime,DateTimeUtil::getCompanyTimeZone());

    dt=Global::utcDateTime2SystemDateTime(utcDT);

    return dt;

}

[SysEntryPointAttribute]

public System.DateTime getStringDateTime4()

{

    ReinhardTest_Table table;

    str strDT;

    select table order by table.UtcDateTime desc;

    strDT = DateTimeUtil::toStr(table.UtcDateTime);

    return System.DateTime::Parse(strDT);

}

    这里，Reinhard同样选择了ReinhardTest_Table表中的最后一条记录，将其返回给DotNet，也就是2015-05-05 05:05:05那条。

    接着，在VS中，Reinhard调用这七个服务契约，看看他们返回给DotNet的Date
Time：

    Reinhard发现，只有GetUtcDateTime2和GetUtcDateTime3这个两个服务契约，给DotNet返回了正确的DateTime。

结论：正确的日期获取方式是GetUtcDateTime2和GetUtcDateTime3。

4、总结

    下面，Reinhard对通过AIF服务契约，进行DateTime存储、获取、比较的正确方式，进行总结。

4.1、DateTime存储

[SysEntryPointAttribute]

public void saveUtcDateTime( utcDateTime _utcDateTime)

{

    ReinhardTest_Table table;

    table.UtcDateTime=_utcDateTime;

    table.insert();

}

4.2、DateTime对比

[SysEntryPointAttribute]

public boolean compareUtcDateTime( utcDateTime _utcDateTime)

{

    ReinhardTest_Table table;

    select table order by table.UtcDateTime desc;

    return table.UtcDateTime==_utcDateTime;

}

4.3、DateTime获取

[SysEntryPointAttribute]

public utcDateTime getUtcDateTime2()

{

    ReinhardTest_Table table;

    select table order by table.UtcDateTime desc;

    return DateTimeUtil::applyTimeZoneOffset(table.UtcDateTime ,DateTimeUtil::getUserPreferredTimeZone());

}

[SysEntryPointAttribute]

public utcDateTime getUtcDateTime3()

{

    ReinhardTest_Table table;

    str strDT;

    select table order by table.UtcDateTime desc;

    return DateTimeUtil::applyTimeZoneOffset(table.UtcDateTime ,DateTimeUtil::getCompanyTimeZone());

}

    这次，Reinhard就分享到这里。如果同学们遇到什么问题，也欢迎和Reinhard沟通交流。