CellValue.DateTimeValue Property

Returns the date and time value that corresponds to the number contained in a cell.

Namespace: DevExpress.Spreadsheet

Assembly: DevExpress.Spreadsheet.v19.1.Core.dll

Declaration

C#

public DateTime DateTimeValue { get; }

VB.NET

Public ReadOnly Property DateTimeValue As Date

Property Value

Type	Description
DateTime	A DateTime object.

Remarks

Dates and times are stored in cells as numbers that are displayed according to the applied date and time formats. So, if a cell contains a number, the DateTimeValue property returns the DateTime object which specifies a date and time value represented by that number. The number itself is accessed via the CellValue.NumericValue property. To check whether a cell displays its numeric value as date and time, use the CellValue.IsDateTime or CellValue.Type property. To get a string that specifies a cell value as it is displayed, use the Cell.DisplayText property.

For more information on cell values, refer to the Cell Data Types and Dates and Times in Cells documents.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DateTimeValue property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-display-custom-controls-instead-of-the-standard-cell-editor-t259398/CS/SpreadsheetCustomization/Form1.cs#L241

void ShowDateEdit(CellValue value, Rectangle bounds) {
    dateEdit.EditValue = value.DateTimeValue;

how-to-export-cell-range-to-a-datatable-e4997/CS/ExportToDataTableExample/Form1.cs#L170

}
result =  String.Format("{0:MMMM-yyyy}",cellValue.DateTimeValue);
return converted;

spreadsheet-document-api-export-worksheet-range-to-datatable/CS/ExportToDataTableWorkbookExample/MyConverter.cs#L24

}
result = String.Format("{0:MMMM-yyyy}", cellValue.DateTimeValue);
return converted;

wpf-spreadsheet-how-to-bind-a-worksheet-to-a-generic-list-or-a-bindinglist-data-source-t484261/CS/DataBindingToListExample/MyConverter.cs#L11

if (requiredType == typeof(DateTime))
    return value.DateTimeValue;
if (requiredType == typeof(Weather)) {

how-to-bind-a-worksheet-to-a-generic-list-or-a-bindinglist-data-source-t480285/CS/DataBindingToListExample/MyConverter.cs#L11

if (requiredType == typeof(DateTime))
    return value.DateTimeValue;
if (requiredType == typeof(Weather)) {

VB.NET

how-to-display-custom-controls-instead-of-the-standard-cell-editor-t259398/VB/SpreadsheetCustomization/Form1.vb#L242

Private Sub ShowDateEdit(ByVal value As CellValue, ByVal bounds As Rectangle)
    dateEdit.EditValue = value.DateTimeValue

how-to-export-cell-range-to-a-datatable-e4997/VB/ExportToDataTableExample/Form1.vb#L163

End If
result = String.Format("{0:MMMM-yyyy}", cellValue.DateTimeValue)
Return converted

spreadsheet-document-api-export-worksheet-range-to-datatable/VB/ExportToDataTableWorkbookExample/MyConverter.vb#L26

End If
result = String.Format("{0:MMMM-yyyy}", cellValue.DateTimeValue)
Return converted

wpf-spreadsheet-how-to-bind-a-worksheet-to-a-generic-list-or-a-bindinglist-data-source-t484261/VB/DataBindingToListExample/MyConverter.vb#L13

If requiredType Is GetType(Date) Then
    Return value.DateTimeValue
End If

how-to-bind-a-worksheet-to-a-generic-list-or-a-bindinglist-data-source-t480285/VB/DataBindingToListExample/MyConverter.vb#L13

If requiredType Is GetType(Date) Then
    Return value.DateTimeValue
End If