@ecolovo/uniapp-components 1.0.0

package/utils/date.js

@@ -0,0 +1,151 @@
+/**
+ * 将Date 对象、时间戳或时间格式字符串转为 Date 对象
+ * @param {Date | number | string} dateValue Date 对象、时间戳或时间格式字符串
+ * @returns {Date} Date 对象
+ */
+export function toDate(dateValue) {
+	if (dateValue instanceof Date) return new Date(dateValue);
+	if (typeof dateValue === 'number') return new Date(dateValue);
+	if (!dateValue) {
+		return null;
+	}
+	if (typeof dateValue !== 'string') {
+		throw new Error("dateValue's type is invalid");
+	}
+	// 兼容 iOS 日期格式
+	const result = new Date(dateValue.replace(/-/g, '/'));
+	if (isNaN(result.getTime())) {
+		throw new Error('dateValue cannot be parsed to Date object');
+	}
+	return result;
+}
+
+/**
+ * 格式化日期
+ *
+ * format 参数说明：
+ * - Y: 年
+ * - M: 月
+ * - D: 日
+ * - H: 时
+ * - m: 分
+ * - s: 秒
+ * - S: 毫秒
+ * - w: 星期
+ * - W: 星期（中文）
+ * @param {Date | undefined} date 要格式化的日期对象
+ * @param {string} format 格式化参数 默认值 YYYY-MM-DD
+ * @returns {string} 格式化后的日期
+ */
+export function formatDate(date, format = formatDate.DATE_WITH_YEAR) {
+	if (!date) {
+		return '';
+	}
+	const fullYear = date.getFullYear().toString();
+	const year = fullYear.substring(fullYear.length - 2);
+	const month = (date.getMonth() + 1).toString();
+	const day = date.getDate().toString();
+	const hour = date.getHours().toString();
+	const min = date.getMinutes().toString();
+	const sec = date.getSeconds().toString();
+	const ms = date.getMilliseconds().toString();
+	const week = date.getDay().toString();
+	let weekCN = '';
+	switch (week) {
+		case '0':
+			weekCN = '日';
+			break;
+		case '1':
+			weekCN = '一';
+			break;
+		case '2':
+			weekCN = '二';
+			break;
+		case '3':
+			weekCN = '三';
+			break;
+		case '4':
+			weekCN = '四';
+			break;
+		case '5':
+			weekCN = '五';
+			break;
+		case '6':
+			weekCN = '六';
+			break;
+	}
+
+	const replacement = [
+		{ reg: 'Y{3,4}', val: fullYear, pad: 0 },
+		{ reg: 'Y{1,2}', val: year, pad: 0 },
+		{ reg: 'M{1,2}', val: month, pad: 2 },
+		{ reg: 'D{1,2}', val: day, pad: 2 },
+		{ reg: 'H{1,2}', val: hour, pad: 2 },
+		{ reg: 'm{1,2}', val: min, pad: 2 },
+		{ reg: 's{1,2}', val: sec, pad: 2 },
+		{ reg: 'S{1,3}', val: ms, pad: 3 },
+		{ reg: 'w', val: week, pad: 0 },
+		{ reg: 'W', val: weekCN, pad: 0 },
+	];
+
+	for (let i = 0; i < replacement.length; i++) {
+		const r = replacement[i];
+		format = format.replace(new RegExp(r.reg, 'g'), function (m) {
+			return r.pad > 0 ? r.val.padStart(Math.min(r.pad, m.length), '0') : r.val;
+		});
+	}
+	return format;
+}
+
+/** 月日 */
+formatDate.DATE = 'MM-DD';
+/** 年月日 */
+formatDate.DATE_WITH_YEAR = 'YYYY-MM-DD';
+/** 时分秒 */
+formatDate.TIME = 'HH:mm:ss';
+/** 时分秒.毫秒 */
+formatDate.TIME_MS = 'HH:mm:ss.SSS';
+/** 时分 */
+formatDate.TIME_MINUTE = 'HH:mm';
+/** 月日 时分秒 */
+formatDate.DATE_TIME = 'MM-DD HH:mm:ss';
+/** 月日 时分秒.毫秒 */
+formatDate.DATE_TIME_MS = 'MM-DD HH:mm:ss.SSS';
+/** 年月日 时分秒 */
+formatDate.DATE_TIME_WITH_YEAR = 'YYYY-MM-DD HH:mm:ss';
+/** 年月日 时分秒.毫秒 */
+formatDate.DATE_TIME_MS_WITH_YEAR = 'YYYY-MM-DD HH:mm:ss.SSS';
+/** 月日 时分 */
+formatDate.DATE_MINUTE = 'MM-DD HH:mm';
+/** 年月日 时分 */
+formatDate.DATE_MINUTE_WITH_YEAR = 'YYYY-MM-DD HH:mm';
+
+/** 时区差 */
+const TIMEZONE_OFFSET = new Date().getTimezoneOffset() * 60 * 1000;
+
+/**
+ * 获取时间的UTC相对时间戳
+ * @param {number | string | Date} date 时间
+ * @returns {number} 毫秒数
+ */
+function toDayTimestamp(date) {
+	let d = null;
+	if (typeof date === 'number') {
+		return date - TIMEZONE_OFFSET;
+	} else if (typeof date === 'string') {
+		d = toDate(date);
+	} else if (!(date instanceof Date)) {
+		d = new Date();
+	}
+	return d.getTime() - TIMEZONE_OFFSET;
+}
+
+/**
+ * 获取两个时间的天数差
+ * @param {number | string | Date} day1 时间1
+ * @param {number | string | Date} day2 时间2
+ * @returns {number} 天数差，负数: day1 < day2
+ */
+export function daysDiff(day1, day2) {
+	return Math.floor(toDayTimestamp(day1) / 8.64e7) - Math.floor(toDayTimestamp(day2) / 8.64e7);
+}

package/utils/floor.js

@@ -0,0 +1,20 @@
+import { round } from './round';
+
+/**
+ * 向下取值
+ * @param {number} val 需要处理的数据
+ * @param {number} precision 保留小数位数，默认不保留
+ * @returns {number} 处理后的数据
+ */
+export function floor(val, precision = 0) {
+	return Math.floor(+round(val, precision) + 'e' + precision) / Math.pow(10, precision);
+}
+
+/**
+ * 向下取值，并保留 2 位小数
+ * @param {number} val 需要处理的数据
+ * @returns {number} 处理后的数据
+ */
+export function floor2(val) {
+	return floor(val, 2);
+}

package/utils/freezeDeep.js

@@ -0,0 +1,19 @@
+/**
+ * 深度冻结一个对象
+ *
+ * 注意：传入的对象和返回的对象是同一个引用，慎用！！
+ *
+ * @template T
+ * @param {T} obj 要被冻结的对象
+ * @returns {Readonly<T>}
+ */
+export function freezeDeep(obj) {
+	if (!(typeof obj === 'object' && obj)) {
+		return obj;
+	} else {
+		for (let key in obj) {
+			freezeDeep(obj[key]);
+		}
+		return Object.freeze(obj);
+	}
+}

package/utils/price.js

@@ -0,0 +1,32 @@
+/**
+ * 格式化价格
+ * @param {number} price 价格
+ * @returns {FormattedPrice}
+ */
+export function formatPrice(price) {
+	if (isNaN(price)) {
+		return {
+			price: '',
+			negative: false,
+			integer: '',
+			decimal: '',
+			number: NaN,
+		};
+	}
+	price = Number(price);
+	let negative = false;
+	if (price < 0) {
+		negative = true;
+		price = -price;
+	}
+	const integer = Math.floor(price).toString();
+	const decimal = (Math.round(+price + 'e' + 2) % 100).toString().padStart(2, '0');
+	const formattedPrice = `${negative ? '-' : ''}${integer}.${decimal}`;
+	return {
+		price: formattedPrice, // 价格字符串
+		negative,
+		integer, // 整数部分
+		decimal, // 小数部分
+		number: Number(formattedPrice),
+	};
+}

package/utils/round.js

@@ -0,0 +1,22 @@
+/**
+ * 四舍五入处理
+ * @param {number} val 需要处理的数据
+ * @param {number} precision 保留小数位数，默认不保留
+ * @returns {number} 处理后的数据
+ */
+export function round(val, precision = 0) {
+	if (val.toString().indexOf('e') >= 0) {
+		const exponential = val.toString().split('e');
+		return Math.round(exponential[0] + 'e' + (+exponential[1] + precision)) / Math.pow(10, precision);
+	}
+	return Math.round(+val + 'e' + precision) / Math.pow(10, precision);
+}
+
+/**
+ * 四舍五入处理，并保留 2 位小数
+ * @param {number} val 需要处理的数据
+ * @returns {number} 处理后的数据
+ */
+export function round2(val) {
+	return round(val, 2);
+}

package/utils/windowInfo.js

@@ -0,0 +1,77 @@
+/** 默认导航栏高度 */
+const NAV_TITLE_HEIGHT = 44;
+/** 胶囊按钮位置信息
+ * @type {UniApp.GetMenuButtonBoundingClientRectRes | null}
+ */
+let menuButton = null;
+/** 系统信息
+ * @type {UniApp.GetWindowInfoResult | null}
+ */
+let windowInfo = null;
+/** 导航栏高度 */
+let navBarHeight = NAV_TITLE_HEIGHT;
+/** 导航栏顶部距离 */
+let navBarTopOffset = 0;
+/** 导航栏底部距离 */
+let navBarBottomOffset = NAV_TITLE_HEIGHT;
+/** 底部安全区域高度
+ * @type {number}
+ */
+let safeAreaInsetBottom = uni.upx2px(50);
+
+/* #ifdef MP-WEIXIN || MP-ALIPAY */
+menuButton = uni.getMenuButtonBoundingClientRect();
+/* #endif */
+windowInfo = uni.getWindowInfo();
+// eslint-disable-next-line no-console
+console.log('windowInfo:', windowInfo);
+
+if (menuButton) {
+	if (navBarHeight < menuButton.height) {
+		navBarHeight = menuButton.height + 12;
+	}
+	navBarTopOffset = menuButton.top - (navBarHeight - menuButton.height) / 3;
+} else {
+	navBarTopOffset = windowInfo.safeArea.top || windowInfo.statusBarHeight;
+}
+navBarBottomOffset = navBarTopOffset + navBarHeight;
+const _safeAreaBottom = windowInfo.screenHeight - windowInfo.safeArea.bottom;
+if (_safeAreaBottom) {
+	safeAreaInsetBottom = _safeAreaBottom;
+}
+
+/** mixin */
+const windowInfoMixin = {
+	computed: {
+		/** 胶囊按钮位置信息 */
+		menuButton: () => menuButton,
+		/** 胶囊按钮宽度 */
+		menuButtonWidth() {
+			return this.menuButton ? 'calc(100vw - ' + this.menuButton.left + 'px)' : '0px';
+		},
+		/** 系统信息 */
+		windowInfo: () => windowInfo,
+		/** 导航栏高度 */
+		navBarHeight: () => navBarHeight,
+		/** 导航栏顶部距离 */
+		navBarTopOffset: () => navBarTopOffset,
+		/** 导航栏底部距离 */
+		navBarBottomOffset: () => navBarBottomOffset,
+		/** 底部安全区域高度 */
+		safeAreaInsetBottom: () => safeAreaInsetBottom,
+	},
+};
+
+/**
+ * @typedef {ComponentDefinition<{}, {}, ComputedDefinition<typeof windowInfoMixin['computed']>>['$vm']} WindowInfoMixin
+ */
+
+export {
+	menuButton,
+	windowInfo,
+	navBarHeight,
+	navBarTopOffset,
+	navBarBottomOffset,
+	safeAreaInsetBottom,
+	windowInfoMixin,
+};