Angular DateRangeBox Properties

See Also

The value of this property will be passed to the accesskey attribute of the HTML element that underlies the UI component.

The UI component switches to the active state when users press down the primary mouse button. When this property is set to true, the CSS rules for the active state apply. You can change these rules to customize the component.

Use this property when you display the component on a platform whose guidelines include the active state change for UI components.

The property accepts the following values.

• "useButtons"
  Enables an end user to apply the selected value or cancel the selection using the Apply and Cancel buttons respectively.

• "instantly"
  Applies the selected value immediately after a user clicks the required value in the drop-down menu. To cancel the selection, click outside the drop-down menu.

Built-in buttons should also be declared in this array. You can find an example in the following demo:

View Demo

You can specify the Calendar properties in this object except those listed below. These properties are overridden by their DateRangeBox counterparts.

• dateSerializationFormat
• max
• min
• onValueChanged
• selectionMode
• tabIndex
• value

Date serialization involves date value conversion into a string format for storage or transmission. To ensure proper format detection, specify this property.

Use LDML patterns to pass custom format strings to this property.

For instance, you can specify the "yyyy-MM-dd" date pattern.

See Also

• Troubleshooting - Date String Handling Issues

See Also

• startDate
• endDate
• value

Set useMaskBehavior to true to limit user input according to the display format.

The default display format is selected automatically based on the current locale.

View Demo View on GitHub

See Also

• Format Widget Values

View Demo

See Also

• Custom Templates

See Popup Configuration for properties that you can specify in this object.

You can specify the end date in any of the following formats:

• Date
  Specifies a date object.

• Number
  Specifies the date as a timestamp (total milliseconds since 1970/01/01).

• String
  Specifies the date as a string value ("yyyy-MM-dd" - "2017-03-06").

If you change the date value, the new value is saved in the same format as the initial value. We recommend that you specify dates in UTC ISO 8601.

$(function() {
    $("#dateRangeBox").dxDateRangeBox({
        startDate: "5/23/2023",
        endDate: "5/28/2023",
    });
});

<dx-date-range-box    
    startDate="5/23/2023"
    endDate="5/28/2023"
></dx-date-range-box>

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

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

export class AppComponent { }

<template>
    <DxDateRangeBox
        start-date="5/23/2023"
        end-date="5/28/2023"
    />
</template>

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

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

export default {
    components: {
        DxDateRangeBox
    },
}
</script>

<template>
    <DxDateRangeBox 
        start-date="5/23/2023"
        end-date="5/28/2023"
    />
</template>

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

import { DxDateRangeBox } from 'devextreme-vue/date-range-box';
</script>

import React from 'react';

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

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

export default function App() { 
    return (
        <DateRangeBox 
            startDate="5/23/2023"
            endDate="5/28/2023"
        />
    );
}

View Demo View on GitHub

See Also

• startDate
• value

$(function() {
    $("#dateRangeBox").dxDateRangeBox({
        startDateLabel: "Start",
        endDateLabel: "End",
    });
});

<dx-date-range-box    
    startDateLabel="Start"
    endDateLabel="End"
></dx-date-range-box>

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

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

export class AppComponent { }

<template>
    <DxDateRangeBox
        start-date-label="Start"
        end-date-label="End"
    />
</template>

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

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

export default {
    components: {
        DxDateRangeBox
    },
}
</script>

<template>
    <DxDateRangeBox 
        start-date-label="Start"
        end-date-label="End"
    />
</template>

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

import { DxDateRangeBox } from 'devextreme-vue/date-range-box';
</script>

import React from 'react';

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

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

export default function App() { 
    return (
        <DateRangeBox 
            startDateLabel="Start"
            endDateLabel="End"
        />
    );
}

View on GitHub

See Also

• startDateLabel

$(function() {
    $("#dateRangeBox").dxDateRangeBox({
        startDatePlaceholder: "Type or pick a start date",
        endDatePlaceholder: "Type or pick an end date",
    });
});

<dx-date-range-box    
    startDatePlaceholder="Type or pick a start date"
    endDatePlaceholder="Type or pick an end date"
></dx-date-range-box>

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

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

export class AppComponent { }

<template>
    <DxDateRangeBox
        start-date-placeholder="Type or pick a start date"
        end-date-placeholder="Type or pick an end date"
    />
</template>

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

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

export default {
    components: {
        DxDateRangeBox
    },
}
</script>

<template>
    <DxDateRangeBox 
        start-date-placeholder="Type or pick a start date"
        end-date-placeholder="Type or pick an end date"
    />
</template>

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

import { DxDateRangeBox } from 'devextreme-vue/date-range-box';
</script>

import React from 'react';

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

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

export default function App() { 
    return (
        <DateRangeBox 
            startDatePlaceholder="Type or pick a start date"
            endDatePlaceholder="Type or pick an end date"
        />
    );
}

View Demo

See Also

• startDatePlaceholder

This property accepts a value of one of the following types:

• Number
  The height in pixels.

• String
  A CSS-accepted measurement of height. For example, "55px", "20vh", "80%", "inherit".

• Function (deprecated since v21.2)
  Refer to the W0017 warning description for information on how you can migrate to viewport units.

This property is a read-only flag. You can use it to check if the editor value changed.

$(() => {
    const dateRangeBox = $('#dateRangeBox').dxDateRangeBox({
        // ...
    }).dxDateRangeBox('instance');

    $('#button').dxButton({
        // ...
        onClick () {
            if (dateRangeBox.option('isDirty')) {
                DevExpress.ui.notify("Do not forget to save changes", "warning", 500);
            }
        }
    });
});

import { Component, ViewChild } from '@angular/core';
import { DxDateRangeBoxComponent, DxButtonModule } from 'devextreme-angular';
import notify from 'devextreme/ui/notify';

@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.css']
})
export class AppComponent {
    @ViewChild('dateRangeBoxRef', { static: false }) dateRangeBox: DxDateRangeBoxComponent;

    onClick () {
        if (this.dateRangeBox.instance.option('isDirty')) {
            notify("Do not forget to save changes", "warning", 500);
        }
    }
}

<dx-date-range-box ... 
    #dateRangeBoxRef
>
</dx-date-range-box>
<dx-button ...
    (onClick)="onClick($event)"
>
</dx-button>

<template>
    <DxDateRangeBox ...
        :ref="dateRangeBoxRef"
    >
    </DxDateRangeBox>
    <DxButton ...
        @click="onClick"
    />
</template>

<script>
import 'devextreme/dist/css/dx.light.css';
import DxDateRangeBox from 'devextreme-vue/date-range-box';
import DxButton from 'devextreme-vue/button';
import notify from 'devextreme/ui/notify';

export default {
    components: {
        DxDateRangeBox,
        DxButton
    },

    data() {
        return {
            dateRangeBoxRef
        }
    },

    methods: {
        onClick () {
            if (this.dateRangeBox.option('isDirty')) {
                notify("Do not forget to save changes", "warning", 500);
            }
        }
    },

    computed: {
        dateRangeBox: function() {
            return this.$refs[dateRangeBoxRef].instance;
        }
    }
}
</script>

import React, { useRef } from 'react';
import DateRangeBox from 'devextreme-react/date-range-box';
import Button from 'devextreme-react/button';
import 'devextreme/dist/css/dx.light.css';

const App = () => {
    const dateRangeBoxRef = useRef(null);

    const onClick = () => {
        if (this.dateRangeBoxRef.current.instance().option('isDirty')) {
            notify("Do not forget to save changes", "warning", 500);
        }
    };

    return (
        <DateRangeBox ...
            ref={dateRangeBoxRef}
        >
        </DateRangeBox>
        <Button ...
            onClick={onClick}
        />
    );
};

export default App;

See Also

• reset

See Also

• validationErrors

This property can have one of the following values:

$(function() {
    $("#dateRangeBox").dxDateRangeBox({
        min: "0/1/2018",
        max: "0/1/2024",
    });
});

<dx-date-range-box    
    min="1/1/2018"
    max="1/1/2024"
></dx-date-range-box>

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

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

export class AppComponent { }

<template>
    <DxDateRangeBox
        min="1/1/2018"
        max="1/1/2024"
    />
</template>

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

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

export default {
    components: {
        DxDateRangeBox
    },
}
</script>

<template>
    <DxDateRangeBox 
        min="1/1/2018"
        max="1/1/2024"
    />
</template>

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

import { DxDateRangeBox } from 'devextreme-vue/date-range-box';
</script>

import React from 'react';

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

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

export default function App() { 
    return (
        <DateRangeBox 
            min="1/1/2018"
            max="1/1/2024"
        />
    );
}

View Demo View on GitHub

See Also

• min
• value

$(function() {
    $("#dateRangeBox").dxDateRangeBox({
        min: "0/1/2018",
        max: "0/1/2024",
    });
});

<dx-date-range-box    
    min="1/1/2018"
    max="1/1/2024"
></dx-date-range-box>

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

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

export class AppComponent { }

<template>
    <DxDateRangeBox
        min="1/1/2018"
        max="1/1/2024"
    />
</template>

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

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

export default {
    components: {
        DxDateRangeBox
    },
}
</script>

<template>
    <DxDateRangeBox 
        min="1/1/2018"
        max="1/1/2024"
    />
</template>

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

import { DxDateRangeBox } from 'devextreme-vue/date-range-box';
</script>

import React from 'react';

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

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

export default function App() { 
    return (
        <DateRangeBox 
            min="1/1/2018"
            max="1/1/2024"
        />
    );
}

View Demo View on GitHub

See Also

• max
• value

View Demo

<dx-date-range-box ...
    (onInitialized)="saveInstance($event)">
</dx-date-range-box>

import { Component } from "@angular/core";
import DateRangeBox from "devextreme/ui/data_grid";
// ...
export class AppComponent {
    dateRangeBoxInstance: DateRangeBox;
    saveInstance (e) {
        this.dateRangeBoxInstance = e.component;
    }
}

<template>
    <div>
        <DxDateRangeBox ...
            @initialized="saveInstance">
        </DxDateRangeBox>
    </div>
</template>

<script>
import DxDateRangeBox from 'devextreme-vue/date-range-box';

export default {
    components: {
        DxDateRangeBox
    },
    data: function() {
        return {
            dateRangeBoxInstance: null
        };
    },
    methods: {
        saveInstance: function(e) {
            this.dateRangeBoxInstance = e.component;
        }
    }
};
</script>

<template>
    <div>
        <DxDateRangeBox ...
            @initialized="saveInstance">
        </DxDateRangeBox>
    </div>
</template>

<script setup>
import DxDateRangeBox from 'devextreme-vue/date-range-box';

let dateRangeBoxInstance = null;

const saveInstance = (e) => {
    dateRangeBoxInstance = e.component;
}
</script>

import DateRangeBox from 'devextreme-react/date-range-box';

class App extends React.Component {
    constructor(props) {
        super(props);

        this.saveInstance = this.saveInstance.bind(this);
    }

    saveInstance(e) {
        this.dateRangeBoxInstance = e.component;
    }

    render() {
        return (
            <div>
                <DateRangeBox onInitialized={this.saveInstance} />
            </div>
        );
    }
}

See Also

The following example shows how to subscribe to component property changes:

$(function() {
    $("#dateRangeBoxContainer").dxDateRangeBox({
        // ...
        onOptionChanged: function(e) {
            if(e.name === "changedProperty") {
                // handle the property change here
            }
        }
    });
});

<dx-date-range-box ...
    (onOptionChanged)="handlePropertyChange($event)"> 
</dx-date-range-box>

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

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

export class AppComponent { 
    // ...
    handlePropertyChange(e) {
        if(e.name === "changedProperty") { 
            // handle the property change here
        }
    }
}

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

@NgModule({ 
    declarations: [ 
        AppComponent 
    ], 
    imports: [ 
        BrowserModule, 
        DxDateRangeBoxModule 
    ], 
    providers: [ ], 
    bootstrap: [AppComponent] 
}) 

export class AppModule { }  

<template> 
    <DxDateRangeBox ...
        @option-changed="handlePropertyChange"
    />            
</template> 

<script>  
import 'devextreme/dist/css/dx.light.css'; 
import DxDateRangeBox from 'devextreme-vue/date-range-box'; 

export default { 
    components: { 
        DxDateRangeBox
    }, 
    // ...
    methods: { 
        handlePropertyChange: function(e) {
            if(e.name === "changedProperty") {
                // handle the property change here
            }
        }
    } 
} 
</script> 

import React from 'react';  
import 'devextreme/dist/css/dx.light.css'; 

import DateRangeBox from 'devextreme-react/date-range-box'; 

const handlePropertyChange = (e) => {
    if(e.name === "changedProperty") {
        // handle the property change here
    }
}

export default function App() { 
    return ( 
        <DateRangeBox ...
            onOptionChanged={handlePropertyChange}
        />        
    ); 
} 

See Also

• showDropDownButton

When this property is set to true, the following applies:

• The editor's value cannot be changed using the UI.
• Built-in action buttons are invisible.

• Custom action buttons are visible but disabled. If a button should not be disabled, set its disabled property to false:

  jQuery

  index.js

  $(function() {
      $("#dateRangeBoxContainer").dxDateRangeBox({
          // ...
          buttons: [{
              name: "myCustomButton",
              location: "after",
              options: {
                  onClick: function(e) {
                      // ...
                  },
                  disabled: false
              }
          }]
      });
  });

  Angular

  app.component.html

  app.component.ts

  app.module.ts

  <dx-date-range-box ... >
      <dxi-button
          name="myCustomButton"
          location="after"
          [options]="myCustomButtonConfig">
      </dxi-button>
  </dx-date-range-box>

  import { Component } from '@angular/core';
  
  @Component({
      selector: 'app-root',
      templateUrl: './app.component.html',
      styleUrls: ['./app.component.css']
  })
  export class AppComponent {
      myCustomButtonConfig = {
          onClick: (e) => {
              // ...
          },
          disabled: false
      };
  }

  import { BrowserModule } from '@angular/platform-browser';
  import { NgModule } from '@angular/core';
  import { AppComponent } from './app.component';
  
  import { DxDateRangeBoxModule } from 'devextreme-angular';
  
  @NgModule({
      declarations: [
          AppComponent
      ],
      imports: [
          BrowserModule,
          DxDateRangeBoxModule
      ],
      providers: [ ],
      bootstrap: [AppComponent]
  })
  export class AppModule { }

  Vue

  App.vue

  <template>
      <DxDateRangeBox ... >
          <DxDateRangeBoxButton
              name="myCustomButton"
              location="after"
              :options="myCustomButtonConfig"
          />
      </DxDateRangeBox>
  </template>
  
  <script>
  import 'devextreme/dist/css/dx.light.css';
  
  import DxDateRangeBox, {
      DxButton as DxDateRangeBoxButton
  } from 'devextreme-vue/date-range-box';
  
  export default {
      components: {
          DxDateRangeBox,
          DxDateRangeBoxButton
      },
      data() {
          return {
              myCustomButtonConfig: {
                  onClick: (e) => {
                      // ...
                  },
                  disabled: false
              }
          }
      }
  }
  </script>

  React

  App.js

  import React from 'react';
  
  import 'devextreme/dist/css/dx.light.css';
  
  import DateRangeBox, {
      Button as DateRangeBoxButton
  } from 'devextreme-react/date-range-box';
  
  class App extends React.Component {
      myCustomButtonConfig = {
          onClick: (e) => {
              // ...
          },
          disabled: false
      };
      render() {
          return (
              <DateRangeBox>
                  <DateRangeBoxButton
                      name="myCustomButton"
                      location="after"
                      options={this.myCustomButtonConfig}
                  />
              </DateRangeBox>
          );
      }
  }
  export default App;

  You can also hide a custom action button when the UI component becomes read-only. Set the button's visible property to false in the onOptionChanged function. To get the button, use the getButton(name) method:

  jQuery

  index.js

  $(function() {
      $("#dateRangeBoxContainer").dxDateRangeBox({
          // ...
          buttons: [{
              name: "myCustomButton",
              // ...
          }],
          onOptionChanged: function(e) {
              if(e.name == "readOnly") {
                  const myButton = e.component.getButton("myCustomButton");
                  myButton.option("visible", !e.value); // Hide the button when readOnly: true
              }
          }
      });
  });

  Angular

  app.component.html

  app.component.ts

  app.module.ts

  <dx-date-range-box ...
      (onOptionChanged)="changeButtonState">
      <dxi-button
          name="myCustomButton"
          ...
      ></dxi-button>
  </dx-date-range-box>

  import { Component } from '@angular/core';
  
  @Component({
      selector: 'app-root',
      templateUrl: './app.component.html',
      styleUrls: ['./app.component.css']
  })
  export class AppComponent {
      changeButtonState(e) {
          if(e.name == 'readOnly') {
              let myButton = e.component.getButton('myCustomButton');
              myButton.option('visible', !e.value); // Hide the button when readOnly: true
          }
      }
  }

  import { BrowserModule } from '@angular/platform-browser';
  import { NgModule } from '@angular/core';
  import { AppComponent } from './app.component';
  
  import { DxDateRangeBoxModule } from 'devextreme-angular';
  
  @NgModule({
      declarations: [
          AppComponent
      ],
      imports: [
          BrowserModule,
          DxDateRangeBoxModule
      ],
      providers: [ ],
      bootstrap: [AppComponent]
  })
  export class AppModule { }

  Vue

  App.vue

  <template>
      <DxDateRangeBox ...
          @option-changed="changeButtonState">
          <DxDateRangeBoxButton
              name="myCustomButton"
              ...
          />
      </DxDateRangeBox>
  </template>
  
  <script>
  import 'devextreme/dist/css/dx.light.css';
  
  import DxDateRangeBox, {
      DxButton as DxDateRangeBoxButton
  } from 'devextreme-vue/date-range-box';
  
  export default {
      components: {
          DxDateRangeBox,
          DxDateRangeBoxButton
      },
      data() {
          return {
              // ...
          }
      },
      methods: {
          changeButtonState(e) {
              if(e.name == 'readOnly') {
                  let myButton = e.component.getButton('myCustomButton');
                  myButton.option('visible', !e.value); // Hide the button when readOnly: true
              }
          }
      }
  }
  </script>

  React

  App.js

  import React from 'react';
  
  import 'devextreme/dist/css/dx.light.css';
  
  import DateRangeBox, {
      Button as DateRangeBoxButton
  } from 'devextreme-react/date-range-box';
  
  class App extends React.Component {
      changeButtonState(e) {
          if(e.name == 'readOnly') {
              let myButton = e.component.getButton('myCustomButton');
              myButton.option('visible', !e.value); // Hide the button when readOnly: true
          }
      }
      render() {
          return (
              <DateRangeBox ...
                  onOptionChanged={this.changeButtonState}>
                  <DateRangeBoxButton
                      name="myCustomButton"
                      ...
                  />
              </DateRangeBox>
          );
      }
  }
  export default App;

When this property is set to true, the UI component text flows from right to left, and the layout of elements is reversed. To switch the entire application/site to the right-to-left representation, assign true to the rtlEnabled field of the object passed to the DevExpress.config(config) method.

DevExpress.config({
    rtlEnabled: true
});

DataGrid Demo Navigation UI Demo Editors Demo

The Clear button calls the reset method.

See Also

• dropDownButtonTemplate

You can specify the start date in any of the following formats:

• Date
  Specifies a date object.

• Number
  Specifies the date as a timestamp (total milliseconds since 1970/01/01).

• String
  Specifies the date as a string value ("yyyy-MM-dd" - "2017-03-06").

If you change the date value, the new value is saved in the same format as the initial value. We recommend that you specify dates in UTC ISO 8601.

$(function() {
    $("#dateRangeBox").dxDateRangeBox({
        startDate: "5/23/2023",
        endDate: "5/28/2023",
    });
});

<dx-date-range-box    
    startDate="5/23/2023"
    endDate="5/28/2023"
></dx-date-range-box>

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

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

export class AppComponent { }

<template>
    <DxDateRangeBox
        start-date="5/23/2023"
        end-date="5/28/2023"
    />
</template>

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

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

export default {
    components: {
        DxDateRangeBox
    },
}
</script>

<template>
    <DxDateRangeBox 
        start-date="5/23/2023"
        end-date="5/28/2023"
    />
</template>

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

import { DxDateRangeBox } from 'devextreme-vue/date-range-box';
</script>

import React from 'react';

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

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

export default function App() { 
    return (
        <DateRangeBox 
            startDate="5/23/2023"
            endDate="5/28/2023"
        />
    );
}

View Demo View on GitHub

See Also

• endDate
• value

$(function() {
    $("#dateRangeBox").dxDateRangeBox({
        startDateLabel: "Start",
        endDateLabel: "End",
    });
});

<dx-date-range-box    
    startDateLabel="Start"
    endDateLabel="End"
></dx-date-range-box>

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

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

export class AppComponent { }

<template>
    <DxDateRangeBox
        start-date-label="Start"
        end-date-label="End"
    />
</template>

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

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

export default {
    components: {
        DxDateRangeBox
    },
}
</script>

<template>
    <DxDateRangeBox 
        start-date-label="Start"
        end-date-label="End"
    />
</template>

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

import { DxDateRangeBox } from 'devextreme-vue/date-range-box';
</script>

import React from 'react';

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

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

export default function App() { 
    return (
        <DateRangeBox 
            startDateLabel="Start"
            endDateLabel="End"
        />
    );
}

View on GitHub

See Also

• endDateLabel

$(function() {
    $("#dateRangeBox").dxDateRangeBox({
        startDatePlaceholder: "Type or pick a start date",
        endDatePlaceholder: "Type or pick an end date",
    });
});

<dx-date-range-box    
    startDatePlaceholder="Type or pick a start date"
    endDatePlaceholder="Type or pick an end date"
></dx-date-range-box>

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

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

export class AppComponent { }

<template>
    <DxDateRangeBox
        start-date-placeholder="Type or pick a start date"
        end-date-placeholder="Type or pick an end date"
    />
</template>

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

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

export default {
    components: {
        DxDateRangeBox
    },
}
</script>

<template>
    <DxDateRangeBox 
        start-date-placeholder="Type or pick a start date"
        end-date-placeholder="Type or pick an end date"
    />
</template>

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

import { DxDateRangeBox } from 'devextreme-vue/date-range-box';
</script>

import React from 'react';

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

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

export default function App() { 
    return (
        <DateRangeBox 
            startDatePlaceholder="Type or pick a start date"
            endDatePlaceholder="Type or pick an end date"
        />
    );
}

View Demo

See Also

• endDatePlaceholder

The following styles are available:

You can also use the global editorStylingMode setting to specify how the text fields of all editors in your application are styled.

The value of this property will be passed to the tabindex attribute of the HTML element that underlies the UI component.

See Also

• isValid

The following property values are possible:

• auto
  The tooltip with the message is displayed when the editor is in focus.
• always
  The tooltip with the message is not hidden when the editor loses focus.

If you set this property to auto, the component specifies the validation message position automatically.

The following example positions a validation message at the component's right:

$(function() {
    $("#dateRangeBoxContainer").dxDateRangeBox({
        // ...
        validationMessagePosition: 'right'
    }).dxValidator({
        validationRules: [{
            type: 'required',
            message: 'Required',
        }],
    });
});

<dx-date-range-box ...
    validationMessagePosition="right">
    <dx-validator>
        <dxi-validation-rule
            type="required"
            message="Required"
        >
        </dxi-validation-rule>
    </dx-validator>
</dx-date-range-box>

<template>
    <DxDateRangeBox ...
        validation-message-position="right"
    >
        <DxValidator>
            <DxRequiredRule message="Required" />
        </DxValidator>
    </DxDateRangeBox>
</template>

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

import React from 'react';
// ...

function App() {
    return (
        <DateRangeBox ...
            validationMessagePosition="right"
        >
            <Validator>
                <RequiredRule message="Required" />
            </Validator>
        </DateRangeBox>
    ); 

};
export default App;

The following table illustrates the validation status indicators:

validationStatus	Indicator
"pending"
"valid"
"invalid"

When you assign "invalid" to validationStatus, you can also use the validationErrors array to set an error message as shown below:

$(function() {
    const dateRangeBox = $("#dateRangeBoxContainer").dxDateRangeBox({
        // ...
    }).dxDateRangeBox("instance");

    function setInvalidStatus(message) {
        dateRangeBox.option({
            validationStatus: "invalid",
            validationErrors: [{ message: message }]
        });
    }
});

<dx-date-range-box
    [validationStatus]="validationStatus"
    [validationErrors]="validationErrors">
</dx-date-range-box>

// ...
export class AppComponent {
    validationStatus: string = "valid";
    validationErrors: any;
    // ...
    setInvalidStatus(message) {
        this.validationStatus = "invalid";
        this.validationErrors = [{ message: message }];
    }
}

<template>
    <DxDateRangeBox ...
        :validation-status="validationStatus"
        :validation-errors="validationErrors"
    />
</template>

<script>
    // ...
    export default {
        // ...
        data() {
            return {
                validationStatus: "valid",
                validationErrors: []
            }
        },
        methods: {
            setInvalidStatus(message) {
                this.validationStatus = "invalid";
                this.validationErrors = [{ message: message }];
            }
        }
    }
</script>

import React, { useState } from 'react';
// ...

function App() {
    const [validationStatus, setValidationStatus] = useState("valid");
    const [validationErrors, setValidationErrors] = useState([]);

    const setInvalidStatus = message => {
        setValidationStatus("invalid");
        setValidationErrors([{ message: message }]);
    }

    return (
        <DateRangeBox
            validationStatus={validationStatus}
            validationErrors={validationErrors}
        />
    ); 

};
export default App;

You can specify dates in any of the following formats:

• Date
  Specifies a date object.

• Number
  Specifies a date as a timestamp (total milliseconds since 1970/01/01).

• String
  Specifies a date as a string value ("yyyy-MM-dd" - "2017-03-06").

If you change a date value, the new value is saved in the same format as the initial value. We recommend that you specify dates in UTC ISO 8601.

$(function() {
    $("#dateRangeBox").dxDateRangeBox({
        value: ['5/23/2023','5/28/2023'],
    });
});

<dx-date-range-box 
    [value]="['5/23/2023','5/28/2023']"
></dx-date-range-box>

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

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

export class AppComponent { }

<template>
    <DxDateRangeBox 
        :value="['5/23/2023','5/28/2023']"
    />
</template>

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

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

export default {
    components: {
        DxDateRangeBox
    },
}
</script>

<template>
    <DxDateRangeBox 
        :value="['5/23/2023','5/28/2023']"
    />
</template>

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

import { DxDateRangeBox } from 'devextreme-vue/date-range-box';
</script>

import React from 'react';

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

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

export default function App() { 
    return (
        <DateRangeBox 
            value={['5/23/2023','5/28/2023']}
        />
    );
}

View Demo

See Also

• startDate
• endDate

This property accepts a single event name or several names separated by spaces.

The recommended events are "keyup", "blur", "change", "input", and "focusout", but you can use other events as well.

See Also

• onValueChanged

This property accepts a value of one of the following types:

• Number
  The width in pixels.

• String
  A CSS-accepted measurement of width. For example, "55px", "20vw", "80%", "auto", "inherit".

• Function (deprecated since v21.2)
  Refer to the W0017 warning description for information on how you can migrate to viewport units.