Property EnableTimestampOffsetSupport

EnableTimestampOffsetSupport

Gets or sets a value indicating whether TimestampOffset fields are supported, which necessarily changes the behavior of Date fields.

Declaration

public static bool EnableTimestampOffsetSupport { get; set; }

Property Value

Type	Description
System.Boolean	A value indicating whether TimestampOffset fields are supported, which necessarily changes the behavior of Date fields.

Remarks

ArcGIS Maps SDK historically allowed using either DateTime or DateTimeOffset values for fields of type "Date". To support TimestampOffset fields and avoid ambiguity, the behavior of Date fields has to change to only use DateTime values. This new behavior is currently opt-in, so TimestampOffset fields are not supported by default. For more information, see https://links.esri.com/DotNetDateTime.

To enable support for TimestampOffset fields, set this property to true when initializing the app. The default value will change to true in a future release.

When EnableTimestampOffsetSupport is false (default):

• Values of Date attributes are returned as DateTimeOffset (UTC).
• Values of TimestampOffset attributes are also returned as DateTimeOffset.
• Either DateTime or DateTimeOffset values can be used when editing Date fields.
• Editing data with TimestampOffset fields is not supported. A System.NotSupportedException will be thrown.
• Creating TimestampOffset fields, domains, renderers, or Arcade expressions is not supported.

When EnableTimestampOffsetSupport is true:

• Values of Date attributes are returned as DateTime (UTC). Using a DateTimeOffset for a Date field would cause a "Geodatabase data type mismatch" exception.
• Values of TimestampOffset attributes are also returned as DateTimeOffset.
• Only DateTime values can be used to edit Date attributes. They are converted to UTC.
• DateTimeOffset values can be used to edit TimestampOffset fields.
• Creating TimestampOffset fields, domains, renderers, and Arcade expressions is supported.

Applies to

Platforms and versions

Target	Versions
.NET Standard 2.0	200.4 - 200.5
.NET	200.4 - 200.5
.NET Windows	200.4 - 200.5
.NET Android	200.4 - 200.5
.NET iOS	200.4 - 200.5
.NET Framework	200.4 - 200.5
UWP	200.4 - 200.5