@douyinfe/semi-foundation 2.31.2 → 2.31.3-alpha.1

package/datePicker/_utils/isValidTimeZone.ts

@@ -0,0 +1,3 @@
+export default function isValidTimeZone(timeZone?: string | number) {
+    return ['string', 'number'].includes(typeof timeZone) && timeZone !== '';
+}

package/datePicker/foundation.ts

@@ -19,6 +19,7 @@ import type { ArrayElement, Motion } from '../utils/type';
 import type { Type, DateInputFoundationProps, InsetInputValue } from './inputFoundation';
 import type { MonthsGridFoundationProps } from './monthsGridFoundation';
 import type { WeekStartNumber } from './_utils/getMonthTable';
+import isValidTimeZone from './_utils/isValidTimeZone';
 
 export type ValidateStatus = ArrayElement<typeof strings.STATUS>;
 export type InputSize = ArrayElement<typeof strings.SIZE_SET>;
@@ -238,13 +239,6 @@ export default class DatePickerFoundation extends BaseFoundation<DatePickerAdapt
         this.initPanelOpenStatus(this.getProp('defaultOpen'));
     }
 
-    isValidTimeZone(timeZone?: string | number) {
-        const propTimeZone = this.getProp('timeZone');
-        const _timeZone = isNullOrUndefined(timeZone) ? propTimeZone : timeZone;
-
-        return ['string', 'number'].includes(typeof _timeZone) && _timeZone !== '';
-    }
-
     initFromProps({ value, timeZone, prevTimeZone }: Pick<DatePickerFoundationProps, 'value' | 'timeZone'> & { prevTimeZone?: string | number }) {
         const _value = (Array.isArray(value) ? [...value] : (value || value === 0) && [value]) || [];
 
@@ -280,11 +274,10 @@ export default class DatePickerFoundation extends BaseFoundation<DatePickerAdapt
             for (const v of value) {
                 let parsedV = (v || v === 0) && this._parseValue(v);
                 if (parsedV) {
-                    if (this.isValidTimeZone(prevTimeZone)) {
-                        parsedV = zonedTimeToUtc(parsedV, prevTimeZone as string);
+                    if (isValidTimeZone(prevTimeZone)) {
+                        parsedV = zonedTimeToUtc(parsedV, prevTimeZone);
                     }
-
-                    result.push(this.isValidTimeZone(timeZone) ? utcToZonedTime(parsedV, timeZone as string) : parsedV);
+                    result.push(isValidTimeZone(timeZone) ? utcToZonedTime(parsedV, timeZone) : parsedV);
                 }
             }
         }
@@ -1098,9 +1091,9 @@ export default class DatePickerFoundation extends BaseFoundation<DatePickerAdapt
      */
     disposeCallbackArgs(value: Date | Date[]) {
         let _value = Array.isArray(value) ? value : (value && [value]) || [];
+        const timeZone = this.getProp('timeZone');
 
-        if (this.isValidTimeZone()) {
-            const timeZone = this.getProp('timeZone');
+        if (isValidTimeZone(timeZone)) {
             _value = _value.map(date => zonedTimeToUtc(date, timeZone));
         }
         const type = this.getProp('type');

package/datePicker/monthsGridFoundation.ts

@@ -23,6 +23,7 @@ import isNullOrUndefined from '../utils/isNullOrUndefined';
 import { BaseValueType, DateInputFoundationProps, PresetPosition, ValueType } from './foundation';
 import { MonthDayInfo } from './monthFoundation';
 import { ArrayElement } from '../utils/type';
+import isValidTimeZone from './_utils/isValidTimeZone';
 
 const dateDiffFns = {
     month: differenceInCalendarMonths,
@@ -448,13 +449,6 @@ export default class MonthsGridFoundation extends BaseFoundation<MonthsGridAdapt
         return format(date, token, { locale: dateFnsLocale });
     }
 
-    isValidTimeZone(timeZone?: string | number) {
-        const propTimeZone = this.getProp('timeZone');
-        const _timeZone = isNullOrUndefined(timeZone) ? propTimeZone : timeZone;
-
-        return ['string', 'number'].includes(typeof _timeZone) && _timeZone !== '';
-    }
-
     /**
      * 根据 type 处理 onChange 返回的参数
      *
@@ -484,9 +478,9 @@ export default class MonthsGridFoundation extends BaseFoundation<MonthsGridAdapt
      */
     disposeCallbackArgs(value: Date | Date[]) {
         let _value = Array.isArray(value) ? value : (value && [value]) || [];
+        const timeZone = this.getProp('timeZone');
 
-        if (this.isValidTimeZone()) {
-            const timeZone = this.getProp('timeZone');
+        if (isValidTimeZone(timeZone)) {
             _value = _value.map(date => zonedTimeToUtc(date, timeZone));
         }
         const type = this.getProp('type');

package/lib/cjs/datePicker/_utils/isValidTimeZone.d.ts

@@ -0,0 +1 @@
+export default function isValidTimeZone(timeZone?: string | number): boolean;

package/lib/cjs/datePicker/_utils/isValidTimeZone.js

@@ -0,0 +1,10 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = isValidTimeZone;
+
+function isValidTimeZone(timeZone) {
+  return ['string', 'number'].includes(typeof timeZone) && timeZone !== '';
+}

package/lib/cjs/datePicker/foundation.d.ts

@@ -187,7 +187,6 @@ export interface DatePickerAdapter extends DefaultAdapter<DatePickerFoundationPr
 export default class DatePickerFoundation extends BaseFoundation<DatePickerAdapter> {
     constructor(adapter: DatePickerAdapter);
     init(): void;
-    isValidTimeZone(timeZone?: string | number): boolean;
     initFromProps({ value, timeZone, prevTimeZone }: Pick<DatePickerFoundationProps, 'value' | 'timeZone'> & {
         prevTimeZone?: string | number;
     }): void;

package/lib/cjs/datePicker/foundation.js

@@ -37,6 +37,8 @@ var _getInsetInputFormatToken = _interopRequireDefault(require("./_utils/getInse
 
 var _getInsetInputValueFromInsetInputStr = _interopRequireDefault(require("./_utils/getInsetInputValueFromInsetInputStr"));
 
+var _isValidTimeZone = _interopRequireDefault(require("./_utils/isValidTimeZone"));
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
 /* eslint-disable no-nested-ternary */
@@ -105,14 +107,6 @@ class DatePickerFoundation extends _foundation.default {
     this.initPanelOpenStatus(this.getProp('defaultOpen'));
   }
 
-  isValidTimeZone(timeZone) {
-    const propTimeZone = this.getProp('timeZone');
-
-    const _timeZone = (0, _isNullOrUndefined.default)(timeZone) ? propTimeZone : timeZone;
-
-    return ['string', 'number'].includes(typeof _timeZone) && _timeZone !== '';
-  }
-
   initFromProps(_ref) {
     let {
       value,
@@ -165,11 +159,11 @@ class DatePickerFoundation extends _foundation.default {
         let parsedV = (v || v === 0) && this._parseValue(v);
 
         if (parsedV) {
-          if (this.isValidTimeZone(prevTimeZone)) {
+          if ((0, _isValidTimeZone.default)(prevTimeZone)) {
             parsedV = (0, _dateFnsExtra.zonedTimeToUtc)(parsedV, prevTimeZone);
           }
 
-          result.push(this.isValidTimeZone(timeZone) ? (0, _dateFnsExtra.utcToZonedTime)(parsedV, timeZone) : parsedV);
+          result.push((0, _isValidTimeZone.default)(timeZone) ? (0, _dateFnsExtra.utcToZonedTime)(parsedV, timeZone) : parsedV);
         }
       }
     }
@@ -1155,8 +1149,9 @@ class DatePickerFoundation extends _foundation.default {
   disposeCallbackArgs(value) {
     let _value = Array.isArray(value) ? value : value && [value] || [];
 
-    if (this.isValidTimeZone()) {
-      const timeZone = this.getProp('timeZone');
+    const timeZone = this.getProp('timeZone');
+
+    if ((0, _isValidTimeZone.default)(timeZone)) {
       _value = _value.map(date => (0, _dateFnsExtra.zonedTimeToUtc)(date, timeZone));
     }
 

package/lib/cjs/datePicker/monthsGridFoundation.d.ts

@@ -158,7 +158,6 @@ export default class MonthsGridFoundation extends BaseFoundation<MonthsGridAdapt
      * @returns
      */
     localeFormat(date: Date, token: string): string;
-    isValidTimeZone(timeZone?: string | number): boolean;
     /**
      * 根据 type 处理 onChange 返回的参数
      *

package/lib/cjs/datePicker/monthsGridFoundation.js

@@ -27,7 +27,7 @@ var _dateFnsExtra = require("../utils/date-fns-extra");
 
 var _getDefaultFormatToken = require("./_utils/getDefaultFormatToken");
 
-var _isNullOrUndefined = _interopRequireDefault(require("../utils/isNullOrUndefined"));
+var _isValidTimeZone = _interopRequireDefault(require("./_utils/isValidTimeZone"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
@@ -438,14 +438,6 @@ class MonthsGridFoundation extends _foundation.default {
       locale: dateFnsLocale
     });
   }
-
-  isValidTimeZone(timeZone) {
-    const propTimeZone = this.getProp('timeZone');
-
-    const _timeZone = (0, _isNullOrUndefined.default)(timeZone) ? propTimeZone : timeZone;
-
-    return ['string', 'number'].includes(typeof _timeZone) && _timeZone !== '';
-  }
   /**
    * 根据 type 处理 onChange 返回的参数
    *
@@ -478,8 +470,9 @@ class MonthsGridFoundation extends _foundation.default {
   disposeCallbackArgs(value) {
     let _value = Array.isArray(value) ? value : value && [value] || [];
 
-    if (this.isValidTimeZone()) {
-      const timeZone = this.getProp('timeZone');
+    const timeZone = this.getProp('timeZone');
+
+    if ((0, _isValidTimeZone.default)(timeZone)) {
       _value = _value.map(date => (0, _dateFnsExtra.zonedTimeToUtc)(date, timeZone));
     }
 

package/lib/cjs/switch/foundation.js

@@ -36,11 +36,8 @@ class SwitchFoundation extends _foundation.default {
 
   init() {
     const {
-      defaultChecked,
-      checked,
       disabled
     } = this.getProps();
-    this.setChecked(defaultChecked || checked);
     this.setDisabled(disabled);
   }
 

package/lib/cjs/utils/date-fns-extra.d.ts

@@ -18,30 +18,36 @@ export declare const toIANA: (tz: string | number) => any;
  * @returns {Date}
  */
 declare const parse: (date: string | number | Date, formatToken: string, options?: any) => Date;
+declare const format: (date: number | Date, formatToken: string, options?: any) => string;
 /**
+ * Given a date and any time zone, returns a Date with the equivalent UTC time
  *
- * @param {string | number | Date} date
- * @param {string} formatToken
- * @param {object} [options]
- * @param {string} [options.timeZone]
- */
-declare const format: (date: string | number | Date, formatToken: string, options?: any) => string;
-/**
+ * @example
+ * ```javascript
+ * import { zonedTimeToUtc } from 'date-fns-tz'
+ * const date = getDatePickerValue() // e.g. 2014-06-25 10:00:00 (picked in any time zone
+ * const timeZone = getTimeZoneValue() // e.g. America/Los_Angeles
+ * const utcDate = zonedTimeToUtc(date, timeZone) // In June 10am in Los Angeles is 5pm UTC
+ * ```
  *
- * @param {string | number | Date} date
- * @param {string} timeZone
- * @param {object} options
- * @returns {Date}
+ * @see https://github.com/marnusw/date-fns-tz#zonedtimetoutc
  */
-declare const utcToZonedTime: (date: string | number | Date, timeZone: string, options?: OptionsWithTZ) => Date;
+declare const utcToZonedTime: (date: string | number | Date, timeZone: string | number, options?: OptionsWithTZ) => Date;
 /**
+ * Get a date/time representing local time in a given time zone from the UTC date
  *
- * @param {string | number | Date} date
- * @param {string} timeZone
- * @param {object} options
- * @returns {Date}
+ * @example
+ * ```
+ * import { utcToZonedTime } from 'date-fns-tz'
+ * const { isoDate, timeZone } = fetchInitialValues() // 2014-06-25T10:00:00.000Z, America/New_York
+ * const date = utcToZonedTime(isoDate, timeZone) // In June 10am UTC is 6am in New York (-04:00)
+ * renderDatePicker(date) // 2014-06-25 06:00:00 (in the system time zone)
+ * renderTimeZoneSelect(timeZone) // America/New_York
+ * ```
+ *
+ * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
  */
-declare const zonedTimeToUtc: (date: string | number | Date, timeZone: string, options?: OptionsWithTZ) => Date;
+declare const zonedTimeToUtc: (date: string | number | Date, timeZone: string | number, options?: OptionsWithTZ) => Date;
 /**
  * return current system hour offset based on utc:
  *

package/lib/cjs/utils/date-fns-extra.js

@@ -75,14 +75,6 @@ const parse = (date, formatToken, options) => {
 
   return (0, _dateFnsTz.toDate)(date, options);
 };
-/**
- *
- * @param {string | number | Date} date
- * @param {string} formatToken
- * @param {object} [options]
- * @param {string} [options.timeZone]
- */
-
 /* istanbul ignore next */
 
 
@@ -100,11 +92,17 @@ const format = (date, formatToken, options) => {
   return (0, _dateFnsTz.format)(date, formatToken, options);
 };
 /**
+ * Given a date and any time zone, returns a Date with the equivalent UTC time
  *
- * @param {string | number | Date} date
- * @param {string} timeZone
- * @param {object} options
- * @returns {Date}
+ * @example
+ * ```javascript
+ * import { zonedTimeToUtc } from 'date-fns-tz'
+ * const date = getDatePickerValue() // e.g. 2014-06-25 10:00:00 (picked in any time zone
+ * const timeZone = getTimeZoneValue() // e.g. America/Los_Angeles
+ * const utcDate = zonedTimeToUtc(date, timeZone) // In June 10am in Los Angeles is 5pm UTC
+ * ```
+ *
+ * @see https://github.com/marnusw/date-fns-tz#zonedtimetoutc
  */
 
 
@@ -112,11 +110,18 @@ exports.format = format;
 
 const utcToZonedTime = (date, timeZone, options) => (0, _dateFnsTz.utcToZonedTime)(date, toIANA(timeZone), options);
 /**
+ * Get a date/time representing local time in a given time zone from the UTC date
  *
- * @param {string | number | Date} date
- * @param {string} timeZone
- * @param {object} options
- * @returns {Date}
+ * @example
+ * ```
+ * import { utcToZonedTime } from 'date-fns-tz'
+ * const { isoDate, timeZone } = fetchInitialValues() // 2014-06-25T10:00:00.000Z, America/New_York
+ * const date = utcToZonedTime(isoDate, timeZone) // In June 10am UTC is 6am in New York (-04:00)
+ * renderDatePicker(date) // 2014-06-25 06:00:00 (in the system time zone)
+ * renderTimeZoneSelect(timeZone) // America/New_York
+ * ```
+ *
+ * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
  */
 
 

package/lib/es/datePicker/_utils/isValidTimeZone.d.ts

@@ -0,0 +1 @@
+export default function isValidTimeZone(timeZone?: string | number): boolean;

package/lib/es/datePicker/_utils/isValidTimeZone.js

@@ -0,0 +1,3 @@
+export default function isValidTimeZone(timeZone) {
+  return ['string', 'number'].includes(typeof timeZone) && timeZone !== '';
+}

package/lib/es/datePicker/foundation.d.ts

@@ -187,7 +187,6 @@ export interface DatePickerAdapter extends DefaultAdapter<DatePickerFoundationPr
 export default class DatePickerFoundation extends BaseFoundation<DatePickerAdapter> {
     constructor(adapter: DatePickerAdapter);
     init(): void;
-    isValidTimeZone(timeZone?: string | number): boolean;
     initFromProps({ value, timeZone, prevTimeZone }: Pick<DatePickerFoundationProps, 'value' | 'timeZone'> & {
         prevTimeZone?: string | number;
     }): void;

package/lib/es/datePicker/foundation.js

@@ -18,6 +18,7 @@ import { strings } from './constants';
 import { strings as inputStrings } from '../input/constants';
 import getInsetInputFormatToken from './_utils/getInsetInputFormatToken';
 import getInsetInputValueFromInsetInputStr from './_utils/getInsetInputValueFromInsetInputStr';
+import isValidTimeZone from './_utils/isValidTimeZone';
 /**
  * The datePicker foundation.js is responsible for maintaining the date value and the input box value, as well as the callback of both
  *  task 1. Accept the selected date change, update the date value, and update the input box value according to the date = > Notify the change
@@ -81,14 +82,6 @@ export default class DatePickerFoundation extends BaseFoundation {
     this.initPanelOpenStatus(this.getProp('defaultOpen'));
   }
 
-  isValidTimeZone(timeZone) {
-    const propTimeZone = this.getProp('timeZone');
-
-    const _timeZone = isNullOrUndefined(timeZone) ? propTimeZone : timeZone;
-
-    return ['string', 'number'].includes(typeof _timeZone) && _timeZone !== '';
-  }
-
   initFromProps(_ref) {
     let {
       value,
@@ -141,11 +134,11 @@ export default class DatePickerFoundation extends BaseFoundation {
         let parsedV = (v || v === 0) && this._parseValue(v);
 
         if (parsedV) {
-          if (this.isValidTimeZone(prevTimeZone)) {
+          if (isValidTimeZone(prevTimeZone)) {
             parsedV = zonedTimeToUtc(parsedV, prevTimeZone);
           }
 
-          result.push(this.isValidTimeZone(timeZone) ? utcToZonedTime(parsedV, timeZone) : parsedV);
+          result.push(isValidTimeZone(timeZone) ? utcToZonedTime(parsedV, timeZone) : parsedV);
         }
       }
     }
@@ -1134,8 +1127,9 @@ export default class DatePickerFoundation extends BaseFoundation {
   disposeCallbackArgs(value) {
     let _value = Array.isArray(value) ? value : value && [value] || [];
 
-    if (this.isValidTimeZone()) {
-      const timeZone = this.getProp('timeZone');
+    const timeZone = this.getProp('timeZone');
+
+    if (isValidTimeZone(timeZone)) {
       _value = _value.map(date => zonedTimeToUtc(date, timeZone));
     }
 

package/lib/es/datePicker/monthsGridFoundation.d.ts

@@ -158,7 +158,6 @@ export default class MonthsGridFoundation extends BaseFoundation<MonthsGridAdapt
      * @returns
      */
     localeFormat(date: Date, token: string): string;
-    isValidTimeZone(timeZone?: string | number): boolean;
     /**
      * 根据 type 处理 onChange 返回的参数
      *

package/lib/es/datePicker/monthsGridFoundation.js

@@ -11,7 +11,7 @@ import { formatFullDate } from './_utils/getMonthTable';
 import { compatibleParse } from './_utils/parser';
 import { zonedTimeToUtc } from '../utils/date-fns-extra';
 import { getDefaultFormatTokenByType } from './_utils/getDefaultFormatToken';
-import isNullOrUndefined from '../utils/isNullOrUndefined';
+import isValidTimeZone from './_utils/isValidTimeZone';
 const dateDiffFns = {
   month: differenceInCalendarMonths,
   year: differenceInCalendarYears
@@ -417,14 +417,6 @@ export default class MonthsGridFoundation extends BaseFoundation {
       locale: dateFnsLocale
     });
   }
-
-  isValidTimeZone(timeZone) {
-    const propTimeZone = this.getProp('timeZone');
-
-    const _timeZone = isNullOrUndefined(timeZone) ? propTimeZone : timeZone;
-
-    return ['string', 'number'].includes(typeof _timeZone) && _timeZone !== '';
-  }
   /**
    * 根据 type 处理 onChange 返回的参数
    *
@@ -457,8 +449,9 @@ export default class MonthsGridFoundation extends BaseFoundation {
   disposeCallbackArgs(value) {
     let _value = Array.isArray(value) ? value : value && [value] || [];
 
-    if (this.isValidTimeZone()) {
-      const timeZone = this.getProp('timeZone');
+    const timeZone = this.getProp('timeZone');
+
+    if (isValidTimeZone(timeZone)) {
       _value = _value.map(date => zonedTimeToUtc(date, timeZone));
     }
 

package/lib/es/switch/foundation.js

@@ -25,11 +25,8 @@ export default class SwitchFoundation extends BaseFoundation {
 
   init() {
     const {
-      defaultChecked,
-      checked,
       disabled
     } = this.getProps();
-    this.setChecked(defaultChecked || checked);
     this.setDisabled(disabled);
   }
 

package/lib/es/utils/date-fns-extra.d.ts

@@ -18,30 +18,36 @@ export declare const toIANA: (tz: string | number) => any;
  * @returns {Date}
  */
 declare const parse: (date: string | number | Date, formatToken: string, options?: any) => Date;
+declare const format: (date: number | Date, formatToken: string, options?: any) => string;
 /**
+ * Given a date and any time zone, returns a Date with the equivalent UTC time
  *
- * @param {string | number | Date} date
- * @param {string} formatToken
- * @param {object} [options]
- * @param {string} [options.timeZone]
- */
-declare const format: (date: string | number | Date, formatToken: string, options?: any) => string;
-/**
+ * @example
+ * ```javascript
+ * import { zonedTimeToUtc } from 'date-fns-tz'
+ * const date = getDatePickerValue() // e.g. 2014-06-25 10:00:00 (picked in any time zone
+ * const timeZone = getTimeZoneValue() // e.g. America/Los_Angeles
+ * const utcDate = zonedTimeToUtc(date, timeZone) // In June 10am in Los Angeles is 5pm UTC
+ * ```
  *
- * @param {string | number | Date} date
- * @param {string} timeZone
- * @param {object} options
- * @returns {Date}
+ * @see https://github.com/marnusw/date-fns-tz#zonedtimetoutc
  */
-declare const utcToZonedTime: (date: string | number | Date, timeZone: string, options?: OptionsWithTZ) => Date;
+declare const utcToZonedTime: (date: string | number | Date, timeZone: string | number, options?: OptionsWithTZ) => Date;
 /**
+ * Get a date/time representing local time in a given time zone from the UTC date
  *
- * @param {string | number | Date} date
- * @param {string} timeZone
- * @param {object} options
- * @returns {Date}
+ * @example
+ * ```
+ * import { utcToZonedTime } from 'date-fns-tz'
+ * const { isoDate, timeZone } = fetchInitialValues() // 2014-06-25T10:00:00.000Z, America/New_York
+ * const date = utcToZonedTime(isoDate, timeZone) // In June 10am UTC is 6am in New York (-04:00)
+ * renderDatePicker(date) // 2014-06-25 06:00:00 (in the system time zone)
+ * renderTimeZoneSelect(timeZone) // America/New_York
+ * ```
+ *
+ * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
  */
-declare const zonedTimeToUtc: (date: string | number | Date, timeZone: string, options?: OptionsWithTZ) => Date;
+declare const zonedTimeToUtc: (date: string | number | Date, timeZone: string | number, options?: OptionsWithTZ) => Date;
 /**
  * return current system hour offset based on utc:
  *

package/lib/es/utils/date-fns-extra.js

@@ -62,14 +62,6 @@ const parse = (date, formatToken, options) => {
 
   return toDate(date, options);
 };
-/**
- *
- * @param {string | number | Date} date
- * @param {string} formatToken
- * @param {object} [options]
- * @param {string} [options.timeZone]
- */
-
 /* istanbul ignore next */
 
 
@@ -85,21 +77,34 @@ const format = (date, formatToken, options) => {
   return dateFnsFormat(date, formatToken, options);
 };
 /**
+ * Given a date and any time zone, returns a Date with the equivalent UTC time
  *
- * @param {string | number | Date} date
- * @param {string} timeZone
- * @param {object} options
- * @returns {Date}
+ * @example
+ * ```javascript
+ * import { zonedTimeToUtc } from 'date-fns-tz'
+ * const date = getDatePickerValue() // e.g. 2014-06-25 10:00:00 (picked in any time zone
+ * const timeZone = getTimeZoneValue() // e.g. America/Los_Angeles
+ * const utcDate = zonedTimeToUtc(date, timeZone) // In June 10am in Los Angeles is 5pm UTC
+ * ```
+ *
+ * @see https://github.com/marnusw/date-fns-tz#zonedtimetoutc
  */
 
 
 const utcToZonedTime = (date, timeZone, options) => dateFnsUtcToZonedTime(date, toIANA(timeZone), options);
 /**
+ * Get a date/time representing local time in a given time zone from the UTC date
  *
- * @param {string | number | Date} date
- * @param {string} timeZone
- * @param {object} options
- * @returns {Date}
+ * @example
+ * ```
+ * import { utcToZonedTime } from 'date-fns-tz'
+ * const { isoDate, timeZone } = fetchInitialValues() // 2014-06-25T10:00:00.000Z, America/New_York
+ * const date = utcToZonedTime(isoDate, timeZone) // In June 10am UTC is 6am in New York (-04:00)
+ * renderDatePicker(date) // 2014-06-25 06:00:00 (in the system time zone)
+ * renderTimeZoneSelect(timeZone) // America/New_York
+ * ```
+ *
+ * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
  */
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@douyinfe/semi-foundation",
-    "version": "2.31.2",
+    "version": "2.31.3-alpha.1",
     "description": "",
     "scripts": {
         "build:lib": "node ./scripts/compileLib.js",
@@ -10,8 +10,8 @@
         "@douyinfe/semi-animation": "2.12.0",
         "async-validator": "^3.5.0",
         "classnames": "^2.2.6",
-        "date-fns": "^2.9.0",
-        "date-fns-tz": "^1.0.10",
+        "date-fns": "^2.29.3",
+        "date-fns-tz": "^1.3.8",
         "lodash": "^4.17.21",
         "memoize-one": "^5.2.1",
         "scroll-into-view-if-needed": "^2.2.24"
@@ -23,7 +23,7 @@
         "*.scss",
         "*.css"
     ],
-    "gitHead": "43a8fa54b5c662bad2fbb53603846b5c33f5d8da",
+    "gitHead": "245df62669b489032329e4da301a5fdcabe11ecd",
     "devDependencies": {
         "@babel/plugin-transform-runtime": "^7.15.8",
         "@babel/preset-env": "^7.15.8",

package/switch/foundation.ts

@@ -15,8 +15,7 @@ export default class SwitchFoundation<P = Record<string, any>, S = Record<string
     }
 
     init(): void {
-        const { defaultChecked, checked, disabled } = this.getProps();
-        this.setChecked(defaultChecked || checked);
+        const { disabled } = this.getProps();
         this.setDisabled(disabled);
     }
 
@@ -45,7 +44,7 @@ export default class SwitchFoundation<P = Record<string, any>, S = Record<string
             if (target.matches(':focus-visible')) {
                 this._adapter.setFocusVisible(true);
             }
-        } catch (error){
+        } catch (error) {
             warning(true, 'Warning: [Semi Switch] The current browser does not support the focus-visible');
         }
     }

package/utils/date-fns-extra.ts

@@ -100,15 +100,8 @@ const parse = (date: string | number | Date, formatToken: string, options?: any)
     return toDate(date, options);
 };
 
-/**
- *
- * @param {string | number | Date} date
- * @param {string} formatToken
- * @param {object} [options]
- * @param {string} [options.timeZone]
- */
 /* istanbul ignore next */
-const format = (date: string | number | Date, formatToken: string, options?: any) => {
+const format = (date: number | Date, formatToken: string, options?: any) => {
     if (options && options.timeZone != null && options.timeZone !== '') {
         const timeZone = toIANA(options.timeZone);
         options = { ...options, timeZone };
@@ -120,22 +113,35 @@ const format = (date: string | number | Date, formatToken: string, options?: any
 };
 
 /**
- *
- * @param {string | number | Date} date
- * @param {string} timeZone
- * @param {object} options
- * @returns {Date}
+ * Given a date and any time zone, returns a Date with the equivalent UTC time
+ * 
+ * @example
+ * ```javascript
+ * import { zonedTimeToUtc } from 'date-fns-tz'
+ * const date = getDatePickerValue() // e.g. 2014-06-25 10:00:00 (picked in any time zone
+ * const timeZone = getTimeZoneValue() // e.g. America/Los_Angeles
+ * const utcDate = zonedTimeToUtc(date, timeZone) // In June 10am in Los Angeles is 5pm UTC
+ * ```
+ * 
+ * @see https://github.com/marnusw/date-fns-tz#zonedtimetoutc
  */
-const utcToZonedTime = (date: string | number | Date, timeZone: string, options?: OptionsWithTZ) => dateFnsUtcToZonedTime(date, toIANA(timeZone), options);
+const utcToZonedTime = (date: string | number | Date, timeZone: string | number, options?: OptionsWithTZ) => dateFnsUtcToZonedTime(date, toIANA(timeZone), options);
 
 /**
- *
- * @param {string | number | Date} date
- * @param {string} timeZone
- * @param {object} options
- * @returns {Date}
+ * Get a date/time representing local time in a given time zone from the UTC date
+ * 
+ * @example
+ * ```
+ * import { utcToZonedTime } from 'date-fns-tz'
+ * const { isoDate, timeZone } = fetchInitialValues() // 2014-06-25T10:00:00.000Z, America/New_York
+ * const date = utcToZonedTime(isoDate, timeZone) // In June 10am UTC is 6am in New York (-04:00)
+ * renderDatePicker(date) // 2014-06-25 06:00:00 (in the system time zone)
+ * renderTimeZoneSelect(timeZone) // America/New_York
+ * ```
+ * 
+ * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
  */
-const zonedTimeToUtc = (date: string | number | Date, timeZone: string, options?: OptionsWithTZ) => dateFnsZonedTimeToUtc(date, toIANA(timeZone), options);
+const zonedTimeToUtc = (date: string | number | Date, timeZone: string | number, options?: OptionsWithTZ) => dateFnsZonedTimeToUtc(date, toIANA(timeZone), options);
 
 /**
  * return current system hour offset based on utc: