@mui/x-date-pickers 6.18.1 → 7.0.0-alpha.1

package/models/adapters.d.ts

@@ -61,12 +61,6 @@ export interface AdapterFormats {
      * @example "Jan 1, 2019"
      */
     fullDate: string;
-    /**
-     * The partially localized full date with weekday, useful for text-to-speech accessibility.
-     * @example "Tuesday, January 1, 2019"
-     * @deprecated Never used internally.
-     */
-    fullDateWithWeekday: string;
     /**
      * A keyboard input friendly date format.
      * Used in the date fields.
@@ -91,18 +85,6 @@ export interface AdapterFormats {
      * @example "Sun, Jan 1"
      */
     normalDateWithWeekday: string;
-    /**
-     * The month name and the 4-digit year.
-     * @example "January 2018"
-     * @deprecated Use `${adapter.formats.month} ${adapter.formats.year}`
-     */
-    monthAndYear: string;
-    /**
-     * The month name and the day of the month.
-     * @example "January 1"
-     * @deprecated Use `${adapter.formats.month} ${adapter.formats.dayOfMonth}`
-     */
-    monthAndDate: string;
     /**
      * The hours and the minutes.
      * Used for the aria-label of the opening button of the `TimePicker`.
@@ -119,24 +101,6 @@ export interface AdapterFormats {
      * @example "23:44"
      */
     fullTime24h: string;
-    /**
-     * The combination of `fullDate` and `fullTime` formats.
-     * @example "Jan 1, 2018 11:44 PM"
-     * @deprecated Use `${adapter.formats.fullDate} ${adapter.formats.fullTime}`
-     */
-    fullDateTime: string;
-    /**
-     * The combination of `fullDate` and `fullTime12h` formats.
-     * @example "Jan 1, 2018 11:44 PM"
-     * @deprecated Use `${adapter.formats.fullDate} ${adapter.formats.fullTime12h}`
-     */
-    fullDateTime12h: string;
-    /**
-     * The combination of `fullDate` and `fullTime24h` formats.
-     * @example "Jan 1, 2018 23:44"
-     * @deprecated Use `${adapter.formats.fullDate} ${adapter.formats.fullTime24h}`
-     */
-    fullDateTime24h: string;
     /**
      * A keyboard input friendly time format.
      * Used in the date-time fields.
@@ -156,7 +120,6 @@ export interface AdapterFormats {
      */
     keyboardDateTime24h: string;
 }
-export type AdapterUnits = 'years' | 'quarters' | 'months' | 'weeks' | 'days' | 'hours' | 'minutes' | 'seconds' | 'milliseconds';
 export type FieldFormatTokenMap = {
     [formatToken: string]: FieldSectionType | {
         sectionType: FieldSectionType;
@@ -235,22 +198,6 @@ export interface MuiPickersAdapter<TDate, TLocale = any> {
      * @returns {Date} the JavaScript date.
      */
     toJsDate(value: TDate): Date;
-    /**
-     * Parse an iso string into a date in the date library format.
-     * @deprecate Will be removed in v7.
-     * @template TDate
-     * @param {string} isoString The iso string to parse.
-     * @returns {TDate} the parsed date.
-     */
-    parseISO(isoString: string): TDate;
-    /**
-     * Stringify a date in the date library format into an ISO string.
-     * @deprecate Will be removed in v7.
-     * @template TDate
-     * @param {TDate} value The date to stringify.
-     * @returns {string} the iso string representing the date.
-     */
-    toISO(value: TDate): string;
     /**
      * Parse a string date in a specific format.
      * @template TDate
@@ -275,27 +222,12 @@ export interface MuiPickersAdapter<TDate, TLocale = any> {
      * @returns {string} The expanded format.
      */
     expandFormat(format: string): string;
-    /**
-     * Create a user readable format (taking into account localized format tokens), useful to render helper text for input (e.g. placeholder).
-     * @deprecated  Will be removed in v7.
-     * @param {string} format The format to analyze.
-     * @returns {string} The helper text of the given format.
-     */
-    getFormatHelperText(format: string): string;
-    /**
-     * Check if the date is null.
-     * @deprecated  Will be removed in v7.
-     * @template TDate
-     * @param {TDate | null} value The date to test.
-     * @returns {boolean} `true` if the date is null.
-     */
-    isNull(value: TDate | null): boolean;
     /**
      * Check if the date is valid.
-     * @param {any} value The value to test.
-     * @returns {boolean} `true` if the value is valid.
+     * @param {TDate | null} value The value to test.
+     * @returns {boolean} `true` if the value is a valid date according to the date library.
      */
-    isValid(value: any): boolean;
+    isValid(value: TDate | null): boolean;
     /**
      * Format a date using an adapter format string (see the `AdapterFormats` interface)
      * @template TDate
@@ -319,23 +251,13 @@ export interface MuiPickersAdapter<TDate, TLocale = any> {
      * @returns {string} The formatted number.
      */
     formatNumber(numberToFormat: string): string;
-    /**
-     * Compute the difference between the two dates in the unit provided.
-     * @deprecated  Will be removed in v7.
-     * @template TDate
-     * @param {TDate} value The reference date.
-     * @param {TDate | string} comparing The date to compare with the reference date.
-     * @param {AdapterUnits} unit The unit in which we want to the result to be.
-     * @returns {number} The diff between the two dates.
-     */
-    getDiff(value: TDate, comparing: TDate | string, unit?: AdapterUnits): number;
     /**
      * Check if the two dates are equal (e.g: they represent the same timestamp).
-     * @param {any} value The reference date.
-     * @param {any} comparing The date to compare with the reference date.
+     * @param {TDate | null} value The reference date.
+     * @param {TDate | null} comparing The date to compare with the reference date.
      * @returns {boolean} `true` if the two dates are equal.
      */
-    isEqual(value: any, comparing: any): boolean;
+    isEqual(value: TDate | null, comparing: TDate | null): boolean;
     /**
      * Check if the two dates are in the same year (using the timezone of the reference date).
      * @template TDate
@@ -417,7 +339,7 @@ export interface MuiPickersAdapter<TDate, TLocale = any> {
      */
     isBeforeDay(value: TDate, comparing: TDate): boolean;
     /**
-     * Check if the value is withing the provided range.
+     * Check if the value is within the provided range.
      * @template TDate
      * @param {TDate} value The value to test.
      * @param {[TDate, TDate]} range The range in which the value should be.
@@ -649,45 +571,6 @@ export interface MuiPickersAdapter<TDate, TLocale = any> {
      * @returns {number} The number of days in the month
      */
     getDaysInMonth(value: TDate): number;
-    /**
-     * Add one month to the given date.
-     * @deprecated Use `addMonths(value, 1)`
-     * @template TDate
-     * @param {TDate} value The given date.
-     * @returns {TDate} The new date with one month added.
-     */
-    getNextMonth(value: TDate): TDate;
-    /**
-     * Subtract one month from the given date.
-     * @deprecated Use `addMonths(value, -1)`
-     * @template TDate
-     * @param {TDate} value The given date.
-     * @returns {TDate} The new date with one month subtracted.
-     */
-    getPreviousMonth(value: TDate): TDate;
-    /**
-     * Get an array with all the months in the year of the given date.
-     * @deprecated Will be removed in v7.
-     * @template TDate
-     * @param {TDate} value The given date.
-     * @returns {TDate[]} All the months in the year of the given date.
-     */
-    getMonthArray(value: TDate): TDate[];
-    /**
-     * Create a date with the date of the first param and the time of the second param.
-     * @deprecated Use `adapter.setHours`, `adapter.setMinutes` and `adapter.setSeconds`.
-     * @template TDate
-     * @param {TDate} dateParam Param from which we want to get the date.
-     * @param {TDate} timeParam Param from which we want to get the time.
-     * @returns Date with the date of the first param and the time of the second param.
-     */
-    mergeDateAndTime(dateParam: TDate, timeParam: TDate): TDate;
-    /**
-     * Get the label of each day of a week.
-     * @deprecated Will be removed in v7. Use `getWeekdays` from date-utils and format the dates.
-     * @returns {string[]} The label of each day of a week.
-     */
-    getWeekdays(): string[];
     /**
      * Create a nested list with all the days of the month of the given date grouped by week.
      * @template TDate
@@ -703,19 +586,11 @@ export interface MuiPickersAdapter<TDate, TLocale = any> {
      */
     getWeekNumber(value: TDate): number;
     /**
-     * Create a list with all the years between the start end the end date.
+     * Create a list with all the years between the start and the end date.
      * @template TDate
-     * @param {TDate} start The start of the range.
-     * @param {TDate} end The end of the range.
+     * @param {[TDate, TDate]} range The range of year to create.
      * @returns {TDate[]} List of all the years between the start end the end date.
      */
-    getYearRange(start: TDate, end: TDate): TDate[];
-    /**
-     * Allow to customize how the "am"` and "pm" strings are rendered.
-     * @deprecated Use `utils.format(utils.setHours(utils.date()!, meridiem === 'am' ? 2 : 14), 'meridiem')` instead.
-     * @param {"am" | "pm"} meridiem The string to render.
-     * @return {string} The formatted string.
-     */
-    getMeridiemText(meridiem: 'am' | 'pm'): string;
+    getYearRange(range: [TDate, TDate]): TDate[];
 }
 export {};

package/models/fields.d.ts

@@ -32,12 +32,6 @@ export interface FieldSection {
      * Will determine if we should apply a digit-based editing or a letter-based editing.
      */
     contentType: FieldSectionContentType;
-    /**
-     * If `true`, the value of this section is supposed to have leading zeroes when parsed by the date library.
-     * For example, the value `1` should be rendered as "01" instead of "1".
-     * @deprecated Will be removed in v7, use `hasLeadingZerosInFormat` instead.
-     */
-    hasLeadingZeros: boolean;
     /**
      * If `true`, the value of this section is supposed to have leading zeroes when parsed by the date library.
      * For example, the value `1` should be rendered as "01" instead of "1".

package/modern/AdapterDateFns/AdapterDateFns.js

@@ -7,16 +7,6 @@ import addHours from 'date-fns/addHours';
 import addWeeks from 'date-fns/addWeeks';
 import addMonths from 'date-fns/addMonths';
 import addYears from 'date-fns/addYears';
-import differenceInYears from 'date-fns/differenceInYears';
-import differenceInQuarters from 'date-fns/differenceInQuarters';
-import differenceInMonths from 'date-fns/differenceInMonths';
-import differenceInWeeks from 'date-fns/differenceInWeeks';
-import differenceInDays from 'date-fns/differenceInDays';
-import differenceInHours from 'date-fns/differenceInHours';
-import differenceInMinutes from 'date-fns/differenceInMinutes';
-import differenceInSeconds from 'date-fns/differenceInSeconds';
-import differenceInMilliseconds from 'date-fns/differenceInMilliseconds';
-import eachDayOfInterval from 'date-fns/eachDayOfInterval';
 import endOfDay from 'date-fns/endOfDay';
 import endOfWeek from 'date-fns/endOfWeek';
 import endOfYear from 'date-fns/endOfYear';
@@ -51,8 +41,6 @@ import startOfMonth from 'date-fns/startOfMonth';
 import endOfMonth from 'date-fns/endOfMonth';
 import startOfWeek from 'date-fns/startOfWeek';
 import startOfYear from 'date-fns/startOfYear';
-import parseISO from 'date-fns/parseISO';
-import formatISO from 'date-fns/formatISO';
 import isWithinInterval from 'date-fns/isWithinInterval';
 import defaultLocale from 'date-fns/locale/en-US';
 // @ts-ignore
@@ -235,19 +223,13 @@ const defaultFormats = {
   minutes: 'mm',
   seconds: 'ss',
   fullDate: 'PP',
-  fullDateWithWeekday: 'PPPP',
   keyboardDate: 'P',
   shortDate: 'MMM d',
   normalDate: 'd MMMM',
   normalDateWithWeekday: 'EEE, MMM d',
-  monthAndYear: 'LLLL yyyy',
-  monthAndDate: 'MMMM d',
   fullTime: 'p',
   fullTime12h: 'hh:mm aa',
   fullTime24h: 'HH:mm',
-  fullDateTime: 'PP p',
-  fullDateTime12h: 'PP hh:mm aa',
-  fullDateTime24h: 'PP HH:mm',
   keyboardDateTime: 'P p',
   keyboardDateTime12h: 'P hh:mm aa',
   keyboardDateTime24h: 'P HH:mm'
@@ -314,14 +296,6 @@ export class AdapterDateFns {
     this.toJsDate = value => {
       return value;
     };
-    this.parseISO = isoString => {
-      return parseISO(isoString);
-    };
-    this.toISO = value => {
-      return formatISO(value, {
-        format: 'extended'
-      });
-    };
     this.parse = (value, format) => {
       if (value === '') {
         return null;
@@ -357,14 +331,11 @@ export class AdapterDateFns {
         return token;
       }).join('');
     };
-    this.getFormatHelperText = format => {
-      return this.expandFormat(format).replace(/(aaa|aa|a)/g, '(a|p)m').toLocaleLowerCase();
-    };
-    this.isNull = value => {
-      return value === null;
-    };
     this.isValid = value => {
-      return isValid(this.date(value));
+      if (value == null) {
+        return false;
+      }
+      return isValid(value);
     };
     this.format = (value, formatKey) => {
       return this.formatByString(value, this.formats[formatKey]);
@@ -377,34 +348,13 @@ export class AdapterDateFns {
     this.formatNumber = numberToFormat => {
       return numberToFormat;
     };
-    this.getDiff = (value, comparing, unit) => {
-      switch (unit) {
-        case 'years':
-          return differenceInYears(value, this.date(comparing));
-        case 'quarters':
-          return differenceInQuarters(value, this.date(comparing));
-        case 'months':
-          return differenceInMonths(value, this.date(comparing));
-        case 'weeks':
-          return differenceInWeeks(value, this.date(comparing));
-        case 'days':
-          return differenceInDays(value, this.date(comparing));
-        case 'hours':
-          return differenceInHours(value, this.date(comparing));
-        case 'minutes':
-          return differenceInMinutes(value, this.date(comparing));
-        case 'seconds':
-          return differenceInSeconds(value, this.date(comparing));
-        default:
-          {
-            return differenceInMilliseconds(value, this.date(comparing));
-          }
-      }
-    };
     this.isEqual = (value, comparing) => {
       if (value === null && comparing === null) {
         return true;
       }
+      if (value === null || comparing === null) {
+        return false;
+      }
       return isEqual(value, comparing);
     };
     this.isSameYear = (value, comparing) => {
@@ -537,35 +487,6 @@ export class AdapterDateFns {
     this.getDaysInMonth = value => {
       return getDaysInMonth(value);
     };
-    this.getNextMonth = value => {
-      return addMonths(value, 1);
-    };
-    this.getPreviousMonth = value => {
-      return addMonths(value, -1);
-    };
-    this.getMonthArray = value => {
-      const firstMonth = startOfYear(value);
-      const monthArray = [firstMonth];
-      while (monthArray.length < 12) {
-        const prevMonth = monthArray[monthArray.length - 1];
-        monthArray.push(this.getNextMonth(prevMonth));
-      }
-      return monthArray;
-    };
-    this.mergeDateAndTime = (dateParam, timeParam) => {
-      return this.setSeconds(this.setMinutes(this.setHours(dateParam, this.getHours(timeParam)), this.getMinutes(timeParam)), this.getSeconds(timeParam));
-    };
-    this.getWeekdays = () => {
-      const now = new Date();
-      return eachDayOfInterval({
-        start: startOfWeek(now, {
-          locale: this.locale
-        }),
-        end: endOfWeek(now, {
-          locale: this.locale
-        })
-      }).map(day => this.formatByString(day, 'EEEEEE'));
-    };
     this.getWeekArray = value => {
       const start = startOfWeek(startOfMonth(value), {
         locale: this.locale
@@ -590,7 +511,7 @@ export class AdapterDateFns {
         locale: this.locale
       });
     };
-    this.getYearRange = (start, end) => {
+    this.getYearRange = ([start, end]) => {
       const startDate = startOfYear(start);
       const endDate = endOfYear(end);
       const years = [];
@@ -601,9 +522,6 @@ export class AdapterDateFns {
       }
       return years;
     };
-    this.getMeridiemText = ampm => {
-      return ampm === 'am' ? 'AM' : 'PM';
-    };
     this.locale = _locale;
     this.formats = _extends({}, defaultFormats, formats);
   }

package/modern/AdapterDateFnsJalali/AdapterDateFnsJalali.js

@@ -7,21 +7,10 @@ import addDays from 'date-fns-jalali/addDays';
 import addWeeks from 'date-fns-jalali/addWeeks';
 import addMonths from 'date-fns-jalali/addMonths';
 import addYears from 'date-fns-jalali/addYears';
-import differenceInYears from 'date-fns-jalali/differenceInYears';
-import differenceInQuarters from 'date-fns-jalali/differenceInQuarters';
-import differenceInMonths from 'date-fns-jalali/differenceInMonths';
-import differenceInWeeks from 'date-fns-jalali/differenceInWeeks';
-import differenceInDays from 'date-fns-jalali/differenceInDays';
-import differenceInHours from 'date-fns-jalali/differenceInHours';
-import differenceInMinutes from 'date-fns-jalali/differenceInMinutes';
-import differenceInSeconds from 'date-fns-jalali/differenceInSeconds';
-import differenceInMilliseconds from 'date-fns-jalali/differenceInMilliseconds';
-import eachDayOfInterval from 'date-fns-jalali/eachDayOfInterval';
 import endOfDay from 'date-fns-jalali/endOfDay';
 import endOfWeek from 'date-fns-jalali/endOfWeek';
 import endOfYear from 'date-fns-jalali/endOfYear';
 import dateFnsFormat from 'date-fns-jalali/format';
-import formatISO from 'date-fns-jalali/formatISO';
 import getHours from 'date-fns-jalali/getHours';
 import getSeconds from 'date-fns-jalali/getSeconds';
 import getMilliseconds from 'date-fns-jalali/getMilliseconds';
@@ -40,7 +29,6 @@ import isSameMonth from 'date-fns-jalali/isSameMonth';
 import isSameHour from 'date-fns-jalali/isSameHour';
 import isValid from 'date-fns-jalali/isValid';
 import dateFnsParse from 'date-fns-jalali/parse';
-import parseISO from 'date-fns-jalali/parseISO';
 import setDate from 'date-fns-jalali/setDate';
 import setHours from 'date-fns-jalali/setHours';
 import setMinutes from 'date-fns-jalali/setMinutes';
@@ -235,16 +223,10 @@ const defaultFormats = {
   minutes: 'mm',
   seconds: 'ss',
   fullDate: 'PPP',
-  fullDateWithWeekday: 'PPPP',
   keyboardDate: 'P',
   shortDate: 'd MMM',
   normalDate: 'd MMMM',
   normalDateWithWeekday: 'EEE, d MMMM',
-  monthAndYear: 'LLLL yyyy',
-  monthAndDate: 'd MMMM',
-  fullDateTime: 'PPP p',
-  fullDateTime12h: 'PPP hh:mm aa',
-  fullDateTime24h: 'PPP HH:mm',
   fullTime: 'p',
   fullTime12h: 'hh:mm aaa',
   fullTime24h: 'HH:mm',
@@ -326,14 +308,6 @@ export class AdapterDateFnsJalali {
     this.toJsDate = value => {
       return value;
     };
-    this.parseISO = isoString => {
-      return parseISO(isoString);
-    };
-    this.toISO = value => {
-      return formatISO(value, {
-        format: 'extended'
-      });
-    };
     this.parse = (value, format) => {
       if (value === '') {
         return null;
@@ -368,14 +342,11 @@ export class AdapterDateFnsJalali {
         return token;
       }).join('');
     };
-    this.getFormatHelperText = format => {
-      return this.expandFormat(format).replace(/(aaa|aa|a)/g, '(a|p)m').toLocaleLowerCase();
-    };
-    this.isNull = value => {
-      return value === null;
-    };
     this.isValid = value => {
-      return isValid(this.date(value));
+      if (value == null) {
+        return false;
+      }
+      return isValid(value);
     };
     this.format = (value, formatKey) => {
       return this.formatByString(value, this.formats[formatKey]);
@@ -388,34 +359,13 @@ export class AdapterDateFnsJalali {
     this.formatNumber = numberToFormat => {
       return numberToFormat.replace(/\d/g, match => NUMBER_SYMBOL_MAP[match]).replace(/,/g, '،');
     };
-    this.getDiff = (value, comparing, unit) => {
-      switch (unit) {
-        case 'years':
-          return differenceInYears(value, this.date(comparing));
-        case 'quarters':
-          return differenceInQuarters(value, this.date(comparing));
-        case 'months':
-          return differenceInMonths(value, this.date(comparing));
-        case 'weeks':
-          return differenceInWeeks(value, this.date(comparing));
-        case 'days':
-          return differenceInDays(value, this.date(comparing));
-        case 'hours':
-          return differenceInHours(value, this.date(comparing));
-        case 'minutes':
-          return differenceInMinutes(value, this.date(comparing));
-        case 'seconds':
-          return differenceInSeconds(value, this.date(comparing));
-        default:
-          {
-            return differenceInMilliseconds(value, this.date(comparing));
-          }
-      }
-    };
     this.isEqual = (value, comparing) => {
       if (value === null && comparing === null) {
         return true;
       }
+      if (value === null || comparing === null) {
+        return false;
+      }
       return isEqual(value, comparing);
     };
     this.isSameYear = (value, comparing) => {
@@ -548,35 +498,6 @@ export class AdapterDateFnsJalali {
     this.getDaysInMonth = value => {
       return getDaysInMonth(value);
     };
-    this.getNextMonth = value => {
-      return addMonths(value, 1);
-    };
-    this.getPreviousMonth = value => {
-      return addMonths(value, -1);
-    };
-    this.getMonthArray = value => {
-      const firstMonth = startOfYear(value);
-      const monthArray = [firstMonth];
-      while (monthArray.length < 12) {
-        const prevMonth = monthArray[monthArray.length - 1];
-        monthArray.push(this.getNextMonth(prevMonth));
-      }
-      return monthArray;
-    };
-    this.mergeDateAndTime = (dateParam, timeParam) => {
-      return this.setSeconds(this.setMinutes(this.setHours(dateParam, this.getHours(timeParam)), this.getMinutes(timeParam)), this.getSeconds(timeParam));
-    };
-    this.getWeekdays = () => {
-      const now = new Date();
-      return eachDayOfInterval({
-        start: startOfWeek(now, {
-          locale: this.locale
-        }),
-        end: endOfWeek(now, {
-          locale: this.locale
-        })
-      }).map(day => this.formatByString(day, 'EEEEEE'));
-    };
     this.getWeekArray = value => {
       const start = startOfWeek(startOfMonth(value), {
         locale: this.locale
@@ -601,7 +522,7 @@ export class AdapterDateFnsJalali {
         locale: this.locale
       });
     };
-    this.getYearRange = (start, end) => {
+    this.getYearRange = ([start, end]) => {
       const startDate = startOfYear(start);
       const endDate = endOfYear(end);
       const years = [];
@@ -612,9 +533,6 @@ export class AdapterDateFnsJalali {
       }
       return years;
     };
-    this.getMeridiemText = ampm => {
-      return ampm === 'am' ? 'ق.ظ' : 'ب.ظ';
-    };
     this.locale = _locale;
     this.formats = _extends({}, defaultFormats, formats);
   }