在《谈谈你最熟悉的System.DateTime》一文中，我们从跨时区的角度剖析了我们熟悉的System.DateTime类型。如果你还是采用传统的ADO.NET编程方式，并使用DataSet作为数据实体，可能你会熟悉System.Data.DataSetDateTime这么一个类型。这个类型也是为实现跨时区场景下对时间处理而设计的，为了对前文的补充，这篇文章就来谈谈基于DataSet的时间处理问题。

一、你是否关注过DataColumn的DateTimeMode属性

在ADO.NET编程模型中，DataColumn代表DataTable的一个数据列，大家在熟悉不过了。不过，是否有人关注过一个名称为DateTimeMode属性，该属性在DataColumn中的定义如下：

 
public class DataColumn : MarshalByValueComponent 
{ 
    //Others... 
    public DataSetDateTime DateTimeMode { get; set; } 
} 
  

从上面的代码我们可以看出，DateTimeMode属性的类型为DataSetDateTime，这实际上是一个枚举类型。下面给出了DataSetDateTime的定义，该枚举一共包含4个枚举值：Local、Utc、Unspecified和UnspecifiedLocal。

 
public enum DataSetDateTime 
{ 
    Local = 1, 
    Unspecified = 2, 
    UnspecifiedLocal = 3, 
    Utc = 4 
} 
  

如果你读过前文，了解了DateTimeKind，技术你之前不曾关注过这个类型，也会猜出DataColumn用类型为DataSetDateTime的DateTimeMode属性指定时间的Kind。那么对于不同的DateTimeMode设置之间有何差异？为什么DataSetDateTime提供了另一个额外的成员UnspecifiedLocal呢？

二、不同的DateTimeMode设置对DateTimeKind的影响

这个问题很简单，对于数据类型为DateTime的DataColumn，如果你对DateTimeMode属性设置了不同的DataSetDateTime枚举值，当你对其赋值的时候，系统会自动将设置的时间转换成相应DateTimeKind的时间。下面的列表提供了基于不同DataSetDateTime枚举值采用的的转换规则：

DataSetDateTime.Local: 对于DateTimeKind.Local时间,不做任何转换；对于DateTimeKind.Utc时间，基于时区偏移量进行转换，并将Kind属性转换成DateTimeKind.Local；对于DateTimeKind.Unspecified，直接将Kind属性转换成DateTimeKind.Local，时间值（年、月、日、时、分、秒、毫秒等）保持不变；
DataSetDateTime.Utc: 对于DateTimeKind.Utc时间,不做任何转换；对于DateTimeKind.Local时间，基于时区偏移量进行转换，并将Kind属性转换成DateTimeKind.Utc；对于DateTimeKind.Unspecified，直接将Kind属性转换成DateTimeKind.Utc，时间值（年、月、日、时、分、秒、毫秒等）保持不变；
DataSetDateTime.Unspecified|UnspecifiedLocal:对于任何DateTimeKind类型的时间，直接将Kind属性转换成DateTimeKind.Unspecified，时间值（年、月、日、时、分、秒、毫秒等）保持不变。

在这里我需要强调一下，在前文中我们提到：不同是调用DateTime的ToLocalTime/ToUtcTime方法，还是调用TimeZoneInfo的ConvertToUtcTime/ConvertFromUtcTime，如果将DateTimeKind.Unspecified转换成DateTimeKind.Local时间，实际上是将其当成DateTimeKind.Utc时间；反之，如果转换成DateTimeKind.Utc时间，则当成是DateTimeKind.Local时间。但是，在这里DateTimeKind.Unspecified的时间值会保留，改变的仅仅是Kind属性。

三、一个简单的例子

为了加深对上述转换规则的理解，我写了一个简单的例子。首先我创建了一个ContractDataSet的强类型的DataSet，里面具有一个Contact数据表表示一个联系人。Contact数据的结构如右图所示：处理表示Id和名称的两个字段之外，我添加了四个DateTime类型的字段表示生日。它们分别是：LocalBirthday、UtcBirthday、UnspecifiedBirthday和UnspecifiedLocalBirthday，前缀表示该数据列采用的DateTimeMode。

然后，我写了下面三个辅助的方法：CreateContact通过传入的表示生日的DateTime创建一个ContractDataSet，DisplayBirthday分别将上诉四个字段的时间和Kind打印出来。

   1: static ContactDataSet CreateContact(DateTime birthday)

   2: {

   3:     var ds = new ContactDataSet();

   4:     var row = ds.Contact.NewContactRow();

   5:     row.Id = Guid.NewGuid().ToString();

   6:     row.Name = "Foo";

   7:     SetBirthDay(row,birthday);

   8:     ds.Contact.AddContactRow(row);

   9:     return ds;

  10: }

  11: static void SetBirthDay(ContactDataSet.ContactRow row,DateTime birthDay)

  12: {

  13:     row.LocalBirthDay               = birthDay;

  14:     row.UtcBirthDay                 = birthDay;

  15:     row.UnspecifiedBirthDay         = birthDay;

  16:     row.UnspecifiedLocalBirthDay    = birthDay;

  17: }

  18: static void DispalyBirthday(ContactDataSet ds)

  19: {

  20:     var row = ds.Contact[0];

  21:     Console.WriteLine("\tLocal: \t\t\t{0}",             row.LocalBirthDay);

  22:     Console.WriteLine("\tUtc: \t\t\t{0}",               row.UtcBirthDay);

  23:     Console.WriteLine("\tUnspecified: \t\t{0}",         row.UnspecifiedBirthDay);

  24:     Console.WriteLine("\tUnspecifiedLocal: \t{0}\n",    row.UnspecifiedLocalBirthDay);

25:

  26:     Console.WriteLine("\tLocal: \t\t\t{0}",             row.LocalBirthDay.Kind);

  27:     Console.WriteLine("\tUtc: \t\t\t{0}",               row.UtcBirthDay.Kind);

  28:     Console.WriteLine("\tUnspecified: \t\t{0}",         row.UnspecifiedBirthDay.Kind);

  29:     Console.WriteLine("\tUnspecifiedLocal: \t{0}\n",    row.UnspecifiedLocalBirthDay.Kind);

  30: }

我们的实例程序是这样的：分别创建基于三种不同的DateTimeKind的DateTime对象，并据此创建三个ContractDataSet对象。最后调用DisplayBirthday方法将4个基于不同DateTimeMode的字段的时间和DateTimeKind打印出来。

 
var ds1 = CreateContact(new DateTime(1981, 8, 24, 0, 0, 0, DateTimeKind.Local)); 
var ds2 = CreateContact(new DateTime(1981, 8, 24, 0, 0, 0, DateTimeKind.Unspecified)); 
var ds3 = CreateContact(new DateTime(1981, 8, 24, 0, 0, 0, DateTimeKind.Utc)); 
   
Console.WriteLine("DateTimeKind.Local"); 
DispalyBirthday(ds1); 
Console.WriteLine("DateTimeKind.Unspecified"); 
DispalyBirthday(ds2); 
Console.WriteLine("DateTimeKind.Utc"); 
DispalyBirthday(ds3); 
  

最终的输出结果证实了我们上述的关于时间转换规则的结论：

   1: DateTimeKind.Local

   2:         Local:                  8/24/1981 12:00:00 AM

   3:         Utc:                    8/23/1981 4:00:00 PM

   4:         Unspecified:            8/24/1981 12:00:00 AM

   5:         UnspecifiedLocal:       8/24/1981 12:00:00 AM

6:

   7:         Local:                  Local

   8:         Utc:                    Utc

   9:         Unspecified:            Unspecified

  10:         UnspecifiedLocal:       Unspecified

11:

  12: DateTimeKind.Unspecified

  13:         Local:                  8/24/1981 12:00:00 AM

  14:         Utc:                    8/24/1981 12:00:00 AM

  15:         Unspecified:            8/24/1981 12:00:00 AM

  16:         UnspecifiedLocal:       8/24/1981 12:00:00 AM

17:

  18:         Local:                  Local

  19:         Utc:                    Utc

  20:         Unspecified:            Unspecified

  21:         UnspecifiedLocal:       Unspecified

22:

  23: DateTimeKind.Utc

  24:         Local:                  8/24/1981 8:00:00 AM

  25:         Utc:                    8/24/1981 12:00:00 AM

  26:         Unspecified:            8/24/1981 12:00:00 AM

  27:         UnspecifiedLocal:       8/24/1981 12:00:00 AM

28:

  29:         Local:                  Local

  30:         Utc:                    Utc

  31:         Unspecified:            Unspecified

  32:         UnspecifiedLocal:       Unspecified

四、DataSetDateTime.Unspecified V.S. DataSetDateTime.UnspecifiedLocal

到不前为止，我们貌似还看不到DataSetDateTime.Unspecified和DataSetDateTime.UnspecifiedLoca的差别。实际上，它们的差别体现在序列化上面：DataSetDateTime.UnspecifiedLoca在序列化的时候会保留基于当前时区的偏移量，而DataSetDateTime.Unspecified则不会。这个结论我也可以实例来证实，为此我写了如下一段代码对ContactDataSet进行序列化，并将序列化后的XML打印出来。

 
var ds = CreateContact(new DateTime(1981, 8, 24, 0, 0, 0)); 
using (MemoryStream stream = new MemoryStream(1000)) 
{ 
    ds.WriteXml(stream); 
    Console.WriteLine(ASCIIEncoding.ASCII.GetString(stream.GetBuffer()).Trim()); 
}    
  

从输出的结果我们可以看出UnspecifiedBirthday和UnspecifiedLocalBirday之间的差别，后者有+8的偏移量，前者没有。

 
<ContactDataSet xmlns="http://tempuri.org/ContactDataSet.xsd"> 
  <Contact> 
    <Id>a1548a6b-9b8b-4799-bc10-31337e70c831</Id> 
    <Name>Foo</Name> 
    <UnspecifiedLocalBirthDay>1981-08-24T00:00:00+08:00</UnspecifiedLocalBirthDay> 
    <UnspecifiedBirthDay>1981-08-24T00:00:00</UnspecifiedBirthDay> 
    <UtcBirthDay>1981-08-24T00:00:00Z</UtcBirthDay> 
    <LocalBirthDay>1981-08-24T00:00:00+08:00</LocalBirthDay> 
  </Contact> 
</ContactDataSet> 
  

[相关阅读]

[1] 谈谈你最熟悉的System.DateTime[上篇]

[2] 谈谈你最熟悉的System.DateTime[下篇]

[3] 如何解决分布式系统中的跨时区问题[原理篇]

[4] 如何解决分布式系统中的跨时区问题[实例篇]

作者：蒋金楠
微信公众账号：大内老A
微博： www.weibo.com/artech
如果你想及时得到个人撰写文章以及著作的消息推送，或者想看看个人推荐的技术资料，可以扫描左边二维码（或者长按识别二维码）关注个人公众号（原来公众帐号蒋金楠的自媒体将会停用）。
本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。

原文链接

谈谈你最熟悉的System.DateTime[下篇]

一、你是否关注过DataColumn的DateTimeMode属性

二、不同的DateTimeMode设置对DateTimeKind的影响

三、一个简单的例子

四、DataSetDateTime.Unspecified V.S. DataSetDateTime.UnspecifiedLocal

热门文章

最新文章

相关课程

相关电子书

热门

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

阿里云MVP

话题

直播

下载

镜像站

技术资料

插件

谈谈你最熟悉的System.DateTime[下篇]

一、你是否关注过DataColumn的DateTimeMode属性

二、不同的DateTimeMode设置对DateTimeKind的影响

三、一个简单的例子

四、DataSetDateTime.Unspecified V.S. DataSetDateTime.UnspecifiedLocal

热门文章

最新文章

相关课程

相关电子书