@zfqh/uview-x 0.0.0-stage → 0.0.1

package/utils/function.ts

@@ -0,0 +1,771 @@
+import { number, empty } from './test';
+import { round } from './digit';
+import config from './config';
+import type { UviewXColor, UviewXConfig, UviewXProps } from './config';
+import { appTranslate } from './locale';
+/**
+ * @description 如果value小于min，取min；如果value大于max，取max
+ * @param {number} min
+ * @param {number} max
+ * @param {number} value
+ */
+export function range(min: number = 0, max: number = 0, value: number = 0): number {
+  return Math.max(min, Math.min(max, Number(value)));
+}
+
+/**
+ * @description 用于获取用户传递值的px值  如果用户传递了"xxpx"或者"xxrpx"，取出其数值部分，如果是"xxxrpx"还需要用过uni.upx2px进行转换
+ * @param {number|string} value 用户传递值的px值
+ * @param {boolean} unit
+ * @returns {number|string}
+ */
+export function getPx(value: number | string, unit = false): number | string {
+  if (number(value)) {
+    return unit ? `${value}px` : Number(value);
+  }
+  // 如果带有rpx，先取出其数值部分，再转为px值
+  if (/(rpx|upx)$/.test(String(value))) {
+    return unit ? `${uni.upx2px(parseInt(String(value)))}px` : Number(uni.upx2px(parseInt(String(value))));
+  }
+  return unit ? `${parseInt(String(value))}px` : parseInt(String(value));
+}
+
+/**
+ * @description 延时执行；可传入 Promise 或返回 Promise 的函数，等待其完成且至少延时 time 毫秒
+ * 例如：await sleep(20) 将阻塞 20ms；await sleep(300, Promise.resolve('ok')) 至少 300ms 后得到 'ok'
+ * @param {number} time 延时时间 单位ms 毫秒
+ * @param {Promise|Function} fn 可选，Promise 或返回 Promise 的函数
+ * @returns {Promise} 返回 promise（未传 fn 时 resolve null）
+ */
+export function sleep<T = any>(time = 1000, fn: Promise<T> | (() => Promise<T>) | null = null): Promise<T> {
+  return new Promise<T>((resolve, reject) => {
+    const start = fn ? Date.now() : 0;
+    const settle = (settler: (value: any) => void, value: any) => {
+      const diff = fn ? Date.now() - start : 0;
+      if (diff < time) {
+        setTimeout(() => {
+          settler(value);
+        }, time - diff);
+      } else {
+        settler(value);
+      }
+    };
+    let task: Promise<T> | null = null;
+    if (typeof fn === 'function') {
+      task = fn();
+    } else {
+      task = fn;
+    }
+    if (task) {
+      task
+        .then((value) => {
+          settle(resolve, value);
+        })
+        .catch((error) => {
+          settle(reject, error);
+        });
+    } else {
+      settle(resolve, null);
+    }
+  });
+}
+/**
+ * @description 运行期判断平台
+ * @returns {string} 返回所在平台(小写)
+ * @link 运行期判断平台 https://uniapp.dcloud.io/frame?id=判断平台
+ */
+export function os(): string {
+  try {
+    const device: any = uni.getDeviceInfo();
+    return String(device?.osName || device?.platform || 'unknown').toLowerCase();
+  } catch (e) {
+    try {
+      return uni.getSystemInfoSync().platform.toLowerCase();
+    } catch (err) {
+      return 'unknown';
+    }
+  }
+}
+/**
+ * @description 获取系统信息同步接口
+ * @link 获取系统信息同步接口 https://uniapp.dcloud.io/api/system/info?id=getsysteminfosync
+ */
+export function sys(): Record<string, any> {
+  const info: any = {};
+  try {
+    if (typeof uni.getWindowInfo === 'function') {
+      Object.assign(info, uni.getWindowInfo());
+    }
+  } catch (e) {}
+  try {
+    if (typeof uni.getDeviceInfo === 'function') {
+      Object.assign(info, uni.getDeviceInfo());
+    }
+  } catch (e) {}
+  try {
+    if (typeof uni.getAppBaseInfo === 'function') {
+      Object.assign(info, uni.getAppBaseInfo());
+    }
+  } catch (e) {}
+  if (info.statusBarHeight === undefined) {
+    try {
+      Object.assign(info, uni.getSystemInfoSync());
+    } catch (e) {}
+  }
+  return info;
+}
+
+/**
+ * @description 取一个区间数
+ * @param {Number} min 最小值
+ * @param {Number} max 最大值
+ */
+export function random(min: number, max: number): number {
+  if (min >= 0 && max > 0 && max >= min) {
+    const gab = max - min + 1;
+    return Math.floor(Math.random() * gab + min);
+  }
+  return 0;
+}
+
+/**
+ * @param {Number} len uuid的长度
+ * @param {Boolean} firstU 将返回的首字母置为"u"
+ * @param {Nubmer} radix 生成uuid的基数(意味着返回的字符串都是这个基数),2-二进制,8-八进制,10-十进制,16-十六进制
+ */
+export function guid(len = 32, firstU = true, radix: number | null = null): string {
+  const chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'.split('');
+  const uuid = [];
+  radix = radix || chars.length;
+
+  if (len) {
+    // 如果指定uuid长度,只是取随机的字符,0|x为位运算,能去掉x的小数位,返回整数位
+    for (let i = 0; i < len; i++) uuid[i] = chars[0 | (Math.random() * radix)];
+  } else {
+    let r;
+    // rfc4122标准要求返回的uuid中,某些位为固定的字符
+    uuid[8] = uuid[13] = uuid[18] = uuid[23] = '-';
+    uuid[14] = '4';
+
+    for (let i = 0; i < 36; i++) {
+      if (!uuid[i]) {
+        r = 0 | (Math.random() * 16);
+        uuid[i] = chars[i == 19 ? (r & 0x3) | 0x8 : r];
+      }
+    }
+  }
+  // 移除第一个字符,并用u替代,因为第一个字符为数值时,该guuid不能用作id或者class
+  if (firstU) {
+    uuid.shift();
+    return `u${uuid.join('')}`;
+  }
+  return uuid.join('');
+}
+
+/**
+* @description 获取父组件的参数，因为支付宝小程序不支持provide/inject的写法
+   this.$parent在非H5中，可以准确获取到父组件，但是在H5中，需要多次this.$parent.$parent.xxx
+   这里默认值等于undefined有它的含义，因为最顶层元素(组件)的$parent就是undefined，意味着不传name
+   值(默认为undefined)，就是查找最顶层的$parent
+*  @param {string|undefined} name 父组件的参数名
+*/
+export function $parent(this: any, name?: string): any | false {
+  let parent = this.$parent;
+  // 通过while历遍，这里主要是为了H5需要多层解析的问题
+  while (parent) {
+    // 父组件
+    if (parent.$options && parent.$options.name !== name) {
+      // 如果组件的name不相等，继续上一级寻找
+      parent = parent.$parent;
+    } else {
+      return parent;
+    }
+  }
+  return false;
+}
+
+/**
+ * @description 样式转换
+ * 对象转字符串，或者字符串转对象
+ * @param {object | string} customStyle 需要转换的目标
+ * @param {String} target 转换的目的，object-转为对象，string-转为字符串
+ * @returns {object|string}
+ */
+export function addStyle(
+  customStyle: string | Record<string, any>,
+  target: 'object' | 'string' = 'object',
+): Record<string, any> | string {
+  // 字符串转字符串，对象转对象情形，直接返回
+  if (
+    empty(customStyle) ||
+    (typeof customStyle === 'object' && target === 'object') ||
+    (target === 'string' && typeof customStyle === 'string')
+  ) {
+    return customStyle;
+  }
+  // 字符串转对象
+  if (target === 'object') {
+    // 去除字符串样式中的两端空格(中间的空格不能去掉，比如padding: 20px 0如果去掉了就错了)，空格是无用的
+    const styleText = trim(String(customStyle));
+    // 根据";"将字符串转为数组形式
+    const styleArray = styleText.split(';');
+    const style: Record<string, any> = {};
+    // 历遍数组，拼接成对象
+    for (let i = 0; i < styleArray.length; i++) {
+      // 'font-size:20px;color:red;'，如此最后字符串有";"的话，会导致styleArray最后一个元素为空字符串，这里需要过滤
+      if (styleArray[i]) {
+        const item = styleArray[i].split(':');
+        style[trim(item[0])] = trim(item[1]);
+      }
+    }
+    return style;
+  }
+  // 这里为对象转字符串形式
+  const styleObject = customStyle as Record<string, any>;
+  let string = '';
+  for (const i in styleObject) {
+    // 驼峰转为中划线的形式，否则css内联样式，无法识别驼峰样式属性名
+    const key = i.replace(/([A-Z])/g, '-$1').toLowerCase();
+    string += `${key}:${styleObject[i]};`;
+  }
+  // 去除两端空格
+  return trim(string);
+}
+
+/**
+ * @description 添加单位，如果有rpx，upx，%，px等单位结尾或者值为auto，直接返回，否则加上px单位结尾
+ * @param {string|number} value 需要添加单位的值
+ * @param {string} unit 添加的单位名 比如px
+ */
+export function addUnit(value: string | number = 'auto', unit: string = config.unit): string {
+  value = String(value);
+  // 用uvui内置验证规则中的number判断是否为数值
+  return number(value) ? `${value}${unit}` : value;
+}
+
+/**
+ * @description 深度克隆
+ * @param {object} obj 需要深度克隆的对象
+ * @param cache 缓存
+ * @returns {*} 克隆后的对象或者原值（不是对象）
+ */
+export function deepClone<T>(obj: T, cache: WeakMap<object, any> = new WeakMap()): T {
+  if (obj === null || typeof obj !== 'object') return obj;
+  if (cache.has(obj)) return cache.get(obj);
+  let clone;
+  if (obj instanceof Date) {
+    clone = new Date(obj.getTime());
+  } else if (obj instanceof RegExp) {
+    clone = new RegExp(obj);
+  } else if (obj instanceof Map) {
+    clone = new Map(Array.from(obj, ([key, value]) => [key, deepClone(value, cache)]));
+  } else if (obj instanceof Set) {
+    clone = new Set(Array.from(obj, (value) => deepClone(value, cache)));
+  } else if (Array.isArray(obj)) {
+    clone = obj.map((value) => deepClone(value, cache));
+  } else if (Object.prototype.toString.call(obj) === '[object Object]') {
+    clone = Object.create(Object.getPrototypeOf(obj));
+    cache.set(obj, clone);
+    for (const [key, value] of Object.entries(obj)) {
+      clone[key] = deepClone(value, cache);
+    }
+  } else {
+    clone = Object.assign({}, obj);
+  }
+  cache.set(obj, clone);
+  return clone;
+}
+
+/**
+ * @description JS对象深度合并
+ * @param {object} target 需要拷贝的对象
+ * @param {object} source 拷贝的来源对象
+ * @returns {object|boolean} 深度合并后的对象或者false（入参有不是对象）
+ */
+export function deepMerge<T extends object>(target: T = {} as T, source: Partial<T> = {}): T {
+  target = deepClone(target);
+  if (typeof target !== 'object' || target === null || typeof source !== 'object' || source === null) return target;
+  const merged: Record<string, any> = Array.isArray(target)
+    ? (target.slice() as unknown as Record<string, any>)
+    : Object.assign({}, target);
+  const sourceRecord = source as Record<string, any>;
+  for (const prop in sourceRecord) {
+    if (!Object.prototype.hasOwnProperty.call(sourceRecord, prop)) continue;
+    const sourceValue = sourceRecord[prop];
+    const targetValue = merged[prop];
+    if (sourceValue instanceof Date) {
+      merged[prop] = new Date(sourceValue);
+    } else if (sourceValue instanceof RegExp) {
+      merged[prop] = new RegExp(sourceValue);
+    } else if (sourceValue instanceof Map) {
+      merged[prop] = new Map(sourceValue);
+    } else if (sourceValue instanceof Set) {
+      merged[prop] = new Set(sourceValue);
+    } else if (typeof sourceValue === 'object' && sourceValue !== null) {
+      merged[prop] = deepMerge(targetValue, sourceValue);
+    } else {
+      merged[prop] = sourceValue;
+    }
+  }
+  return merged as T;
+}
+
+/**
+ * @description error提示
+ * @param {*} err 错误内容
+ */
+export function error(err: string | Error): void {
+  // 开发环境才提示，生产环境不会提示
+  if (process.env.NODE_ENV === 'development') {
+    console.error(`uvui提示：${err}`);
+  }
+}
+
+/**
+ * @description 打乱数组
+ * @param {array} array 需要打乱的数组
+ * @returns {array} 打乱后的数组
+ */
+export function randomArray<T>(array: T[] = []): T[] {
+  // 原理是sort排序,Math.random()产生0<= x < 1之间的数,会导致x-0.05大于或者小于0
+  return array.sort(() => Math.random() - 0.5);
+}
+
+// padStart 的 polyfill，因为某些机型或情况，还无法支持es7的padStart，比如电脑版的微信小程序
+// 所以这里做一个兼容polyfill的兼容处理
+if (!String.prototype.padStart) {
+  // 为了方便表示这里 fillString 用了ES6 的默认参数，不影响理解
+  String.prototype.padStart = function (maxLength, fillString = ' ') {
+    if (Object.prototype.toString.call(fillString) !== '[object String]') {
+      throw new TypeError('fillString must be String');
+    }
+    const str = this;
+    // 返回 String(str) 这里是为了使返回的值是字符串字面量，在控制台中更符合直觉
+    if (str.length >= maxLength) return String(str);
+
+    const fillLength = maxLength - str.length;
+    let times = Math.ceil(fillLength / fillString.length);
+    while ((times >>= 1)) {
+      fillString += fillString;
+      if (times === 1) {
+        fillString += fillString;
+      }
+    }
+    return fillString.slice(0, fillLength) + str;
+  };
+}
+
+/**
+ * @description 格式化时间
+ * @param {String|Number} dateTime 需要格式化的时间戳
+ * @param {String} fmt 格式化规则 yyyy:mm:dd|yyyy:mm|yyyy年mm月dd日|yyyy年mm月dd日 hh时MM分等,可自定义组合 默认yyyy-mm-dd
+ * @returns {string} 返回格式化后的字符串
+ */
+export function timeFormat(dateTime: string | number | Date | null = null, formatStr = 'yyyy-mm-dd'): string {
+  let date: Date;
+  // 若传入时间为假值，则取当前时间
+  if (!dateTime) {
+    date = new Date();
+  }
+  // 若为unix秒时间戳，则转为毫秒时间戳（逻辑有点奇怪，但不敢改，以保证历史兼容）
+  else if (/^\d{10}$/.test(dateTime?.toString().trim())) {
+    date = new Date(Number(dateTime) * 1000);
+  }
+  // 若用户传入字符串格式时间戳，new Date无法解析，需做兼容
+  else if (typeof dateTime === 'string' && /^\d+$/.test(dateTime.trim())) {
+    date = new Date(Number(dateTime));
+  }
+  // 处理平台性差异，在Safari/Webkit中，new Date仅支持/作为分割符的字符串时间
+  // 处理 '2022-07-10 01:02:03'，跳过 '2022-07-10T01:02:03'
+  else if (typeof dateTime === 'string' && dateTime.includes('-') && !dateTime.includes('T')) {
+    date = new Date(dateTime.replace(/-/g, '/'));
+  }
+  // 其他都认为符合 RFC 2822 规范
+  else {
+    date = new Date(dateTime);
+  }
+
+  const timeSource: Record<string, string> = {
+    y: date.getFullYear().toString(), // 年
+    m: (date.getMonth() + 1).toString().padStart(2, '0'), // 月
+    d: date.getDate().toString().padStart(2, '0'), // 日
+    h: date.getHours().toString().padStart(2, '0'), // 时
+    M: date.getMinutes().toString().padStart(2, '0'), // 分
+    s: date.getSeconds().toString().padStart(2, '0'), // 秒
+    // 有其他格式化字符需求可以继续添加，必须转化成字符串
+  };
+
+  for (const key in timeSource) {
+    const [ret] = new RegExp(`${key}+`).exec(formatStr) || [];
+    if (ret) {
+      // 年可能只需展示两位
+      const beginIndex = key === 'y' && ret.length === 2 ? 2 : 0;
+      formatStr = formatStr.replace(ret, timeSource[key].slice(beginIndex));
+    }
+  }
+
+  return formatStr;
+}
+
+/**
+ * @description 时间戳转为多久之前
+ * @param {String|Number} timestamp 时间戳
+ * @param {String|Boolean} format
+ * 格式化规则如果为时间格式字符串，超出一定时间范围，返回固定的时间格式；
+ * 如果为布尔值false，无论什么时间，都返回多久以前的格式
+ * @returns {string} 转化后的内容
+ */
+export function timeFrom(timestamp: string | number | null = null, format: string | false = 'yyyy-mm-dd'): string {
+  if (timestamp == null) timestamp = Date.now();
+  let timestampValue = parseInt(String(timestamp));
+  // 判断用户输入的时间戳是秒还是毫秒,一般前端js获取的时间戳是毫秒(13位),后端传过来的为秒(10位)
+  if (timestampValue.toString().length == 10) timestampValue *= 1000;
+  let timer = Date.now() - timestampValue;
+  timer = parseInt(String(timer / 1000));
+  // 如果小于5分钟,则返回"刚刚",其他以此类推（文案走组件内置 i18n，支持用户覆盖）
+  let tips = '';
+  switch (true) {
+    case timer < 300:
+      tips = appTranslate('uv.time.justNow');
+      break;
+    case timer >= 300 && timer < 3600:
+      tips = appTranslate('uv.time.minutesAgo', { n: parseInt(String(timer / 60)) });
+      break;
+    case timer >= 3600 && timer < 86400:
+      tips = appTranslate('uv.time.hoursAgo', { n: parseInt(String(timer / 3600)) });
+      break;
+    case timer >= 86400 && timer < 2592000:
+      tips = appTranslate('uv.time.daysAgo', { n: parseInt(String(timer / 86400)) });
+      break;
+    default:
+      // 如果format为false，则无论什么时间戳，都显示xx之前
+      if (format === false) {
+        if (timer >= 2592000 && timer < 365 * 86400) {
+          tips = appTranslate('uv.time.monthsAgo', { n: parseInt(String(timer / (86400 * 30))) });
+        } else {
+          tips = appTranslate('uv.time.yearsAgo', { n: parseInt(String(timer / (86400 * 365))) });
+        }
+      } else {
+        tips = timeFormat(timestampValue, format);
+      }
+  }
+  return tips;
+}
+
+/**
+ * @description 去除空格
+ * @param String str 需要去除空格的字符串
+ * @param String pos both(左右)|left|right|all 默认both
+ */
+export function trim(str: string, pos: 'both' | 'left' | 'right' | 'all' = 'both'): string {
+  str = String(str);
+  if (pos == 'both') {
+    return str.replace(/^\s+|\s+$/g, '');
+  }
+  if (pos == 'left') {
+    return str.replace(/^\s*/, '');
+  }
+  if (pos == 'right') {
+    return str.replace(/(\s*$)/g, '');
+  }
+  if (pos == 'all') {
+    return str.replace(/\s+/g, '');
+  }
+  return str;
+}
+
+/**
+ * @description 对象转url参数
+ * @param {object} data,对象
+ * @param {Boolean} isPrefix,是否自动加上"?"
+ * @param {string} arrayFormat 规则 indices|brackets|repeat|comma
+ */
+export function queryParams(
+  data: Record<string, any> = {},
+  isPrefix = true,
+  arrayFormat: 'indices' | 'brackets' | 'repeat' | 'comma' = 'brackets',
+): string {
+  const prefix = isPrefix ? '?' : '';
+  const _result = [];
+  if (['indices', 'brackets', 'repeat', 'comma'].indexOf(arrayFormat) == -1) arrayFormat = 'brackets';
+  for (const key in data) {
+    const value = data[key];
+    // 去掉为空的参数
+    if (['', undefined, null].indexOf(value) >= 0) {
+      continue;
+    }
+    // 如果值为数组，另行处理
+    if (value.constructor === Array) {
+      // e.g. {ids: [1, 2, 3]}
+      switch (arrayFormat) {
+        case 'indices':
+          // 结果: ids[0]=1&ids[1]=2&ids[2]=3
+          for (let i = 0; i < value.length; i++) {
+            _result.push(`${key}[${i}]=${value[i]}`);
+          }
+          break;
+        case 'brackets':
+          // 结果: ids[]=1&ids[]=2&ids[]=3
+          value.forEach((_value) => {
+            _result.push(`${key}[]=${_value}`);
+          });
+          break;
+        case 'repeat':
+          // 结果: ids=1&ids=2&ids=3
+          value.forEach((_value) => {
+            _result.push(`${key}=${_value}`);
+          });
+          break;
+        case 'comma':
+          // 结果: ids=1,2,3
+          let commaStr = '';
+          value.forEach((_value) => {
+            commaStr += (commaStr ? ',' : '') + _value;
+          });
+          _result.push(`${key}=${commaStr}`);
+          break;
+        default:
+          value.forEach((_value) => {
+            _result.push(`${key}[]=${_value}`);
+          });
+      }
+    } else {
+      _result.push(`${key}=${value}`);
+    }
+  }
+  return _result.length ? prefix + _result.join('&') : '';
+}
+
+/**
+ * 显示消息提示框
+ * @param {String} title 提示的内容，长度与 icon 取值有关。
+ * @param {Number} duration 提示的延迟时间，单位毫秒，默认：2000
+ */
+export function toast(title: string, duration = 2000): void {
+  uni.showToast({
+    title: String(title),
+    icon: 'none',
+    duration,
+  });
+}
+
+/**
+ * @description 根据主题type值,获取对应的图标
+ * @param {String} type 主题名称,primary|info|error|warning|success
+ * @param {boolean} fill 是否使用fill填充实体的图标
+ */
+export function type2icon(type = 'success', fill = false): string {
+  // 如果非预置值,默认为success
+  if (['primary', 'info', 'error', 'warning', 'success'].indexOf(type) == -1) type = 'success';
+  let iconName = '';
+  // 目前(2019-12-12),info和primary使用同一个图标
+  switch (type) {
+    case 'primary':
+      iconName = 'info-circle';
+      break;
+    case 'info':
+      iconName = 'info-circle';
+      break;
+    case 'error':
+      iconName = 'close-circle';
+      break;
+    case 'warning':
+      iconName = 'error-circle';
+      break;
+    case 'success':
+      iconName = 'checkmark-circle';
+      break;
+    default:
+      iconName = 'checkmark-circle';
+  }
+  // 是否是实体类型,加上-fill,在icon组件库中,实体的类名是后面加-fill的
+  if (fill) iconName += '-fill';
+  return iconName;
+}
+
+/**
+ * @description 数字格式化
+ * @param {number|string} number 要格式化的数字
+ * @param {number} decimals 保留几位小数
+ * @param {string} decimalPoint 小数点符号
+ * @param {string} thousandsSeparator 千分位符号
+ * @returns {string} 格式化后的数字
+ */
+export function priceFormat(
+  number: number | string,
+  decimals = 0,
+  decimalPoint = '.',
+  thousandsSeparator = ',',
+): string {
+  number = `${number}`.replace(/[^0-9+-Ee.]/g, '');
+  const n = !isFinite(+number) ? 0 : +number;
+  const prec = !isFinite(+decimals) ? 0 : Math.abs(decimals);
+  const sep = typeof thousandsSeparator === 'undefined' ? ',' : thousandsSeparator;
+  const dec = typeof decimalPoint === 'undefined' ? '.' : decimalPoint;
+
+  const parts = (prec ? round(n, prec) + '' : `${Math.round(n)}`).split('.');
+  const re = /(-?\d+)(\d{3})/;
+  while (re.test(parts[0])) {
+    parts[0] = parts[0].replace(re, `$1${sep}$2`);
+  }
+
+  if ((parts[1] || '').length < prec) {
+    parts[1] = parts[1] || '';
+    parts[1] += new Array(prec - parts[1].length + 1).join('0');
+  }
+  return parts.join(dec);
+}
+
+/**
+ * @description 获取duration值
+ * 如果带有ms或者s直接返回，如果大于一定值，认为是ms单位，小于一定值，认为是s单位
+ * 比如以30位阈值，那么300大于30，可以理解为用户想要的是300ms，而不是想花300s去执行一个动画
+ * @param {String|number} value 比如: "1s"|"100ms"|1|100
+ * @param {boolean} unit  提示: 如果是false 默认返回number
+ * @return {string|number}
+ */
+export function getDuration(value: number | string, unit = true): string | number {
+  const valueNum = parseInt(String(value));
+  if (unit) {
+    if (/s$/.test(String(value))) return value;
+    return Number(value) > 30 ? `${value}ms` : `${value}s`;
+  }
+  if (/ms$/.test(String(value))) return valueNum;
+  if (/s$/.test(String(value))) return valueNum > 30 ? valueNum : valueNum * 1000;
+  return valueNum;
+}
+
+/**
+ * @description 日期的月或日补零操作
+ * @param {String} value 需要补零的值
+ */
+export function padZero(value: string | number): string {
+  return `00${value}`.slice(-2);
+}
+
+/**
+ * @description 在uv-form的子组件内容发生变化，或者失去焦点时，尝试通知uv-form执行校验方法
+ * @param {*} instance
+ * @param {*} event
+ */
+export function formValidate(instance: any, event?: any): void {
+  const formItem = $parent.call(instance, 'uv-form-item');
+  const form = $parent.call(instance, 'uv-form');
+  // 如果发生变化的input或者textarea等，其父组件中有uv-form-item或者uv-form等，就执行form的validate方法
+  // 同时将form-item的pros传递给form，让其进行精确对象验证
+  if (formItem && form) {
+    form.validateField(formItem.prop, () => {}, event);
+  }
+}
+
+/**
+ * @description 获取某个对象下的属性，用于通过类似'a.b.c'的形式去获取一个对象的的属性的形式
+ * @param {object} obj 对象
+ * @param {string} key 需要获取的属性字段
+ * @returns {*}
+ */
+export function getProperty(obj: Record<string, any> | null | undefined, key: string): any {
+  if (!obj) {
+    return;
+  }
+  if (typeof key !== 'string' || key === '') {
+    return '';
+  }
+  if (key.indexOf('.') !== -1) {
+    const keys = key.split('.');
+    let firstObj = obj[keys[0]] || {};
+
+    for (let i = 1; i < keys.length; i++) {
+      if (firstObj) {
+        firstObj = firstObj[keys[i]];
+      }
+    }
+    return firstObj;
+  }
+  return obj[key];
+}
+
+/**
+ * @description 设置对象的属性值，如果'a.b.c'的形式进行设置
+ * @param {object} obj 对象
+ * @param {string} key 需要设置的属性
+ * @param {string} value 设置的值
+ */
+export function setProperty(obj: Record<string, any> | null | undefined, key: string, value: any): void {
+  if (!obj) {
+    return;
+  }
+  // 递归赋值
+  const inFn = function (_obj: Record<string, any>, keys: string[], v: any): void {
+    // 最后一个属性key
+    if (keys.length === 1) {
+      _obj[keys[0]] = v;
+      return;
+    }
+    // 0~length-1个key
+    while (keys.length > 1) {
+      const k = keys[0];
+      if (!_obj[k] || typeof _obj[k] !== 'object') {
+        _obj[k] = {};
+      }
+      const key = keys.shift();
+      // 自调用判断是否存在属性，不存在则自动创建对象
+      inFn(_obj[k], keys, v);
+    }
+  };
+
+  if (typeof key !== 'string' || key === '') {
+  } else if (key.indexOf('.') !== -1) {
+    // 支持多层级赋值操作
+    const keys = key.split('.');
+    inFn(obj, keys, value);
+  } else {
+    obj[key] = value;
+  }
+}
+
+/**
+ * @description 获取当前页面路径
+ */
+export function page(): string {
+  const pages = getCurrentPages();
+  const route = pages[pages.length - 1]?.route;
+  // 某些特殊情况下(比如页面进行redirectTo时的一些时机)，pages可能为空数组
+  return `/${route ? route : ''}`;
+}
+
+/**
+ * @description 获取当前路由栈实例数组
+ */
+export function pages(): ReturnType<typeof getCurrentPages> {
+  const pages = getCurrentPages();
+  return pages;
+}
+
+/**
+ * 获取页面历史栈指定层实例
+ * @param back {number} [0] - 0或者负数，表示获取历史栈的哪一层，0表示获取当前页面实例，-1 表示获取上一个页面实例。默认0。
+ */
+export function getHistoryPage(back = 0): ReturnType<typeof getCurrentPages>[number] | undefined {
+  const pages = getCurrentPages();
+  const len = pages.length;
+  return pages[len - 1 + back];
+}
+
+/**
+ * @description 修改 uview-x 运行时内置属性值
+ * @param {object} config 修改内置 config 属性
+ * @param {object} color 修改内置 color 属性
+ */
+export interface SetConfigOptions {
+  config?: Partial<UviewXConfig>;
+  color?: Partial<UviewXColor>;
+  props?: UviewXProps;
+}
+
+export function setConfig({ config: configPatch = {}, color = {}, props = {} }: SetConfigOptions = {}): void {
+  const merged = deepMerge(config, configPatch);
+  Object.assign(config, merged);
+  config.color = deepMerge(config.color, color);
+  config.props = deepMerge(config.props, props);
+}