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

package/datePicker/foundation.ts

@@ -268,6 +268,18 @@ export default class DatePickerFoundation extends BaseFoundation<DatePickerAdapt
         }
     }
 
+    /**
+     * value 可能是 UTC value 也可能是 zoned value
+     * 
+     * UTC value -> 受控传入的 value
+     * 
+     * zoned value -> statue.value，保存的是当前计算机时区下选择的日期
+     * 
+     * 如果是时区变化，则需要将旧 zoned value 转为新时区下的 zoned value
+     * 
+     * 如果是 value 变化，则不需要传入之前的时区，将 UTC value 转为 zoned value 即可
+     * 
+     */
     parseWithTimezone(value: ValueType, timeZone: string | number, prevTimeZone: string | number) {
         const result: Date[] = [];
         if (Array.isArray(value) && value.length) {

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

@@ -196,6 +196,18 @@ export default class DatePickerFoundation extends BaseFoundation<DatePickerAdapt
      * If the user passes an empty value, you need to set the range input focus to rangeStart, so that the user can continue to select from the beginning after clearing
      */
     initRangeInputFocus(result: Date[]): void;
+    /**
+     * value 可能是 UTC value 也可能是 zoned value
+     *
+     * UTC value -> 受控传入的 value
+     *
+     * zoned value -> statue.value，保存的是当前计算机时区下选择的日期
+     *
+     * 如果是时区变化，则需要将旧 zoned value 转为新时区下的 zoned value
+     *
+     * 如果是 value 变化，则不需要传入之前的时区，将 UTC value 转为 zoned value 即可
+     *
+     */
     parseWithTimezone(value: ValueType, timeZone: string | number, prevTimeZone: string | number): Date[];
     _isMultiple(): boolean;
     /**

package/lib/cjs/datePicker/foundation.js

@@ -150,6 +150,19 @@ class DatePickerFoundation extends _foundation.default {
       this._adapter.setRangeInputFocus('rangeStart');
     }
   }
+  /**
+   * value 可能是 UTC value 也可能是 zoned value
+   *
+   * UTC value -> 受控传入的 value
+   *
+   * zoned value -> statue.value，保存的是当前计算机时区下选择的日期
+   *
+   * 如果是时区变化，则需要将旧 zoned value 转为新时区下的 zoned value
+   *
+   * 如果是 value 变化，则不需要传入之前的时区，将 UTC value 转为 zoned value 即可
+   *
+   */
+
 
   parseWithTimezone(value, timeZone, prevTimeZone) {
     const result = [];

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

@@ -20,32 +20,33 @@ export declare const toIANA: (tz: string | number) => any;
 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
+ * Returns a Date which will format as the local time of any time zone from a specific 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
+ * 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#zonedtimetoutc
+ * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
  */
 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
+ * Given a date and any time zone, returns a Date with the equivalent UTC time
  *
  * @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
+ * 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
+ * postToServer(utcDate.toISOString(), timeZone) // post 2014-06-25T17:00:00.000Z, America/Los_Angeles
  * ```
  *
- * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
+ * @see https://github.com/marnusw/date-fns-tz#zonedtimetoutc
  */
 declare const zonedTimeToUtc: (date: string | number | Date, timeZone: string | number, options?: OptionsWithTZ) => Date;
 /**

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

@@ -92,17 +92,18 @@ 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
+ * Returns a Date which will format as the local time of any time zone from a specific 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
+ * 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#zonedtimetoutc
+ * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
  */
 
 
@@ -110,18 +111,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
+ * Given a date and any time zone, returns a Date with the equivalent UTC time
  *
  * @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
+ * 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
+ * postToServer(utcDate.toISOString(), timeZone) // post 2014-06-25T17:00:00.000Z, America/Los_Angeles
  * ```
  *
- * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
+ * @see https://github.com/marnusw/date-fns-tz#zonedtimetoutc
  */
 
 

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

@@ -196,6 +196,18 @@ export default class DatePickerFoundation extends BaseFoundation<DatePickerAdapt
      * If the user passes an empty value, you need to set the range input focus to rangeStart, so that the user can continue to select from the beginning after clearing
      */
     initRangeInputFocus(result: Date[]): void;
+    /**
+     * value 可能是 UTC value 也可能是 zoned value
+     *
+     * UTC value -> 受控传入的 value
+     *
+     * zoned value -> statue.value，保存的是当前计算机时区下选择的日期
+     *
+     * 如果是时区变化，则需要将旧 zoned value 转为新时区下的 zoned value
+     *
+     * 如果是 value 变化，则不需要传入之前的时区，将 UTC value 转为 zoned value 即可
+     *
+     */
     parseWithTimezone(value: ValueType, timeZone: string | number, prevTimeZone: string | number): Date[];
     _isMultiple(): boolean;
     /**

package/lib/es/datePicker/foundation.js

@@ -125,6 +125,19 @@ export default class DatePickerFoundation extends BaseFoundation {
       this._adapter.setRangeInputFocus('rangeStart');
     }
   }
+  /**
+   * value 可能是 UTC value 也可能是 zoned value
+   *
+   * UTC value -> 受控传入的 value
+   *
+   * zoned value -> statue.value，保存的是当前计算机时区下选择的日期
+   *
+   * 如果是时区变化，则需要将旧 zoned value 转为新时区下的 zoned value
+   *
+   * 如果是 value 变化，则不需要传入之前的时区，将 UTC value 转为 zoned value 即可
+   *
+   */
+
 
   parseWithTimezone(value, timeZone, prevTimeZone) {
     const result = [];

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

@@ -20,32 +20,33 @@ export declare const toIANA: (tz: string | number) => any;
 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
+ * Returns a Date which will format as the local time of any time zone from a specific 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
+ * 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#zonedtimetoutc
+ * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
  */
 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
+ * Given a date and any time zone, returns a Date with the equivalent UTC time
  *
  * @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
+ * 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
+ * postToServer(utcDate.toISOString(), timeZone) // post 2014-06-25T17:00:00.000Z, America/Los_Angeles
  * ```
  *
- * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
+ * @see https://github.com/marnusw/date-fns-tz#zonedtimetoutc
  */
 declare const zonedTimeToUtc: (date: string | number | Date, timeZone: string | number, options?: OptionsWithTZ) => Date;
 /**

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

@@ -77,34 +77,35 @@ 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
+ * Returns a Date which will format as the local time of any time zone from a specific 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
+ * 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#zonedtimetoutc
+ * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
  */
 
 
 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
+ * Given a date and any time zone, returns a Date with the equivalent UTC time
  *
  * @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
+ * 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
+ * postToServer(utcDate.toISOString(), timeZone) // post 2014-06-25T17:00:00.000Z, America/Los_Angeles
  * ```
  *
- * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
+ * @see https://github.com/marnusw/date-fns-tz#zonedtimetoutc
  */
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@douyinfe/semi-foundation",
-    "version": "2.31.3-alpha.1",
+    "version": "2.31.4",
     "description": "",
     "scripts": {
         "build:lib": "node ./scripts/compileLib.js",
@@ -23,7 +23,7 @@
         "*.scss",
         "*.css"
     ],
-    "gitHead": "245df62669b489032329e4da301a5fdcabe11ecd",
+    "gitHead": "4db0a16b9639b0dc03799969f94d36d37d41c297",
     "devDependencies": {
         "@babel/plugin-transform-runtime": "^7.15.8",
         "@babel/preset-env": "^7.15.8",

package/utils/date-fns-extra.ts

@@ -113,33 +113,34 @@ const format = (date: number | Date, formatToken: string, options?: any) => {
 };
 
 /**
- * Given a date and any time zone, returns a Date with the equivalent UTC time
+ * Returns a Date which will format as the local time of any time zone from a specific 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
+ * 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#zonedtimetoutc
+ * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
  */
 const utcToZonedTime = (date: string | number | Date, timeZone: string | number, options?: OptionsWithTZ) => dateFnsUtcToZonedTime(date, toIANA(timeZone), options);
 
 /**
- * Get a date/time representing local time in a given time zone from the UTC date
+ * Given a date and any time zone, returns a Date with the equivalent UTC time
  * 
  * @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
+ * 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
+ * postToServer(utcDate.toISOString(), timeZone) // post 2014-06-25T17:00:00.000Z, America/Los_Angeles
  * ```
  * 
- * @see https://github.com/marnusw/date-fns-tz#utctozonedtime
+ * @see https://github.com/marnusw/date-fns-tz#zonedtimetoutc
  */
 const zonedTimeToUtc = (date: string | number | Date, timeZone: string | number, options?: OptionsWithTZ) => dateFnsZonedTimeToUtc(date, toIANA(timeZone), options);