mui · flaviendelangle · Nov 22, 2023 · Nov 22, 2023
diff --git 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 <code>referenceDate</code> 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
@@ -27,7 +27,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> 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
@@ -30,7 +30,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> instead."
+    },
     "defaultRangePosition": {
       "type": { "name": "enum", "description": "'end'<br>&#124;&nbsp;'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
@@ -35,7 +35,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> instead."
+    },
     "defaultRangePosition": {
       "type": { "name": "enum", "description": "'end'<br>&#124;&nbsp;'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
@@ -29,7 +29,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> 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
@@ -27,7 +27,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> 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
@@ -35,7 +35,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> instead."
+    },
     "defaultRangePosition": {
       "type": { "name": "enum", "description": "'end'<br>&#124;&nbsp;'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
@@ -29,7 +29,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> 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
@@ -27,7 +27,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> 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
@@ -35,7 +35,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> instead."
+    },
     "defaultRangePosition": {
       "type": { "name": "enum", "description": "'end'<br>&#124;&nbsp;'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
@@ -29,7 +29,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> 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
@@ -23,7 +23,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> 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
@@ -31,7 +31,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> instead."
+    },
     "defaultRangePosition": {
       "type": { "name": "enum", "description": "'end'<br>&#124;&nbsp;'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
@@ -25,7 +25,11 @@
         "returned": "string"
       }
     },
-    "defaultCalendarMonth": { "type": { "name": "any" } },
+    "defaultCalendarMonth": {
+      "type": { "name": "any" },
+      "deprecated": true,
+      "deprecationInfo": "Consider using <code>referenceDate</code> 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
@@ -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
@@ -64,6 +64,7 @@ export interface ExportedDateRangeCalendarProps<TDate>
   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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -56,6 +56,7 @@ export interface ExportedDateCalendarProps<TDate>
     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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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,
   /**