Skip to main content

Cell Data Types

  • 4 minutes to read

Each cell in a worksheet has a value that is specified by the CellValue object. To access this object, use the CellRange.Value property. A cell value is determined by the data contained within the cell:

A cell value can be of one of the following types: empty, numeric, text, Boolean or error. Cell values may have various display formats. For example, a numeric value can be displayed as a decimal number, a percentage or currency value, a date or time value, etc.

Use the properties of the CellValue object returned by the CellRange.Value property to retrieve information about the cell value type, and get the cell value itself as an object of the corresponding type. To get the string specifying the formatted value as it is displayed in a cell, use the Cell.DisplayText property.

The table below lists the available cell value types and provides examples on how a value of each type can be input, formatted, displayed and obtained.

Cell Value Type

Cell Content

Sample Input

Sample Display Format

Displayed String

(Cell.DisplayText)

Identify the Type

Obtain the Cell Value Object

Empty

The default cell value type.

If a cell contains any data, you can assign an empty value to it by setting the CellRange.Value property to null or CellValue.Empty.

For details, refer to the How to: Clear Cells of Content, Formatting, Hyperlinks and Comments document.

cell.Value = null

- or -

cell.Value = CellValue.Empty

Spreadsheet_EmptyValue

CellValue.IsEmpty = true

CellValue.Type = CellValueType.None

CellValue.Empty

Numeric

The cell’s CellRange.Value property is assigned to a value of any numeric type (e.g., Int32, Double, etc.).

- or -

The cell’s CellRange.Formula property is assigned to an expression that returns a number.

cell.Value = 12345678

- or -

cell.Formula = “= SUM(12000000,345678)”

cell.NumberFormat = “#,#”

More examples:

How to: Specify Number or Date Format for Cell Content

Spreadsheet_NumericValue

CellValue.IsNumeric = true

CellValue.Type = CellValueType.Numeric

CellValue.NumericValue

Numeric

(Date and Time)

The cell’s CellRange.Value property is assigned to the DateTime object, an object returned by the CellValue.FromDateTime method, or a numeric value representing a serial number of a date or time.

- or -

The cell’s CellRange.Formula property is assigned to an expression that returns the serial number of a date or time.

For details, refer to the Dates and Times in Cells document.

cell.Value = new DateTime(2012, 12, 10);

- or -

workbook.DocumentSettings.Calculation.Use1904DateSystem = true;

cell.Value = CellValue.FromDateTime(new DateTime(2012, 12, 10), true);

- or -

cell.Value = 41253;

- or -

cell.Formula = “=DATE(2012,12,10)”;

cell.NumberFormat = “m/d/yy”

More examples:

How to: Specify Number or Date Format for Cell Content

Spreadsheet_NumericValue_DateTime

CellValue.IsNumeric = true

CellValue.Type = CellValueType.DateTime

CellValue.IsDateTime = true

CellValue.DateTimeValue

CellValue.NumericValue

Text

The cell’s CellRange.Value property is assigned to the String object.

- or -

The cell’s CellRange.Formula property is assigned to an expression that returns text.

cell.Value = “Sample Text”

- or -

cell.Formula = “= PROPER(“sample text”)”

Spreadsheet_TextValue

CellValue.IsText = true

CellValue.Type = CellValueType.Text

CellValue.TextValue

Boolean

The cell’s CellRange.Value property is assigned to the Boolean object.

- or -

The cell’s CellRange.Formula property is assigned to an expression that returns TRUE or FALSE.

cell.Value = true

- or -

cell.Formula = “= TRUE()”

Spreadsheet_BooleanValue

CellValue.IsBoolean = true

CellValue.Type = CellValueType.Boolean

CellValue.BooleanValue

Error

The cell’s CellRange.Value property is assigned to the CellValue object returned by the CellValue.Error* field (for example, CellValue.ErrorDivisionByZero, CellValue.ErrorInvalidValueInFunction, CellValue.ErrorName, etc.).

- or -

The cell’s CellRange.Formula property is assigned to an error code (e.g., “=#DIV/0!”, “=#N/A”, etc.) or an expression that cannot be calculated correctly (for example, an expression containing an invalid function name, value, division by zero, etc.)

For details, refer to the Error Types document.

cell.Value = CellValue.ErrorDivisionByZero

- or -

cell.Formula = “= #DIV/0!”

- or -

cell.Formula = “=5/0”

Spreadsheet_ErrorValue

CellValue.IsError = true

CellValue.Type = CellValueType.Error

CellValue.ErrorValue

See Also