DataSetDateTime Enumeration
TOC
Collapse the table of content
Expand the table of content

DataSetDateTime Enumeration

 

Describes the serialization format for DateTime columns in a DataSet.

Namespace:   System.Data
Assembly:  System.Data (in System.Data.dll)

type DataSetDateTime

Member nameDescription
Local

DateTime is always stored in Local. If Utc or Unspecified is assigned to a column in this mode, it is first converted into Local. Serialization in this mode is always performed in Local. There is an offset during serialization.

Unspecified

DateTime is always stored in Unspecified. If Local or Utc is assigned to a column in this mode, it is first converted into Unspecified. Serialization in this mode does not cause an offset.

UnspecifiedLocal

DateTime is stored in Unspecified. If Local or Utc is assigned to a column in this mode, it is first converted into Unspecified. Serialization in this mode causes offset. This is the default behavior and is backward compatible. This option should be thought of as being Unspecified in storage but applying an offset that is similar to Local during serialization.

Utc

DateTime is stored in Universal Coordinated Time (UTC). If Local or Unspecified is assigned to a column in this mode, it is first converted into Utc format. Serialization in this mode is always performed in Utc. There is no offset during serialization.

DataSetDateTime cannot be set on non-DateTime columns. Setting the DateTimeMode property with the default value UnspecifiedLocall on non-DateTime columns is permitted. Modifying the column data type from DateTime to any other type resets the DateTimeMode to the default value UnspecifiedLocal.

Checking schema for merging, Relations, and ForeignKeyConstraints can be performed between DateTime columns with matching DateTimeMode properties. Otherwise the columns should be considered as non-matching on schema. The only exception is between Unspecified and UnspecifiedLocal. It is permitted to have a relation or a ForeignKeyConstraint between two DateTime columns with one in Unspecified and other in UnspecifiedLocalDateTimeMode.

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft