This tutorial shows how to configure basic DateBox features. The newly created UI component allows users to set the date and time from a specific date range, logs this value to the console, and prevents users from specifying weekend days (Saturday and Sunday) and US bank holidays.

Each section in this tutorial covers a single configuration step. You can also find the full code in the following GitHub repository: getting-started-with-datebox.

Create the DateBox

Use the following code to create a basic DateBox:

jQuery

index.js

index.html

$(function() {
    $("#dateBox").dxDateBox({
        // Configuration goes here
     });
});

<!DOCTYPE html>
<html>
    <head>
        <script type="text/javascript" src="https://code.jquery.com/jquery-3.5.1.min.js"></script>
        <link rel="stylesheet" href="https://cdn3.devexpress.com/jslib/21.2.15/css/dx.light.css">
        <script type="text/javascript" src="https://cdn3.devexpress.com/jslib/21.2.15/js/dx.all.js"></script>
        <script type="text/javascript" src="index.js"></script>
    </head>
    <body class="dx-viewport">
        <div id="dateBox"></div>
    </body>
</html>

Angular

app.component.html

app.component.ts

app.module.ts

<dx-date-box
    <!-- Configuration goes here -->
>
</dx-date-box>

import { Component } from '@angular/core';

@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.css']
})
export class AppComponent {

}

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';

import { DxDateBoxModule } from 'devextreme-angular';

@NgModule({
    declarations: [
        AppComponent
    ],
    imports: [
        BrowserModule,
        DxDateBoxModule
    ],
    providers: [ ],
    bootstrap: [AppComponent]
})
export class AppModule { }

Vue

App.vue

<template>
    <DxDateBox
        <!-- Configuration goes here -->
    />
</template>

<script>
import 'devextreme/dist/css/dx.light.css';

import { DxDateBox } from 'devextreme-vue/date-box';

export default {
    components: {
        DxDateBox
    }
}
</script>

React

App.js

import React from 'react';

import 'devextreme/dist/css/dx.light.css';

import { DateBox } from 'devextreme-react/date-box';

class App extends React.Component {
    render() {
        return (
            <DateBox      
                // Configuration goes here
            />
        );
    }
}
export default App;

If you run this code, you will that see the DateBox that allows users to set the date only. Users will be allowed to set the time in the next step.

Set the DateBox Type

To allow users to specify the date and time, set the type to "datetime". This will implicitly set applyValueMode to "useButtons" (i.e., a user must press OK to submit their choices).

jQuery

index.js

$(function() {
    $("#dateBox").dxDateBox({
        type: "datetime"
    });
});

Angular

app.component.html

<dx-date-box    
    type="datetime">
</dx-date-box>

Vue

App.vue

<template>
    <DxDateBox
        type="datetime"
    />
</template>

<script>
    // ...
</script>

React

App.js

import React from 'react';

import 'devextreme/dist/css/dx.light.css';

import { DateBox } from 'devextreme-react/date-box';

class App extends React.Component {
     render() {
        return (
            <DateBox      
                type="datetime"
            />
        );
    }
}
export default App;

Run this code and ensure it is possible to specify the date and time. In the next step, we will set an accepted date range.

Set the Accepted Date Range

To define the range from which users can select dates, specify the min and max properties:

jQuery

index.js

$(function() {
    const now = new Date();

    $("#dateBox").dxDateBox({
        max: now,
        min: new Date(1900, 0, 1),
     });
});

Angular

app.component.html

app.component.ts

<dx-date-box ... 
    [min]="minDate"
    [max]="now">
</dx-date-box>

import { Component } from '@angular/core';

@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.css']
})
export class AppComponent {
    minDate: Date = new Date(1900, 0, 1);
    now: Date = new Date();
}

Vue

App.vue

<template>
    <DxDateBox ...
        :min="minDate"
        :max="now"
    />
</template>

<script>
import 'devextreme/dist/css/dx.light.css';

import { DxDateBox } from 'devextreme-vue/date-box';

export default {
    components: {
        DxDateBox
    },
    data() {
        return {
            minDate: new Date(1900, 0, 1)
            now: Date(),
        }
    }
}
</script>

React

App.js

import React from 'react';

import 'devextreme/dist/css/dx.light.css';

import { DateBox } from 'devextreme-react/date-box';

class App extends React.Component {
    minDate = new Date(1900, 0, 1);
    now = new Date();

    render() {
        return (
            <DateBox      
                min={this.minDate}
                max={this.now}
            />
        );
    }
}
export default App;

Run the code and ensure that the only available dates are between 1 Jan 1900 and today. Next, we will set the UI component's initial value.

Set the Value

To set the UI component's value, specify the value property. In this tutorial, it is equal to the current date and time.

jQuery

index.js

$(function() {
    const now = new Date();

    $("#dateBox").dxDateBox({
        // ...
        value: now
    });
});

Angular

app.component.html

app.component.ts

<dx-date-box ...    
    [value]="now">
</dx-date-box>

import { Component } from '@angular/core';

@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.css']
})
export class AppComponent {
    // ...
    now: Date = new Date();
}

Vue

App.vue

<template>
    <DxDateBox ...
        :value="now"
    />
</template>

<script>
import 'devextreme/dist/css/dx.light.css';

import { DxDateBox } from 'devextreme-vue/date-box';

export default {
    components: {
        DxDateBox
    },
    data() {
        return {
            // ...
            now: Date(),
        }
    }
}
</script>

React

App.js

import React from 'react';

import 'devextreme/dist/css/dx.light.css';

import { DateBox } from 'devextreme-react/date-box';

class App extends React.Component {
    // ...
    now = new Date();

    constructor(props) {
        super(props);
        this.state = {
            dateBoxValue: this.now
        };
    }

    render() {
        return (
            <DateBox ...
                value={this.state.dateBoxValue}
            />
        );
    }
}
export default App;

In the next step, we will handle the value change event.

Handle the Value Change Event

To handle value changes, implement the onValueChanged function. In this tutorial, it logs the previous and current values.

jQuery

index.js

$(function() {
    $("#dateBox").dxDateBox({
        // ...
        onValueChanged: function(e) {
            console.log(e.value);
            console.log(e.previousValue);
        },
    });
});

Angular

app.component.html

app.component.ts

<dx-date-box ...
    (onValueChanged)="onValueChanged($event)">
</dx-date-box>

import { Component } from '@angular/core';

@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.css']
})
export class AppComponent {
    // ...
    onValueChanged(e) {
        console.log(e.previousValue);
        console.log(e.value);
    }
}

Vue

App.vue

<template>
    <DxDateBox ...
        @value-changed="onValueChanged"
    />
</template>

<script>
import 'devextreme/dist/css/dx.light.css';

import { DxDateBox } from 'devextreme-vue/date-box';

export default {
    // ...
    methods: {
        onValueChanged(e) {
            console.log(e.previousValue);
            console.log(e.value);
        }
    }
}
</script>

React

App.js

import React from 'react';

import 'devextreme/dist/css/dx.light.css';

import { DateBox } from 'devextreme-react/date-box';

class App extends React.Component {
    constructor(props) {
        // ...
        this.onValueChanged = this.onValueChanged.bind(this);
    }

    onValueChanged(e) {
        console.log(e.previousValue);
        console.log(e.value);
        this.setState({
            dateBoxValue: e.value
        });
    } 

    render() {
        return (
            <DateBox ...
                onValueChanged={this.onValueChanged}
            />
        );
    }
}
export default App;

Add a Label

To specify label text, set the label property. If you want to enable floating labels, set the labelMode property to "floating". In this case, the label acts as a placeholder, but when the editor gets focus, the label moves to the position above the input field.

jQuery

index.js

$(function() {
    $("#dateBox").dxDateBox({
        // ...
        label: "Date and time",
        labelMode: "floating",
    });
});

Angular

app.component.html

<dx-date-box ...
    label="Date and time"
    labelMode="floating">
</dx-date-box>

Vue

App.vue

<template>
    <DxDateBox ...
        label="Date and time"
        label-mode="floating"
    />
</template>

<script>
// ...
</script>

React

App.js

// ...
class App extends React.Component {
    // ...
    render() {
        return (
            <DateBox ...
                label="Date and time"
                labelMode="floating"
            />
        );
    }
}
export default App;

View Demo

Disable Specific Dates

To prevent users from setting specific dates, use the disabledDates property. It can be set to a function or an array of Date values. In this tutorial, we implement a function that disables weekend days (Saturday and Sunday) and US bank holidays.

jQuery

index.js

$(function() {
    // ...
    const holidays = [
        new Date(0, 0, 1),
        new Date(0, 0, 20),
        new Date(0, 1, 17),
        new Date(0, 4, 10),
        new Date(0, 4, 25),
        new Date(0, 5, 21),
        new Date(0, 6, 4),
        new Date(0, 8, 7),
        new Date(0, 9, 5),
        new Date(0, 9, 12),
        new Date(0, 10, 11),
        new Date(0, 10, 26),
        new Date(0, 10, 27),
        new Date(0, 11, 24),
        new Date(0, 11, 25),
        new Date(0, 11, 31)
    ];

    $("#dateBox").dxDateBox({
        // ...
        disabledDates: function(args) {
            const dayOfWeek = args.date.getDay();
            const isWeekend = dayOfWeek === 0 || dayOfWeek === 6; 
            return args.view === "month" && (isWeekend || isHoliday(args.date)); 
        }
    });

    function isHoliday(date) {
        for (let holiday of holidays) {
            if (date.getDate() === holiday.getDate() && date.getMonth() === holiday.getMonth()) {
                return true;
            }          
        }
        return false;
    }
});

Angular

app.component.html

app.component.ts

app.service.ts

<dx-date-box ...
    [disabledDates]="getDisabledDates">
</dx-date-box>

import { Component } from '@angular/core';
import { AppService } from './app.service';

@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.css']
})
export class AppComponent {
    // ...
    holidays: Date[];

    constructor(service: AppService) {
        this.holidays = service.getHolidays();
        this.getDisabledDates = this.getDisabledDates.bind(this);
    }

    getDisabledDates(args): boolean {
        const dayOfWeek = args.date.getDay();
        const isWeekend = dayOfWeek === 0 || dayOfWeek === 6;
        return args.view === "month" && (isWeekend || this.isHoliday(args.date));
    }

    isHoliday(date): boolean {
        for (let holiday of this.holidays) {
            if (date.getDate() === holiday.getDate() && date.getMonth() === holiday.getMonth()) {
                return true;
            }          
        }
        return false;
    }
}

import { Injectable } from '@angular/core';

const holidays = [
    new Date(0, 0, 1),
    new Date(0, 0, 20),
    new Date(0, 1, 17),
    new Date(0, 4, 10),
    new Date(0, 4, 25),
    new Date(0, 5, 21),
    new Date(0, 6, 4),
    new Date(0, 8, 7),
    new Date(0, 9, 5),
    new Date(0, 9, 12),
    new Date(0, 10, 11),
    new Date(0, 10, 26),
    new Date(0, 10, 27),
    new Date(0, 11, 24),
    new Date(0, 11, 25),
    new Date(0, 11, 31)
];

@Injectable()
export class AppService {

    getHolidays(): Date[] {
        return holidays;
    }
}

Vue

App.vue

<template>
    <DxDateBox ...
        :disabled-dates="getDisabledDates"
    />
</template>

<script>
import 'devextreme/dist/css/dx.light.css';

import { DxDateBox } from 'devextreme-vue/date-box';

const holidays = [
    new Date(0, 0, 1),
    new Date(0, 0, 20),
    new Date(0, 1, 17),
    new Date(0, 4, 10),
    new Date(0, 4, 25),
    new Date(0, 5, 21),
    new Date(0, 6, 4),
    new Date(0, 8, 7),
    new Date(0, 9, 5),
    new Date(0, 9, 12),
    new Date(0, 10, 11),
    new Date(0, 10, 26),
    new Date(0, 10, 27),
    new Date(0, 11, 24),
    new Date(0, 11, 25),
    new Date(0, 11, 31)
]

export default {
    // ...
    methods: {
        getDisabledDates(args) {
            const dayOfWeek = args.date.getDay();
            const isWeekend = dayOfWeek === 0 || dayOfWeek === 6;
            return args.view === "month" && (isWeekend || this.isHoliday(args.date));
        },
        isHoliday(date) {
            for (let holiday of holidays) {
                if (date.getDate() === holiday.getDate() && date.getMonth() === holiday.getMonth()) {
                    return true;
                }          
            }
            return false;
        }
    }
}
</script>

React

App.js

import React from 'react';

import 'devextreme/dist/css/dx.light.css';

import { DateBox } from 'devextreme-react/date-box';

const holidays = [
    new Date(0, 0, 1),
    new Date(0, 0, 20),
    new Date(0, 1, 17),
    new Date(0, 4, 10),
    new Date(0, 4, 25),
    new Date(0, 5, 21),
    new Date(0, 6, 4),
    new Date(0, 8, 7),
    new Date(0, 9, 5),
    new Date(0, 9, 12),
    new Date(0, 10, 11),
    new Date(0, 10, 26),
    new Date(0, 10, 27),
    new Date(0, 11, 24),
    new Date(0, 11, 25),
    new Date(0, 11, 31)
];

class App extends React.Component {
    // ...

    constructor(props) {
        // ...
        this.getDisabledDates = this.getDisabledDates.bind(this);
    }

    getDisabledDates(args) {
        const dayOfWeek = args.date.getDay();
        const isWeekend = dayOfWeek === 0 || dayOfWeek === 6;
        return args.view === "month" && (isWeekend || this.isHoliday(args.date));
    }

    isHoliday(date) {
        for (let holiday of holidays) {
            if (date.getDate() === holiday.getDate() && date.getMonth() === holiday.getMonth()) {
                return true;
            }          
        }
        return false;
    }

    render() {
        return (
            <DateBox ...
                disabledDates={this.getDisabledDates}
            />
        );
    }
}
export default App;

Run the code and ensure that the disabled dates cannot be set.

You have now configured the basic DateBox features. For more details on this UI component, explore the following resources:

Feedback

Was this page helpful?

Thanks for your feedback!
Any other suggestions? Tell us here.

Additional Feedback

General Information

.NET Subscription

Common Tools

Quality Assurance and Productivity

Desktop

Controls

Tools

Frameworks and Libraries

Web

Controls and Extensions

Tools

Maintenance Mode

Mobile

Enterprise and Analytic Tools

End-User Documentation

General Information

.NET Subscription

Common Tools

Quality Assurance and Productivity

Desktop

Controls

Tools

Frameworks and Libraries

Web

Controls and Extensions

Tools

Maintenance Mode

Mobile

Enterprise and Analytic Tools

End-User Documentation

JavaScript/jQuery DateBox - Getting Started

jQuery

Angular

Vue

React

Create the DateBox

jQuery

Angular

Vue

React

Set the DateBox Type

jQuery

Angular

Vue

React

Set the Accepted Date Range

jQuery

Angular

Vue

React

Set the Value

jQuery

Angular

Vue

React

Handle the Value Change Event

jQuery

Angular

Vue

React

Add a Label

jQuery

Angular

Vue

React

Disable Specific Dates

jQuery

Angular

Vue

React