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