diff --git a/docs/pages/x/api/date-pickers/date-calendar.json b/docs/pages/x/api/date-pickers/date-calendar.json
index baf4efe60d43..164cd9813a21 100644
--- a/docs/pages/x/api/date-pickers/date-calendar.json
+++ b/docs/pages/x/api/date-pickers/date-calendar.json
@@ -22,7 +22,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultValue": { "type": { "name": "any" } },
"disabled": { "type": { "name": "bool" } },
"disableFuture": { "type": { "name": "bool" } },
diff --git a/docs/pages/x/api/date-pickers/date-picker.json b/docs/pages/x/api/date-pickers/date-picker.json
index 53ce7e4a1850..b895b1926fb4 100644
--- a/docs/pages/x/api/date-pickers/date-picker.json
+++ b/docs/pages/x/api/date-pickers/date-picker.json
@@ -27,7 +27,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultValue": { "type": { "name": "any" } },
"desktopModeMediaQuery": {
"type": { "name": "string" },
diff --git a/docs/pages/x/api/date-pickers/date-range-calendar.json b/docs/pages/x/api/date-pickers/date-range-calendar.json
index 3ecb3d31537a..98ea95743f7f 100644
--- a/docs/pages/x/api/date-pickers/date-range-calendar.json
+++ b/docs/pages/x/api/date-pickers/date-range-calendar.json
@@ -30,7 +30,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultRangePosition": {
"type": { "name": "enum", "description": "'end'
| 'start'" },
"default": "'start'"
diff --git a/docs/pages/x/api/date-pickers/date-range-picker.json b/docs/pages/x/api/date-pickers/date-range-picker.json
index 2c43d35351db..eaaf8c65a3ff 100644
--- a/docs/pages/x/api/date-pickers/date-range-picker.json
+++ b/docs/pages/x/api/date-pickers/date-range-picker.json
@@ -35,7 +35,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultRangePosition": {
"type": { "name": "enum", "description": "'end'
| 'start'" },
"default": "'start'"
diff --git a/docs/pages/x/api/date-pickers/date-time-picker.json b/docs/pages/x/api/date-pickers/date-time-picker.json
index 3386c513418e..a897646e6482 100644
--- a/docs/pages/x/api/date-pickers/date-time-picker.json
+++ b/docs/pages/x/api/date-pickers/date-time-picker.json
@@ -29,7 +29,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultValue": { "type": { "name": "any" } },
"desktopModeMediaQuery": {
"type": { "name": "string" },
diff --git a/docs/pages/x/api/date-pickers/desktop-date-picker.json b/docs/pages/x/api/date-pickers/desktop-date-picker.json
index d0615bc68d26..8456389af688 100644
--- a/docs/pages/x/api/date-pickers/desktop-date-picker.json
+++ b/docs/pages/x/api/date-pickers/desktop-date-picker.json
@@ -27,7 +27,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultValue": { "type": { "name": "any" } },
"disabled": { "type": { "name": "bool" } },
"disableFuture": { "type": { "name": "bool" } },
diff --git a/docs/pages/x/api/date-pickers/desktop-date-range-picker.json b/docs/pages/x/api/date-pickers/desktop-date-range-picker.json
index bce110b6041a..c01c21b2239a 100644
--- a/docs/pages/x/api/date-pickers/desktop-date-range-picker.json
+++ b/docs/pages/x/api/date-pickers/desktop-date-range-picker.json
@@ -35,7 +35,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultRangePosition": {
"type": { "name": "enum", "description": "'end'
| 'start'" },
"default": "'start'"
diff --git a/docs/pages/x/api/date-pickers/desktop-date-time-picker.json b/docs/pages/x/api/date-pickers/desktop-date-time-picker.json
index d67e2fbbd7a9..882528ffa024 100644
--- a/docs/pages/x/api/date-pickers/desktop-date-time-picker.json
+++ b/docs/pages/x/api/date-pickers/desktop-date-time-picker.json
@@ -29,7 +29,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultValue": { "type": { "name": "any" } },
"disabled": { "type": { "name": "bool" } },
"disableFuture": { "type": { "name": "bool" } },
diff --git a/docs/pages/x/api/date-pickers/mobile-date-picker.json b/docs/pages/x/api/date-pickers/mobile-date-picker.json
index b6eb95133ffa..0d9310d167c9 100644
--- a/docs/pages/x/api/date-pickers/mobile-date-picker.json
+++ b/docs/pages/x/api/date-pickers/mobile-date-picker.json
@@ -27,7 +27,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultValue": { "type": { "name": "any" } },
"disabled": { "type": { "name": "bool" } },
"disableFuture": { "type": { "name": "bool" } },
diff --git a/docs/pages/x/api/date-pickers/mobile-date-range-picker.json b/docs/pages/x/api/date-pickers/mobile-date-range-picker.json
index 849f9fbfe348..d3f9d550f0ba 100644
--- a/docs/pages/x/api/date-pickers/mobile-date-range-picker.json
+++ b/docs/pages/x/api/date-pickers/mobile-date-range-picker.json
@@ -35,7 +35,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultRangePosition": {
"type": { "name": "enum", "description": "'end'
| 'start'" },
"default": "'start'"
diff --git a/docs/pages/x/api/date-pickers/mobile-date-time-picker.json b/docs/pages/x/api/date-pickers/mobile-date-time-picker.json
index 027d3fe050eb..cf36573fd197 100644
--- a/docs/pages/x/api/date-pickers/mobile-date-time-picker.json
+++ b/docs/pages/x/api/date-pickers/mobile-date-time-picker.json
@@ -29,7 +29,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultValue": { "type": { "name": "any" } },
"disabled": { "type": { "name": "bool" } },
"disableFuture": { "type": { "name": "bool" } },
diff --git a/docs/pages/x/api/date-pickers/static-date-picker.json b/docs/pages/x/api/date-pickers/static-date-picker.json
index 96402f01f0bb..c0b438fbb8b2 100644
--- a/docs/pages/x/api/date-pickers/static-date-picker.json
+++ b/docs/pages/x/api/date-pickers/static-date-picker.json
@@ -23,7 +23,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultValue": { "type": { "name": "any" } },
"disabled": { "type": { "name": "bool" } },
"disableFuture": { "type": { "name": "bool" } },
diff --git a/docs/pages/x/api/date-pickers/static-date-range-picker.json b/docs/pages/x/api/date-pickers/static-date-range-picker.json
index a0e054f2bc2e..d5c2c32bdbfb 100644
--- a/docs/pages/x/api/date-pickers/static-date-range-picker.json
+++ b/docs/pages/x/api/date-pickers/static-date-range-picker.json
@@ -31,7 +31,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultRangePosition": {
"type": { "name": "enum", "description": "'end'
| 'start'" },
"default": "'start'"
diff --git a/docs/pages/x/api/date-pickers/static-date-time-picker.json b/docs/pages/x/api/date-pickers/static-date-time-picker.json
index 5314efd3b56d..54327dc5ed27 100644
--- a/docs/pages/x/api/date-pickers/static-date-time-picker.json
+++ b/docs/pages/x/api/date-pickers/static-date-time-picker.json
@@ -25,7 +25,11 @@
"returned": "string"
}
},
- "defaultCalendarMonth": { "type": { "name": "any" } },
+ "defaultCalendarMonth": {
+ "type": { "name": "any" },
+ "deprecated": true,
+ "deprecationInfo": "Consider using referenceDate
instead."
+ },
"defaultValue": { "type": { "name": "any" } },
"disabled": { "type": { "name": "bool" } },
"disableFuture": { "type": { "name": "bool" } },
diff --git a/packages/x-date-pickers-pro/src/DateRangeCalendar/DateRangeCalendar.tsx b/packages/x-date-pickers-pro/src/DateRangeCalendar/DateRangeCalendar.tsx
index 004a70c8c793..220518399165 100644
--- a/packages/x-date-pickers-pro/src/DateRangeCalendar/DateRangeCalendar.tsx
+++ b/packages/x-date-pickers-pro/src/DateRangeCalendar/DateRangeCalendar.tsx
@@ -646,6 +646,7 @@ DateRangeCalendar.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value={[null, null]}`.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers-pro/src/DateRangeCalendar/DateRangeCalendar.types.ts b/packages/x-date-pickers-pro/src/DateRangeCalendar/DateRangeCalendar.types.ts
index 7c844f1f3d9c..97c0fd6fc83d 100644
--- a/packages/x-date-pickers-pro/src/DateRangeCalendar/DateRangeCalendar.types.ts
+++ b/packages/x-date-pickers-pro/src/DateRangeCalendar/DateRangeCalendar.types.ts
@@ -64,6 +64,7 @@ export interface ExportedDateRangeCalendarProps
disableAutoMonthSwitching?: boolean;
/**
* Default calendar month displayed when `value={[null, null]}`.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth?: TDate;
/**
diff --git a/packages/x-date-pickers-pro/src/DateRangePicker/DateRangePicker.tsx b/packages/x-date-pickers-pro/src/DateRangePicker/DateRangePicker.tsx
index 98a9516452f2..da429fe2e71b 100644
--- a/packages/x-date-pickers-pro/src/DateRangePicker/DateRangePicker.tsx
+++ b/packages/x-date-pickers-pro/src/DateRangePicker/DateRangePicker.tsx
@@ -92,6 +92,7 @@ DateRangePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value={[null, null]}`.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers-pro/src/DesktopDateRangePicker/DesktopDateRangePicker.tsx b/packages/x-date-pickers-pro/src/DesktopDateRangePicker/DesktopDateRangePicker.tsx
index 71b7d1bf23d6..78f10157102e 100644
--- a/packages/x-date-pickers-pro/src/DesktopDateRangePicker/DesktopDateRangePicker.tsx
+++ b/packages/x-date-pickers-pro/src/DesktopDateRangePicker/DesktopDateRangePicker.tsx
@@ -128,6 +128,7 @@ DesktopDateRangePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value={[null, null]}`.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers-pro/src/MobileDateRangePicker/MobileDateRangePicker.tsx b/packages/x-date-pickers-pro/src/MobileDateRangePicker/MobileDateRangePicker.tsx
index 78b00738aece..6e5faaefa3e4 100644
--- a/packages/x-date-pickers-pro/src/MobileDateRangePicker/MobileDateRangePicker.tsx
+++ b/packages/x-date-pickers-pro/src/MobileDateRangePicker/MobileDateRangePicker.tsx
@@ -128,6 +128,7 @@ MobileDateRangePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value={[null, null]}`.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers-pro/src/StaticDateRangePicker/StaticDateRangePicker.tsx b/packages/x-date-pickers-pro/src/StaticDateRangePicker/StaticDateRangePicker.tsx
index 38ef0c3cb8e9..d0518f0e8afa 100644
--- a/packages/x-date-pickers-pro/src/StaticDateRangePicker/StaticDateRangePicker.tsx
+++ b/packages/x-date-pickers-pro/src/StaticDateRangePicker/StaticDateRangePicker.tsx
@@ -115,6 +115,7 @@ StaticDateRangePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value={[null, null]}`.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers/src/DateCalendar/DateCalendar.tsx b/packages/x-date-pickers/src/DateCalendar/DateCalendar.tsx
index f78b9323b094..15142006766e 100644
--- a/packages/x-date-pickers/src/DateCalendar/DateCalendar.tsx
+++ b/packages/x-date-pickers/src/DateCalendar/DateCalendar.tsx
@@ -442,6 +442,7 @@ DateCalendar.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value` and `defaultValue` are empty.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers/src/DateCalendar/DateCalendar.types.ts b/packages/x-date-pickers/src/DateCalendar/DateCalendar.types.ts
index a9e09563256a..177bc8beb3f8 100644
--- a/packages/x-date-pickers/src/DateCalendar/DateCalendar.types.ts
+++ b/packages/x-date-pickers/src/DateCalendar/DateCalendar.types.ts
@@ -56,6 +56,7 @@ export interface ExportedDateCalendarProps
TimezoneProps {
/**
* Default calendar month displayed when `value` and `defaultValue` are empty.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth?: TDate;
/**
diff --git a/packages/x-date-pickers/src/DatePicker/DatePicker.tsx b/packages/x-date-pickers/src/DatePicker/DatePicker.tsx
index e7ecf9b33909..a11f5166b7a8 100644
--- a/packages/x-date-pickers/src/DatePicker/DatePicker.tsx
+++ b/packages/x-date-pickers/src/DatePicker/DatePicker.tsx
@@ -83,6 +83,7 @@ DatePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value` and `defaultValue` are empty.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers/src/DateTimePicker/DateTimePicker.tsx b/packages/x-date-pickers/src/DateTimePicker/DateTimePicker.tsx
index 131468ff2e52..321fb340ecfa 100644
--- a/packages/x-date-pickers/src/DateTimePicker/DateTimePicker.tsx
+++ b/packages/x-date-pickers/src/DateTimePicker/DateTimePicker.tsx
@@ -93,6 +93,7 @@ DateTimePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value` and `defaultValue` are empty.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers/src/DesktopDatePicker/DesktopDatePicker.tsx b/packages/x-date-pickers/src/DesktopDatePicker/DesktopDatePicker.tsx
index ed6c37e21afa..79a11eac7339 100644
--- a/packages/x-date-pickers/src/DesktopDatePicker/DesktopDatePicker.tsx
+++ b/packages/x-date-pickers/src/DesktopDatePicker/DesktopDatePicker.tsx
@@ -129,6 +129,7 @@ DesktopDatePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value` and `defaultValue` are empty.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers/src/DesktopDateTimePicker/DesktopDateTimePicker.tsx b/packages/x-date-pickers/src/DesktopDateTimePicker/DesktopDateTimePicker.tsx
index ea8c1f1a9c59..7feeb0a9852b 100644
--- a/packages/x-date-pickers/src/DesktopDateTimePicker/DesktopDateTimePicker.tsx
+++ b/packages/x-date-pickers/src/DesktopDateTimePicker/DesktopDateTimePicker.tsx
@@ -189,6 +189,7 @@ DesktopDateTimePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value` and `defaultValue` are empty.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers/src/MobileDatePicker/MobileDatePicker.tsx b/packages/x-date-pickers/src/MobileDatePicker/MobileDatePicker.tsx
index a60c2b0a1f99..3cccd211991c 100644
--- a/packages/x-date-pickers/src/MobileDatePicker/MobileDatePicker.tsx
+++ b/packages/x-date-pickers/src/MobileDatePicker/MobileDatePicker.tsx
@@ -125,6 +125,7 @@ MobileDatePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value` and `defaultValue` are empty.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers/src/MobileDateTimePicker/MobileDateTimePicker.tsx b/packages/x-date-pickers/src/MobileDateTimePicker/MobileDateTimePicker.tsx
index 1a01ec66ec16..42e761d394cc 100644
--- a/packages/x-date-pickers/src/MobileDateTimePicker/MobileDateTimePicker.tsx
+++ b/packages/x-date-pickers/src/MobileDateTimePicker/MobileDateTimePicker.tsx
@@ -149,6 +149,7 @@ MobileDateTimePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value` and `defaultValue` are empty.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers/src/StaticDatePicker/StaticDatePicker.tsx b/packages/x-date-pickers/src/StaticDatePicker/StaticDatePicker.tsx
index a84e4f54acd0..3c7aca7a6885 100644
--- a/packages/x-date-pickers/src/StaticDatePicker/StaticDatePicker.tsx
+++ b/packages/x-date-pickers/src/StaticDatePicker/StaticDatePicker.tsx
@@ -105,6 +105,7 @@ StaticDatePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value` and `defaultValue` are empty.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**
diff --git a/packages/x-date-pickers/src/StaticDateTimePicker/StaticDateTimePicker.tsx b/packages/x-date-pickers/src/StaticDateTimePicker/StaticDateTimePicker.tsx
index 975bd7430bae..f759763435c1 100644
--- a/packages/x-date-pickers/src/StaticDateTimePicker/StaticDateTimePicker.tsx
+++ b/packages/x-date-pickers/src/StaticDateTimePicker/StaticDateTimePicker.tsx
@@ -127,6 +127,7 @@ StaticDateTimePicker.propTypes = {
dayOfWeekFormatter: PropTypes.func,
/**
* Default calendar month displayed when `value` and `defaultValue` are empty.
+ * @deprecated Consider using `referenceDate` instead.
*/
defaultCalendarMonth: PropTypes.any,
/**