DataSetDateTime Enum

Definition

Describes the serialization format for DateTime columns in a DataSet.

C#
public enum DataSetDateTime
Inheritance
DataSetDateTime

Fields

Name Value Description
Local 1

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 2

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 3

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 4

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.

Remarks

DataSetDateTime cannot be set on non-DateTime columns. Setting the DateTimeMode property with the default value UnspecifiedLocal 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 UnspecifiedLocal DateTimeMode.

Applies to

Product Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1