Class
FormatHelper

Provides utility methods for cell value formatting, date-time conversion, culture handling, and number format string parsing.

Definition

Namespace:Telerik.Windows.Documents.Spreadsheet.Formatting

Assembly:Telerik.Windows.Documents.Spreadsheet.dll

Syntax:

cs-api-definition
public static class FormatHelper

Inheritance: objectFormatHelper

Fields

StartDate

Defines the earliest date the RadSpreadsheet recognizes.

Declaration

cs-api-definition
public static readonly DateTime StartDate

Field Value

DateTime

Properties

CultureHelper

Gets or sets the culture helper used for resolving locale-specific formatting settings such as decimal separators, currency symbols, and list separators.

Declaration

cs-api-definition
public static SpreadsheetCultureHelper CultureHelper { get; set; }

Property Value

SpreadsheetCultureHelper

Methods

ConvertDateTimeToDouble(DateTime)

Converts a DateTime instance to a numeric value representing days since 1900-01-01, accounting for Excel's leap year bug.

Declaration

cs-api-definition
public static double ConvertDateTimeToDouble(DateTime dateTime)

Parameters

dateTime

DateTime

The DateTime instance.

Returns

double

The double number.

ConvertDoubleToDateTime(double)

Converts a numeric value representing days since 1900-01-01 to a DateTime instance, accounting for Excel's leap year bug, or returns null if the value is invalid.

Declaration

cs-api-definition
public static DateTime? ConvertDoubleToDateTime(double doubleValue)

Parameters

doubleValue

double

The double value.

Returns

DateTime?

The DateTime instance.

RoundMilliseconds(DateTime, int)

Rounds the milliseconds of a DateTime to the specified precision by truncating or rounding based on the digit count.

Declaration

cs-api-definition
public static DateTime RoundMilliseconds(this DateTime dateTimeValue, int precision)

Parameters

dateTimeValue

DateTime

The DateTime value.

precision

int

The precision.

Returns

DateTime

The DateTime instance with rounded milliseconds.

RoundMinutes(DateTime)

Rounds a DateTime to the nearest second by rounding up if milliseconds are 500 or greater.

Declaration

cs-api-definition
public static DateTime RoundMinutes(this DateTime dateTimeValue)

Parameters

dateTimeValue

DateTime

The DateTime value.

Returns

DateTime

The DateTime instance with rounded minutes.

ToDateTime(NumberCellValue)

Converts a NumberCellValue to a DateTime by interpreting the numeric value as days since 1900-01-01, or returns null if the value is invalid.

Declaration

cs-api-definition
public static DateTime? ToDateTime(this NumberCellValue numberCellValue)

Parameters

numberCellValue

NumberCellValue

The number cell value.

Returns

DateTime?

The DateTime instance.