--- title: DateInputProps description: "Learn how to build custom functionality when working with the React Date Inputs by Kendo UI with the help of the DateInputProps." api_reference: true type: inner_api slug: api_dateinputs_dateinputprops --- # DateInputProps Represents the props of the [KendoReact DateInput component](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput). The generic argument is passed to the `onChange` property and is used as a target in the [`DateInputChangeEvent`](https://www.telerik.com/kendo-react-ui/components/dateinputs/api/dateinputchangeevent) interface.
| Name | Type | Default | Description |
|---|---|---|---|
| #### allowCaretMode? |
boolean
|
`false`
|
Determines if the users should see a blinking caret inside the Date Input when possible. |
| #### ariaControls? |
string
|
Reference the id of the element that the DateInput controls via ARIA. | |
| #### ariaDescribedBy? |
string
|
Identifies the element(s) which will describe the component, similar to [HTML aria-describedby attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute). For example these elements could contain error or hint message. | |
| #### ariaExpanded? |
boolean
|
Indicate whether the popup content is expanded. | |
| #### ariaHasPopup? |
boolean | "dialog" | "grid"
|
`grid`
|
Define the interactive popup type for assistive tech. Use `grid` (default) or `dialog` based on context. |
| #### ariaLabel? |
string
|
The accessible label of the component. | |
| #### ariaLabelledBy? |
string
|
Identifies the element(s) which will label the component. | |
| #### ariaRole? |
string
|
Set the ARIA role of the DateInput root element. | |
| #### autoCorrectParts? |
boolean
|
`true`
|
Determines whether to autocorrect invalid segments automatically. |
| #### autoFill? |
boolean
|
`false`
|
Autofill missing parts with the current date on blur. |
| #### autoFocus? |
boolean
|
`false`
|
Apply the `autoFocus` attribute to the internal input. |
| #### autoSwitchKeys? |
string[]
|
`[]`
|
A string array representing custom keys, which will move the focus to the next date format segment. |
| #### autoSwitchParts? |
boolean
|
`true`
|
Determines whether to automatically move to the next segment after the user completes the current one. |
| #### className? |
string
|
Set a custom CSS class on the DateInput DOM element. | |
| #### clearButton? |
boolean
|
Show a clear button that sets `value` to `null` and fires `onChange`. | |
| #### defaultValue? |
"null" | Date
|
Set the initial `value` when the component is uncontrolled. If `value` is not set, the component uses this as its starting value. | |
| #### dir? |
string
|
Represents the `dir` HTML attribute. | |
| #### disabled? |
boolean
|
Determines whether the DateInput is disabled ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/disabled-state)). | |
| #### enableMouseWheel? |
boolean
|
`true`
|
Indicates whether the mouse scroll can be used to increase/decrease the date segments values. |
| #### fillMode? |
"flat" | "solid" | "outline"
|
undefined (theme-controlled)
|
Control the `fillMode` (background) of the DateInput.
The available options are:
- solid
- outline
- flat
```tsx
|
| #### format? |
string | DateFormatOptions
|
Specifies the `date` format which is used for formatting the value ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/formats)). If not set, the default format will be used. | |
| #### formatPlaceholder? |
[DateInputFormatPlaceholder]({% slug api_dateinputs_dateinputformatplaceholder %})
|
Specifies the descriptions of the format sections in the input field ([more information and example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/placeholders)). | |
| #### id? |
string
|
Sets the `id` of the `input` DOM element. | |
| #### inputAttributes? |
React.InputHTMLAttributes<HTMLInputElement>
|
Pass HTML attributes to the internal focusable input. Attributes required for core logic are ignored. | |
| #### label? |
React.ReactNode
|
Renders a floating label for the DateInput. | |
| #### max? |
Date
|
Specifies the greatest date that is valid ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/date-ranges)). | |
| #### maxTime? |
Date
|
Specifies the greatest time that is valid ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/date-ranges#toc-limiting-the-time-range)). | |
| #### min? |
Date
|
Specifies the smallest date that is valid ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/date-ranges)). | |
| #### minTime? |
Date
|
Specifies the smallest time that is valid ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/date-ranges#toc-limiting-the-time-range)). | |
| #### name? |
string
|
Specifies the `name` property of the `input` DOM element. This property is part of the [FormComponentProps](https://www.telerik.com/kendo-react-ui/components/common/api/formcomponentprops) interface. | |
| #### onChange? |
(event: [DateInputChangeEvent]({% slug api_dateinputs_dateinputchangeevent %})<T>) => void
|
Fires when the user edits the `value` ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/date-ranges)). | |
| #### placeholder? |
"null" | string
|
Specifies the hint the DateInput displays when its value is `null` or there is no partial selection. For more information, refer to the article on [placeholders](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/placeholders). | |
| #### readonly? |
boolean
|
Put the component in read-only mode. | |
| #### required? |
boolean
|
Specifies if `null` is a valid value for the component. This property is part of the [FormComponentProps](https://www.telerik.com/kendo-react-ui/components/common/api/formcomponentprops) interface. | |
| #### rounded? |
"small" | "none" | "medium" | "large" | "full"
|
undefined (theme-controlled)
|
Control the corner `rounded` style of the DateInput.
The available options are:
- small
- medium
- large
- full
- none
```tsx
|
| #### size? |
"small" | "medium" | "large"
|
undefined (theme-controlled)
|
Control the `size` of the DateInput.
The available options are:
- small
- medium
- large
```tsx
|
| #### spinners? |
boolean
|
Specifies whether the **Up** and **Down** spin buttons will be rendered ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/spin-buttons)). | |
| #### steps? |
[DateInputIncrementalSteps]({% slug api_dateinputs_dateinputincrementalsteps %})
|
Specifies the incremental steps of the DateInput ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/incremental-steps)). The available options are: - `year: Number`—Controls the incremental step of the year value. - `month: Number`—Controls the incremental step of the month value. - `day: Number`—Controls the incremental step of the day value. - `hour: Number`—Controls the incremental step of the hour value. - `minute: Number`—Controls the incremental step of the minute value. - `second: Number`—Controls the incremental step of the second value. | |
| #### tabIndex? |
number
|
Sets the `tabIndex` property of the DateInput. | |
| #### title? |
string
|
Sets the title of the `input` element of the DateInput. | |
| #### twoDigitYearMax? |
number
|
`68`
|
The maximum year to assume to be from the current century when typing two-digit year value ([see example](https://www.telerik.com/kendo-react-ui/components/dateinputs/dateinput/formats#toc-two---digit-year-max)). The default value of 68, indicating that typing any value less than 69 will be assumed to be 20xx, while 69 and larger will be assumed to be 19xx. |
| #### valid? |
boolean
|
Overrides the validity state of the component. If `valid` is set, the `required` property will be ignored. This property is part of the [FormComponentProps](https://www.telerik.com/kendo-react-ui/components/common/api/formcomponentprops) interface. | |
| #### validationMessage? |
string
|
Controls the form error message of the component. If set to an empty string, no error will be thrown. This property is part of the [FormComponentProps](https://www.telerik.com/kendo-react-ui/components/common/api/formcomponentprops) interface. | |
| #### validityStyles? |
boolean
|
If set to `false`, no visual representation of the invalid state of the component will be applied. This property is part of the [FormComponentProps](https://www.telerik.com/kendo-react-ui/components/common/api/formcomponentprops) interface. | |
| #### value? |
"null" | Date
|
Set the `value` of the DateInput. | |
| #### width? |
string | number
|
Specifies the width of the DateInput. |