yunlin 1.0.19 → 1.0.21

package/src/utils.js

@@ -1,545 +0,0 @@
-
-
-/**
- * 格式化数字，添加千分位分隔符。
- * 支持数字和字符串类型的数字输入。
- * 如果输入无效，返回空字符串。
- *
- * @param {number|string} num - 要格式化的数字或数字字符串。
- * @return {string} 格式化后的带千分位分隔符的字符串，或空字符串（如果输入无效）。
- */
-function fmtNum(num) {
-	if (num == 0) return '0'
-	if (!num) return ''
-
-	// 尝试将输入转换为数字，如果输入是字符串则使用parseFloat进行转换
-	let number = typeof num === 'string' ? parseFloat(num) : num;
-	// 检查转换后的值是否为有效数字
-	if (isNaN(number)) {
-		// 如果转换失败，返回空字符串
-		return '';
-	}
-	// 使用 toLocaleString 方法格式化数字，添加千分位分隔符
-	// 设置国际化选项：使用美国英语格式，小数部分显示0至2位
-	return number.toLocaleString('en-US', {
-		minimumFractionDigits: 0,
-		maximumFractionDigits: 2
-	});
-}
-
-/**
- * 分割全名成姓和名
- * @param {string} fullName - 待处理的完整姓名
- * @param {boolean} [isEn=false] - 指示姓名是否为英文格式，默认为false表示中文姓名
- * @returns {object} 返回一个对象，包含姓（surname）和名（givenName）
- */
-function splitName(fullName, isEn = false) {
-	// 初始化结果对象，用于存储姓和名
-	let result = {
-		surname: '', // 姓
-		givenName: '' // 名
-	};
-	// 如果是英文姓名
-	if (isEn) {
-		// 英文姓名通常格式为 "SURNAME, GIVEN NAME(S)"
-		// const parts = fullName.split(','); // 使用逗号分割姓名
-		// 使用逗号分割姓名，如果没有逗号  以空格分隔
-		const parts = fullName.includes(',') ? fullName.split(',') : fullName.split(/\s+/);
-		if (parts.length >= 2) {
-			// 移除前后空白字符并分配给姓和名
-			result.surname = parts[0].trim(); // 第一部分为姓
-			result.givenName = parts[1].trim(); // 第二部分为名
-		}
-	} else {
-		// 定义中文复姓列表
-		const surnames = [
-			"欧阳", "太史", "端木", "上官", "司马", "东方", "独孤", "南宫", "万俟", "闻人",
-			"夏侯", "诸葛", "尉迟", "公羊", "赫连", "澹台", "皇甫", "宗政", "濮阳", "公冶",
-			"太叔", "申屠", "公孙", "慕容", "仲孙", "钟离", "长孙", "宇文", "司徒", "鲜于",
-			"司空", "闾丘", "子车", "亓官", "司寇", "巫马", "公西", "颛孙", "壤驷", "公良",
-			"漆雕", "乐正", "宰父", "谷梁", "拓跋", "夹谷", "轩辕", "令狐", "段干", "百里",
-			"呼延", "东郭", "南门", "羊舌", "微生", "公户", "公玉", "公仪", "梁丘", "公仲",
-			"公上", "公门", "公山", "公坚", "左丘", "公伯", "西门", "公祖", "第五", "公乘",
-			"贯丘", "公皙", "南荣", "东里", "东宫", "仲长", "子书", "子桑", "即墨", "达奚",
-			"褚师", "吴铭",
-			// 繁体（如果有不同的写法）
-			"歐陽", "太史", "端木", "上官", "司馬", "東方", "獨孤", "南宮", "萬俟", "聞人",
-			"夏侯", "諸葛", "尉遲", "公羊", "赫連", "澹臺", "皇甫", "宗政", "濮陽", "公冶",
-			"太叔", "申屠", "公孫", "慕容", "仲孫", "鐘離", "長孫", "宇文", "司徒", "鮮於",
-			"司空", "閭丘", "子車", "亓官", "司寇", "巫馬", "公西", "顓孫", "壤駟", "公良",
-			"漆雕", "樂正", "宰父", "穀梁", "拓跋", "夾谷", "軒轅", "令狐", "段幹", "百里",
-			"呼延", "東郭", "南門", "羊舌", "微生", "公戶", "公玉", "公儀", "梁丘", "公仲",
-			"公上", "公門", "公山", "公堅", "左丘", "公伯", "西門", "公祖", "第五", "公乘",
-			"貫丘", "公皙", "南榮", "東里", "東宮", "仲長", "子書", "子桑", "即墨", "達奚",
-			"褚師", "吳銘"
-		];
-		// 尝试查找复姓
-		for (let i = 0; i < surnames.length; i++) {
-			const surname = surnames[i];
-			// 如果全名以某个复姓开头
-			if (fullName.startsWith(surname)) {
-				// 设置姓为该复姓，名则为复姓之后的部分
-				result.surname = surname;
-				result.givenName = fullName.substring(surname.length).trim();
-				return result; // 找到后立即返回结果
-			}
-		}
-		// 如果没有找到复姓，处理单姓的情况
-		const parts = fullName.split(' '); // 使用空格分割姓名
-		if (parts.length === 1) {
-			// 如果没有空格分隔，使用正则表达式来识别第一个汉字作为姓
-			const surnameMatch = fullName.match(/[\u4e00-\u9fa5]/); // 匹配第一个汉字
-			result.surname = surnameMatch ? surnameMatch[0] : ''; // 设置姓
-			// 移除姓后的剩余部分作为名
-			result.givenName = fullName.replace(result.surname, '').trim();
-		} else {
-			// 如果有空格分隔，第一部分作为姓，剩余部分作为名
-			result.surname = parts[0]; // 第一部分为姓
-			result.givenName = parts.slice(1).join(' '); // 其余部分为名
-		}
-	}
-	return result;
-}
-
-
-/**
- * 将指定键名替换成另外的键名
- * strCode:原始键名
- * code：新键名
- */
-function modifyKeys(array, keyMap = {
-	strCode: "code",
-	strFjbh: "fjbh",
-	strGuid: "value",
-	strValue: "label"
-}) {
-	if (!array.length || array === null) return []
-	// 遍历数组中的每个对象
-	const modifiedArray = array.map(obj => {
-		const modifiedObj = {};
-		// 遍历对象的键
-		for (const key in obj) {
-			if (keyMap.hasOwnProperty(key)) {
-				// 如果键在映射表中有对应的新键名，则使用新键名
-				modifiedObj[keyMap[key]] = obj[key];
-			} else {
-				// 否则保持原始键名
-				modifiedObj[key] = obj[key];
-			}
-		}
-		return modifiedObj;
-	});
-	return modifiedArray;
-}
-
-/**
- * 对数组进行切片处理
- * data：需要处理的数组
- * quantity：需要切割的数量
- * fromFront：是从前还是从后面切，默认从后
- */
-function sliceArray(data, quantity, fromFront) {
-	if (quantity <= 0) {
-		console.error("Quantity should be greater than 0.");
-		return [];
-	}
-	if (fromFront) {
-		return data.slice(0, quantity);
-	} else {
-		return data.slice(-quantity);
-	}
-}
-
-
-/**
- * 判断指定键名的值是否在数组内
- * @param {*} inputArray 源数组
- * @param {*} target	需要匹配的值
- * @param {*} key 键名
- */
-function findDataByData(inputArray, target, key) {
-	const foundData = inputArray.find(item => item[key] === target);
-	return foundData || null;
-}
-
-/**
- * 分割数组
- */
-function splitArray(arr, n) {
-	const result = [];
-	for (let i = 0; i < arr.length; i += n) {
-		result.push(arr.slice(i, i + n));
-	}
-	return result;
-}
-
-
-/**
- * 获取proxy的数据类型
- */
-function getProxyType(value) {
-	return Object.prototype.toString.call(value).slice(8, -1);
-}
-
-
-let timeout = null
-/**
- * 防抖原理：一定时间内，只有最后一次操作，再过wait毫秒后才执行函数
- *
- * @param {Function} func 要执行的回调函数
- * @param {Number} wait 延时的时间
- * @param {Boolean} immediate 是否立即执行
- * @return null
- */
-function debounce(func, wait = 500, immediate = false) {
-	// 清除定时器
-	if (timeout !== null) clearTimeout(timeout)
-	// 立即执行，此类情况一般用不到
-	if (immediate) {
-		const callNow = !timeout
-		timeout = setTimeout(() => {
-			timeout = null
-		}, wait)
-		if (callNow) typeof func === 'function' && func()
-	} else {
-		// 设置定时器，当最后一次操作后，timeout不会再被清除，所以在延时wait毫秒后执行func回调方法
-		timeout = setTimeout(() => {
-			typeof func === 'function' && func()
-		}, wait)
-	}
-}
-
-/**
- * 判断指定键名的值是否在数组内
- */
-function matchKeyValueInArray(arr, key, value) {
-	for (let i = 0; i < arr.length; i++) {
-		if (arr[i][key] === value) {
-			return true;
-		}
-	}
-	return false;
-}
-
-
-/**
- * 对象转URL
- * @param {object} obj
- */
-function urlEncode(obj = {}) {
-	const result = []
-	for (const key in obj) {
-		const item = obj[key]
-		if (!item) {
-			continue
-		}
-		if (isArray(item)) {
-			item.forEach(val => {
-				result.push(key + '=' + val)
-			})
-		} else {
-			result.push(key + '=' + item)
-		}
-	}
-	return result.join('&')
-}
-
-/**
- * 比较日期大小
- * @param {Object} date1
- * @param {Object} date2 默认当日
- */
-function compareDates(date1, date2) {
-	date1 = new Date(date1);
-	if (!date2) {
-		date2 = new Date();
-	} else {
-		date2 = new Date(date2);
-	}
-	date1.setHours(0, 0, 0, 0); // 将时间部分设置为0
-	date2.setHours(0, 0, 0, 0); // 将时间部分设置为0
-	// 将日期转换为时间戳进行比较
-	var timeStamp1 = date1.getTime();
-	var timeStamp2 = date2.getTime();
-	if (timeStamp1 < timeStamp2) {
-		return -1; // date1 小于 date2
-	} else if (timeStamp1 > timeStamp2) {
-		return 1; // date1 大于 date2
-	} else {
-		return 0; // date1 等于 date2
-	}
-}
-
-/**
- * 获取2个日期间的天数
- * @param {Object} date1
- * @param {Object} date2
- */
-function getDaysBetween(date1, date2) {
-	// 将日期字符串转换为Date对象
-	const d1 = new Date(date1);
-	const d2 = new Date(date2);
-
-	// 计算两个日期之间的毫秒数
-	const diff = Math.abs(d1.getTime() - d2.getTime());
-
-	// 将毫秒数转换为天数
-	const days = Math.floor(diff / (1000 * 60 * 60 * 24));
-
-	return days + 1; // 包括起始日期和结束日期，所以需要加1
-}
-
-
-/**
- * 转中文大写
- * @param {Object} num
- */
-function chineseNumeral(num) {
-	const numerals = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖'];
-	const units = ['', '拾', '佰', '仟'];
-	const scales = ['', '万', '亿', '兆'];
-
-	let integerPart = Math.floor(num);
-	let decimalPart = Math.round((num - integerPart) * 100); // 取小数点后两位的整数表示
-	let str = '';
-
-	// 转换整数部分
-	for (let i = 0; integerPart > 0; i++) {
-		let temp = '';
-		let section = integerPart % 10000;
-		integerPart = Math.floor(integerPart / 10000);
-
-		for (let j = 0; section > 0; j++) {
-			let digit = section % 10;
-			temp = (digit ? numerals[digit] + units[j] : '') + temp;
-			section = Math.floor(section / 10);
-		}
-		str = temp + (temp ? scales[i] : scales[i] && !str.includes('零') ? '零' : '') + str;
-	}
-	str += str ? '元' : '零元';
-	// 转换小数部分
-	if (decimalPart > 0) {
-		let jiao = Math.floor(decimalPart / 10);
-		let fen = decimalPart % 10;
-		str += (jiao ? numerals[jiao] + '角' : '') + (fen ? numerals[fen] + '分' : '');
-	} else {
-		str += '整';
-	}
-
-	return str.replace(/零{2,}/g, '零').replace(/零元/, '元');
-}
-
-
-/**
- * 获取月份所有日期 
- * @param {*} monthYear 月份，格式为2024-2或2024-02 不传或者空字符串则返回当月
- */
-function getMonthDate(monthYear) {
-	if (!monthYear || monthYear.trim() === '') {
-		monthYear = `${new Date().getFullYear()}-${new Date().getMonth() + 1}`;
-	}
-	let dates = [];
-	let [year, month] = monthYear.split('-').map(Number);
-	let date = new Date(year, month, 0);
-	let days = date.getDate();
-
-	for (let i = 1; i <= days; i++) {
-		let day = i < 10 ? `0${i}` : `${i}`;
-		let monthFormatted = month < 10 ? `0${month}` : `${month}`;
-		dates.push({
-			date: `${year}-${monthFormatted}-${day}`,
-			disable: true
-		});
-	}
-	return dates;
-}
-
-function getToday(date) {
-	var today = new Date();
-	var dd = String(today.getDate()).padStart(2, '0');
-	var mm = String(today.getMonth() + 1).padStart(2, '0'); //January is 0!
-	var yyyy = today.getFullYear();
-	today = yyyy + '-' + mm + '-' + dd
-	return today
-}
-
-
-
-
-
-/**
- * 重置对象
- * @param {Object} obj
- */
-function resetObject(val) {
-	let obj = JSON.parse(JSON.stringify(val))
-	for (const key in obj) {
-		if (typeof obj[key] === 'number') {
-			obj[key] = 0;
-		} else if (typeof obj[key] === 'boolean') {
-			obj[key] = false;
-		} else if (Array.isArray(obj[key])) {
-			obj[key] = [];
-		} else if (typeof obj[key] === 'object' && obj[key] !== null) {
-			// 递归调用以处理嵌套对象
-			resetObject(obj[key]);
-		} else {
-			obj[key] = '';
-		}
-	}
-	return obj
-}
-
-/**
- * 精确运算函数，解决浮点数计算精度丢失问题。
- * 该函数接受两个数字和一个操作符（1: 加法, 2: 减法, 3: 乘法, 4: 除法），
- * 通过将浮点数转换为整数进行计算，再转换回浮点数得到相对精确的结果。
- * @param {number} a - 参与运算的第一个数字
- * @param {number} b - 参与运算的第二个数字
- * @param {number} operator - 表示运算类型的数字，1为加法，2为减法，3为乘法，4为除法
- * @returns {number} - 根据操作符计算得到的结果
- */
-function preciseOperation(a, b, operator, precisionFactor = 1000000) {
-	// 处理特殊值NaN
-	if (isNaN(a) || isNaN(b)) {
-		return NaN;
-	}
-	// 处理无穷大
-	if (!isFinite(a) || !isFinite(b)) {
-		return NaN;
-	}
-	let num1 = BigInt(Math.round(a * precisionFactor));
-	let num2 = BigInt(Math.round(b * precisionFactor));
-	let result;
-	switch (operator) {
-		case 1:
-			result = num1 + num2;
-			break;
-		case 2:
-			result = num1 - num2;
-			break;
-		case 3:
-			result = num1 * num2;
-			break;
-		case 4:
-			if (num2 === 0n) {
-				throw new Error('除数不能为0');
-			}
-			result = num1 / num2;
-			break;
-		default:
-			throw new Error('无效的操作符，操作符应为1、2、3或4');
-	}
-	return Number(result) / precisionFactor;
-}
-
-
-
-
-/**
- * 使用精确运算函数计算数组内所有元素的总和。
- * 如果数组中的元素是字符串形式的数字，则尝试将其转换为数字；
- * 如果转换失败或元素是 null/undefined，则将该元素视为 0。
- * @param {Array} numbers - 数字或字符串形式的数字数组
- * @returns {number} - 数组内所有元素的总和
- */
-function preciseSum(numbers) {
-	// 初始化总和为0
-	let sum = 0;
-	// 遍历数组中的每个元素
-	for (const num of numbers) {
-		let currentNum = 0; // 默认值为0
-		// 尝试将元素转换为数字
-		if (typeof num === 'string') {
-			const parsedNum = parseFloat(num);
-			if (!isNaN(parsedNum)) {
-				currentNum = parsedNum;
-			}
-		} else if (typeof num === 'number') {
-			currentNum = num;
-		}
-		// 使用 preciseOperation 进行加法操作
-		sum = preciseOperation(sum, currentNum, 1); // 1 表示加法
-	}
-	return sum;
-}
-
-/**
- * 获取指定日期的前后时间
- * @param {Object} dateStr 指定日期
- * @param {Object} days	天数
- */
-function getRelativeDate(dateStr, days = 0) {
-	const date = new Date(dateStr);
-	date.setDate(date.getDate() + days); // 在日期上加上指定的天数，负数则减去天数
-
-	// 将日期转换回 YYYY-MM-DD 格式
-	const year = date.getFullYear();
-	const month = (date.getMonth() + 1).toString().padStart(2, '0'); // getMonth() 返回 0-11
-	const day = date.getDate().toString().padStart(2, '0');
-
-	return `${year}-${month}-${day}`;
-
-	// 示例使用
-	// console.log(getRelativeDate('2023-03-04', 2));   // 返回 '2023-03-06'
-	// console.log(getRelativeDate('2023-03-04', -2));  // 返回 '2023-03-02'
-}
-
-
-/**
- * 校验指定键名的值是否为指定值（默认为空字符串）
- * @param {Object} model 校验对象
- * @param {Array} fields 校验对象内的键名数组
- * @param {Any} valueToCheck 校验的值
- */
-function validateFields(model, fields, valueToCheck = "") {
-	for (let field of fields) {
-		if (model[field] === valueToCheck) {
-			return true;
-		}
-	}
-	return false;
-}
-
-/**
- * 本函数与Object.assign()的区别为不会像第一个对象中添加第一个对象原本不存在的键
- * 将第二个对象中相同键名的值赋值给第一个对象中相同键名
- * @param {Object} obj1
- * @param {Object} obj2
- */
-function mergeObjects(obj1, obj2) {
-	// 遍历 obj1 的键名
-	for (const key in obj1) {
-		// 如果 obj2 中存在相同的键名
-		if (obj2.hasOwnProperty(key)) {
-			// 将 obj2 中的值赋值给 obj1 中的相同键名
-			obj1[key] = obj2[key];
-		}
-	}
-	return obj1;
-}
-
-
-export default {
-	fmtNum,
-	splitName,
-	preciseSum,
-	modifyKeys,
-	sliceArray,
-	findDataByData,
-	splitArray,
-	getProxyType,
-	debounce,
-	matchKeyValueInArray,
-	urlEncode,
-	compareDates,
-	getDaysBetween,
-	chineseNumeral,
-	getMonthDate,
-	getToday,
-	resetObject,
-	preciseOperation,
-	getRelativeDate,
-	validateFields,
-	mergeObjects
-}