UtcDates Property

In This Topic

Indicates whether all the datetime values retrieved from the data source are returned as UTC values or converted to local time, and whether date values, specified on the application side (for example, in SQL statements) are considered UTC or local.

Syntax

Visual Basic
C#

'Declaration
 
Public Property UtcDates As Boolean

public bool UtcDates {get; set;}

Property Value

true, if the datetime values retrieved from the data source are returned as UTC values, and the date values specified on the application side should be considered UTC when sending them to the data source; otherwise, false. Default value is false.

Remarks

Please note that it is important to consider the value of this parameter in your connections and the corresponding settings of the Magento. In many cases Magento may display different values than set or returned via dotConnect for Magento because of different time zone settings in your SqlShimConnection and in Magento. For example, if you set UtcDates to true, and Magento is configured to display datetime values in your local time, when you specify a datetime value in an INSERT or UPDATE statement, it is treated and sent to Magento as a UTC value. When displaying this value in the Magento interface, Magento converts it to your local time, and thus displays a different value than the one that was specified in the INSERT or UPDATE statement.

The same is correct when selecting data. If UtcDates is set to true, and Magento is configured to display datetime values in your local time, the date values returned via dotConnect for Magento may differ from the values, displayed by Magento. This happens because in this example Magento convertsthe values to your local time when displaying them, and dotConnect for Magento doesn't.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

SqlShimConnectionStringBuilder Class
SqlShimConnectionStringBuilder Members

Send Feedback