dotConnect for Salesforce Documentation
Devart.Data.Salesforce Namespace / SalesforceConnectionStringBuilder Class / UtcDates Property

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