New to Telerik UI for WinForms? Start a free 30-day trial

DateInput

Class

Parses free-form date and time text using a configured culture and date format.

Constructors

DateInput()

Creates a parser using the current thread's culture and the default MinDate and MaxDate values.

public DateInput()

DateInput(CultureInfo)

Creates a parser for the specified culture and initializes MinDate and MaxDate to January 1, 1980 and December 31, 2099.

public DateInput(CultureInfo cultureInfo)

Parameters:cultureInfoCultureInfo

The culture used to interpret date and time formats and names.

Properties

CultureInfo

Gets or sets the culture that determines the value of the localizable separators and placeholders in the input mask.

public CultureInfo CultureInfo { get; set; }

Property Value:

A System.Globalization.CultureInfo containing the culture information associated with the input mask.

DateFormat

string

Gets or sets the date and time format used by RadDateInput.

public virtual string DateFormat { get; set; }

Property Value:

A string specifying the date format used by RadDateInput. The default value is "d" (short date format).

Example:

cs-api-definition
private void Page_Load(object sender, System.EventArgs e)
{
RadDateInput1.DateFormat = "M/d/yyyy"; //Short date pattern. The same as "d".
}
cs-api-definition.skip-repl
Private Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.Load
RadDateInput1.DateFormat = "M/d/yyyy" 'Short date pattern. The same as "d".
End Sub

MaxDate

DateTime

Gets or sets the maximum date.

public DateTime MaxDate { get; set; }

MinDate

DateTime

Gets or sets the minimum date.

public DateTime MinDate { get; set; }

ShortYearCenturyEnd

int

Gets or sets a value that indicates the end of the century that is used to interpret the year value when a short year (single-digit or two-digit year) is entered in the input.

public int ShortYearCenturyEnd { get; set; }

Property Value:

The year when the century ends. Default is 2029.

Having a value of 2029 indicates that a short year will be interpreted as a year between 1930 and 2029. For example 55 will be interpreted as 1955 but 12 -- as 2012

ShortYearCenturyStart

int

Gets a value that indicates the start of the century that is used to interpret the year value when a short year (single-digit or two-digit year) is entered in the input.

public int ShortYearCenturyStart { get; }

Property Value:

The year when the century starts. Default is 1930.

Having a value of 1930 indicates that a short year will be interpreted as a year between 1930 and 2029. For example 55 will be interpreted as 1955 but 12 -- as 2012

Methods

ParseDate(string, DateTime?)

Parses the input as a culture-aware date, time, or combined date-time value.

public DateTime? ParseDate(string value, DateTime? baseDate)

Parameters:valuestring

The free-form text to parse.

baseDateDateTime?

The starting date for resolving omitted date components in date-only input. When null, today's date is used; that seed is clamped to MinDate and MaxDate. Inputs containing a time component use the combined-entry evaluator's current-time seed instead, so this argument does not affect them.

Returns:

DateTime?

The parsed value, or null when the input is empty or parsing fails.