If you have technical questions, please create a support ticket in the DevExpress Support Center.
import React from 'react';
import DateBox from 'devextreme-react/date-box';
const date = new Date(2018, 9, 16, 15, 8, 12);
const dataTimeLabel = { 'aria-label': 'Date Time' };
const dateLabel = { 'aria-label': 'Date' };
function App() {
return (
<div>
<div className="dx-fieldset">
<div className="dx-field">
<div className="dx-field-label">Locale-dependent format</div>
<div className="dx-field-value">
<DateBox
type="datetime"
placeholder="12/31/2018, 2:52 PM"
showClearButton={true}
inputAttr={dataTimeLabel}
useMaskBehavior={true}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Built-in predefined format</div>
<div className="dx-field-value">
<DateBox
defaultValue={date}
placeholder="10/16/2018"
showClearButton={true}
inputAttr={dateLabel}
useMaskBehavior={true}
type="date"
displayFormat="shortdate"
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Locale Data Markup Language (LDML) pattern</div>
<div className="dx-field-value">
<DateBox
defaultValue={date}
placeholder="Tuesday, 16 of Oct, 2018 14:52"
showClearButton={true}
inputAttr={dateLabel}
useMaskBehavior={true}
type="datetime"
displayFormat="EEEE, d of MMM, yyyy HH:mm"
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Format with literal characters</div>
<div className="dx-field-value">
<DateBox
defaultValue={date}
placeholder="Year: 2018"
showClearButton={true}
useMaskBehavior={true}
inputAttr={dateLabel}
type="date"
displayFormat={"'Year': yyyy"}
/>
</div>
</div>
</div>
</div>
);
}
export default App;
xxxxxxxxxx
import React from 'react';
import DateBox from 'devextreme-react/date-box';
const date = new Date(2018, 9, 16, 15, 8, 12);
const dataTimeLabel = { 'aria-label': 'Date Time' };
const dateLabel = { 'aria-label': 'Date' };
function App() {
return (
<div>
<div className="dx-fieldset">
<div className="dx-field">
<div className="dx-field-label">Locale-dependent format</div>
<div className="dx-field-value">
<DateBox
type="datetime"
placeholder="12/31/2018, 2:52 PM"
showClearButton={true}
inputAttr={dataTimeLabel}
useMaskBehavior={true}
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Built-in predefined format</div>
<div className="dx-field-value">
<DateBox
defaultValue={date}
placeholder="10/16/2018"
showClearButton={true}
inputAttr={dateLabel}
useMaskBehavior={true}
type="date"
displayFormat="shortdate"
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Locale Data Markup Language (LDML) pattern</div>
<div className="dx-field-value">
<DateBox
defaultValue={date}
placeholder="Tuesday, 16 of Oct, 2018 14:52"
showClearButton={true}
inputAttr={dateLabel}
useMaskBehavior={true}
type="datetime"
displayFormat="EEEE, d of MMM, yyyy HH:mm"
/>
</div>
</div>
<div className="dx-field">
<div className="dx-field-label">Format with literal characters</div>
<div className="dx-field-value">
<DateBox
defaultValue={date}
placeholder="Year: 2018"
showClearButton={true}
useMaskBehavior={true}
inputAttr={dateLabel}
type="date"
displayFormat={"'Year': yyyy"}
/>
</div>
</div>
</div>
</div>
);
}
export default App;
xxxxxxxxxx
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.tsx';
ReactDOM.render(<App />, document.getElementById('app'));
xxxxxxxxxx
window.exports = window.exports || {};
window.config = {
transpiler: 'ts',
typescriptOptions: {
module: 'system',
emitDecoratorMetadata: true,
experimentalDecorators: true,
jsx: 'react',
},
meta: {
'react': {
'esModule': true,
},
'typescript': {
'exports': 'ts',
},
'devextreme/time_zone_utils.js': {
'esModule': true,
},
'devextreme/localization.js': {
'esModule': true,
},
'devextreme/viz/palette.js': {
'esModule': true,
},
'openai': {
'esModule': true,
},
},
paths: {
'npm:': 'https://unpkg.com/',
'bundles:': 'bundles/',
'externals:': 'bundles/externals/',
},
defaultExtension: 'js',
map: {
'ts': 'npm:plugin-typescript@8.0.0/lib/plugin.js',
'typescript': 'npm:typescript@4.2.4/lib/typescript.js',
'jszip': 'npm:jszip@3.10.1/dist/jszip.min.js',
'react': 'npm:react@17.0.2/umd/react.development.js',
'react-dom': 'npm:react-dom@17.0.2/umd/react-dom.development.js',
'prop-types': 'npm:prop-types/prop-types.js',
'rrule': 'npm:rrule@2.6.4/dist/es5/rrule.js',
'luxon': 'npm:luxon@3.4.4/build/global/luxon.min.js',
'es6-object-assign': 'npm:es6-object-assign',
'devextreme': 'npm:devextreme@link:../../packages/devextreme/artifacts/npm/devextreme/cjs',
'devextreme-react': 'npm:devextreme-react@link:../../packages/devextreme-react/npm/cjs',
'devextreme-quill': 'npm:devextreme-quill@1.7.1/dist/dx-quill.min.js',
'devexpress-diagram': 'npm:devexpress-diagram@2.2.5/dist/dx-diagram.js',
'devexpress-gantt': 'npm:devexpress-gantt@4.1.54/dist/dx-gantt.js',
'@devextreme/runtime': 'npm:@devextreme/runtime@3.0.12',
'inferno': 'npm:inferno@7.4.11/dist/inferno.min.js',
'inferno-compat': 'npm:inferno-compat/dist/inferno-compat.min.js',
'inferno-create-element': 'npm:inferno-create-element@7.4.11/dist/inferno-create-element.min.js',
'inferno-dom': 'npm:inferno-dom/dist/inferno-dom.min.js',
'inferno-hydrate': 'npm:inferno-hydrate/dist/inferno-hydrate.min.js',
'inferno-clone-vnode': 'npm:inferno-clone-vnode/dist/inferno-clone-vnode.min.js',
'inferno-create-class': 'npm:inferno-create-class/dist/inferno-create-class.min.js',
'inferno-extras': 'npm:inferno-extras/dist/inferno-extras.min.js',
'devextreme-cldr-data': 'npm:devextreme-cldr-data@1.0.3',
// SystemJS plugins
'plugin-babel': 'npm:systemjs-plugin-babel@0.0.25/plugin-babel.js',
'systemjs-babel-build': 'npm:systemjs-plugin-babel@0.0.25/systemjs-babel-browser.js',
// Prettier
'prettier/standalone': 'npm:prettier@2.8.8/standalone.js',
'prettier/parser-html': 'npm:prettier@2.8.8/parser-html.js',
},
packages: {
'devextreme': {
defaultExtension: 'js',
},
'devextreme-react': {
main: 'index.js',
},
'devextreme/events/utils': {
main: 'index',
},
'devextreme/localization/messages': {
format: 'json',
defaultExtension: 'json',
},
'devextreme/events': {
main: 'index',
},
'es6-object-assign': {
main: './index.js',
defaultExtension: 'js',
},
},
packageConfigPaths: [
'npm:@devextreme/*/package.json',
'npm:@devextreme/runtime@3.0.12/inferno/package.json',
],
babelOptions: {
sourceMaps: false,
stage0: true,
react: true,
},
};
System.config(window.config);
xxxxxxxxxx
import React from 'react';
import ReactDOM from 'react-dom';
import App from './App.js';
ReactDOM.render(<App />, document.getElementById('app'));
xxxxxxxxxx
<html lang="en">
<head></head>
<body class="dx-viewport">
<div class="demo-container">
<div id="app"></div>
</div>
</body>
</html>
xxxxxxxxxx
.dx-fieldset {
min-height: 500px;
}
This demo illustrates the following:
-
Locale-dependent format The DateBox formats values based upon a user's locale. This is the default format. As such, you do not need to define the displayFormat property. Refer to the following help topic for more information: Localize Dates, Numbers, and Currencies
-
Built-in predefined formats DevExtreme supports various predefined formats. You can use simple strings or shortcuts that define commonly used date formats instead of complex expressions. Review the linked document for a list of values you can assign to displayFormat. This demo uses the "shortdate" format.
-
LDML pattern Use an LDML pattern to construct a custom date-time format string. This demo sets displayFormat property to "EEEE, d of MMM, yyyy HH:mm". This expression displays week day, day number, month, year, hour, and minute. The editor displays the formatted value. Refer to the following help topic for information about supported format characters: Custom Format String.
-
Format with literal characters Specify the displayFormat property as a string that contains literal and LDML characters. Wrap any characters that are not part of the LDML pattern in quotation marks - otherwise, they may be interpreted as wildcards. In this example, if you remove quotation marks from the word "Year", the letter "a" is interpreted as an "AM/PM" placeholder.
You can also use an input mask in the DateBox. Input masks ensure that input values match the displayFormat (set the useMaskBehavior value to true).
For additional formatting-related information, please refer to the following help topic: Value Formatting.