dotConnect for BigCommerce Documentation
Devart.Data Namespace / SqlShimConnectionStringBuilder Class / UtcDates Property

In This Topic
    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
    '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 BigCommerce. In many cases BigCommerce may display different values than set or returned via dotConnect for BigCommerce because of different time zone settings in your SqlShimConnection and in BigCommerce. For example, if you set UtcDates to true, and BigCommerce 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 BigCommerce as a UTC value. When displaying this value in the BigCommerce interface, BigCommerce 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 BigCommerce is configured to display datetime values in your local time, the date values returned via dotConnect for BigCommerce may differ from the values, displayed by BigCommerce. This happens because in this example BigCommerce convertsthe values to your local time when displaying them, and dotConnect for BigCommerce 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

    See Also