npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

qnyutils

v1.0.8

Published

vue项目开发常用js工具类,包括对象、时间、验证、手机号码、身份证、中文校验、英文校验等工具方法,减少多余包引用,增加工具类复用性,提高开发效率;

Downloads

3

Readme

qnyutils🎃

介绍

前端项目开发常用js工具类,包括手机号码身份证验证中文校验获取日期和根据日期格式获取日期或者转换日期格式对象数组根据key分组邮箱格式校验获取历史时间时间差数组去重多个对象数组去重等工具方法,减少多余包引用,增加工具类复用性,提高开发效率。

软件架构

本工具库是基于纯JavaScript开发的,后续会扩展支持typescript。

安装教程

1、npm安装
$ npm i qnyutils -D
2、配置使用

全部注入:在vue2项目中入口文件导入依赖并注册全局

import Vue from "vue";
import Qnyutils from "qnyutils";

Vue.prototype.$Qnyutils = window.Qnyutils = Qnyutils;

按需引入:比如需要时间工具和手机校验工具

// 按功能导入
import { getFormatTime, validateFormatPhone } from "qnyutils";

// 在js中使用
console.log(getFormatTime(), validateFormatPhone('123456'))

js/template 中基本使用案例:

// js 输入中文检验
this.$Qnyutils.chineseCheck('222') // false
// template 输入中文检验
$Qnyutils.chineseCheck('222') // false

更多工具类访问:## 目前集成的方法使用文档

使用说明

  1. 工具目前仅支持vue2.0或者vue3.0+js模式的npm安装依赖的项目
  2. Gitee 官方使用手册 https://gitee.com/qiuaiyun/qiu-tool

参与贡献

本套工具库解释权归布依前端所有,盗版必究

1、贡献者:布依前端

参与贡献:

QQ:1766226354

布依前端工具库说明

[TOC]

手机号校验

校验手机号格式是否正确,正确返回true,错误返回false

// 格式
options: [string]
this.$Qnyutils.validateFormatPhone(options)

// 示例
this.$Qnyutils.validateFormatPhone('12345678942') // 返回 false

中文校验

校验输入字符串是否是纯中文,正确返回true,错误返回false

// 格式
options: [string]
this.$Qnyutils.chineseCheck(options)

// 示例
this.$Qnyutils.chineseCheck('12345678942') // 返回 false

获取日期和日期格式转化

支持获取当前日期和传入日期格式化

支持格式:YYYY、YYYY-MM、YYYY-MM-DD、YYYY-MM-DD HH、YYYY-MM-DD HH:MM、YYYY-MM-DD HH:MM:SS、HH:MM:SS

用法:

/**
 * @description 将标准时间转成需要格式返回,默认年月日时分秒格式,
 *              如果不传入时间或者格式,默认获取当前时间 YYYY-MM-DD HH:MM:SS 返回
 * @param {*} format 时间格式,默认:YYYY-MM-DD HH:MM:SS
 * @param {*} time 当前时间,js中一般由new Date()获得,格式示例:Sun Nov 28 2021 19:46:23 GMT+0800 (中国标准时间)
 * @returns string 年-月-日 xx:xx:xx 默认
 */
this.$Qnyutils.getFormatTime(time, format)

// 示例
// 获取当前时间含时分秒
this.$Qnyutils.getFormatTime() // 返回, 2023-08-18 11:46:04

// 获取当前日期,年月日,format= 'YYYY-MM-DD',time可以写成'', null
this.$Qnyutils.getFormatTime(null, 'YYYY-MM-DD') // 返回, 2023-08-18 

// 获取当前日期,format= 'YYYY-MM-DD HH',time可以写成'', null
this.$Qnyutils.getFormatTime(null, 'YYYY-MM-DD HH') // 返回, 2021-09-12 15  

// 获取当前年份 format= 'YYYY'
this.$Qnyutils.getFormatTime(null, 'YYYY') // 返回 2023

// 日期time='2023-08-12 11:10:10'转化成format= 'YYYY-MM-DD'
this.$Qnyutils.getFormatTime('2023-08-12 11:10:10', 'YYYY-MM-DD') // 返回 2023-08-12

// 日期time='2023-08-12 11:10:10'转化成format= 'YYYY-MM-DD HH:MM'
this.$Qnyutils.getFormatTime('2023-08-12 11:10:10', 'YYYY-MM-DD HH:MM') // 返回 2023-08-12 11:10

// 日期time='2023-08-12 11:10:10'转化成format= 'HH:MM:SS'
this.$Qnyutils.getFormatTime('2023-08-12 11:10:10', 'HH:MM:SS') // 返回 11:10:10

邮箱格式校验

邮箱格式校验,正确返回true,错误返回false

// 格式
options: [string]
this.$Qnyutils.validateEmail(options)

// 示例
this.$Qnyutils.validateEmail('11222') // 返回false
this.$Qnyutils.validateEmail('[email protected]') // 返回true

数字+字母[6-20]格式校验

专门针对密码格式校验的方法,必须是数字+字母,且长度最小为6,最大为20

// 格式
options: [string]
this.$Qnyutils.validatePassWord(options)

// 示例
this.$Qnyutils.validatePassWord('[email protected]') // 返回 false
this.$Qnyutils.validatePassWord('11222qqcom') // 返回 true

数字类型校验

数字类型,专门针对纯数字校验,其他符合会被替换为空,返回纯数字,没有限制长度,如果输入没有中文,增返回空,否则返回字符串

// 格式
options: [string]
this.$Qnyutils.validateNumber(options)

// 示例
this.$Qnyutils.validateNumber('11222qqcom') // 返回 11222

保留两位小数格式输出

保留两位小数,输入的必须是数字类型,且能为负数,返回保留两位小数的字符串

// 格式
options: [string]
this.$Qnyutils.getTwoDecimal(options)

// 示例
this.$Qnyutils.getTwoDecimal('11222qqcom') // 返回 Nan 错误示例
this.$Qnyutils.getTwoDecimal('11222.1255') // 返回 11222.13 正确示例
this.$Qnyutils.getTwoDecimal('-11222.1255') // 返回 -11222.13 正确示例

对象深度拷贝

对象深度拷贝,可以用在对象属性或者其他类型数据的备份上。

// 格式
options:[object|array]
this.$Qnyutils.deepCloneObj(options)

// 示例
let obj = {age:12, name: '张三'}
this.$Qnyutils.deepCloneObj(obj) // 返回 newobj

历史时间格式

历史时间格式化,主要是当前时间和历史时间对比,例如,几秒前,几天前,几分钟前*,*时间字符串例如:2021-11-29 16:05:10

// 格式
options:[string]: '完整时间字符串,包括年月日时分秒'
this.$Qnyutils.getHistoryTime(options)

// 正确示例
this.$Qnyutils.getHistoryTime('2021-11-29 16:05:10') // 返回 几天前

校验身份证是否合法

身份证合法,返回true,错误返回false

// 格式
options:[string]: '身份证号'
this.$Qnyutils.validateIdent(options)

// 正确示例
this.$Qnyutils.validateIdent('522328199609021714') // 返回 true 

数组去重[单个数组,对象数组]

/**
 * 多个数组去重, 可是对象数组和字符串数组
 * @param {*} key 对象数组key,单个数组不能省略,设置为null即可
 * @param  {...any} _arguments 接收多个数组
 * @returns array
 */
this.$Qnyutils.multDeduplication = (key, ..._arguments)
单个数组去重
const numArr = [1, 2, 5, 6, 8, 7, 6, 5, 6]
const strArr = ['a', 'a', 'b', 'c', 'd', 'f', 'd']
const arr1 = this.$Qnyutils.multDeduplication(null, numArr)
const arr2= this.$Qnyutils.multDeduplication(null, strArr)
// arr1输出结果
[1, 2, 5, 6, 8, 7]
// arr2输出结果
['a', 'b', 'c', 'd', 'f']
对象数组去重

单个/多个对象数组去重,需要依赖对象key进行划分,key必传参数,如果传递key为null,则无法去重,如果key值错误,程序出现警告。

const list = [
    { price: 95.00, name: '三国演义'},
    { price: 100.00, name: '西游记'},
    { price: 68.00, name: '红楼梦'},
    { price: 88.00, name: '水浒传'},
    { price: 88.00, name: '水浒传'}
]
const list2 = [
    { price: 915.00, name: '三国演义'},
    { price: 10.00, name: '西游记'},
    { price: 6.00, name: '红楼梦'},
    { price: 8.00, name: '水浒传'},
    { price: 88.00, name: '水浒传'}
]
const arr = this.$Qnyutils.multDeduplication('price', list, list2)
// arr输出结果
[
    {
        "price": 95,
        "name": "三国演义"
    },
    {
        "price": 100,
        "name": "西游记"
    },
    {
        "price": 68,
        "name": "红楼梦"
    },
    {
        "price": 88,
        "name": "水浒传"
    },
    {
        "price": 915,
        "name": "三国演义"
    },
    {
        "price": 10,
        "name": "西游记"
    },
    {
        "price": 6,
        "name": "红楼梦"
    },
    {
        "price": 8,
        "name": "水浒传"
    }
]

计算时间区间差值

计算时间区间差值,返回相差天数、小时和分钟

用法

/**
 * 计算时间区间差值,返回相差天数、小时和分钟
 * @param {*} startTime 开始时间 2023-08-12 11:10:10
 * @param {*} endTime 结束时间 2023-08-14 20:50:10
 * @returns 
 * {
 *    day: days,
 *    hours: hour,
 *    timeStr: time,
 *    minutes
 *  }
 */
this.$Qnyutils.calcDateDifference (startTime, endTime)

// 调用方法
const value = this.$Qnyutils.calcDateDifference ('2023-08-12 11:10:10', '2023-08-14 20:50:10')
console.log(value)
// 打印结果
{
    "day": 2,
    "hours": 9.67,
    "timeStr": "2天9.67时40分钟",
    "minutes": 40
}

对象数组分组

针对对象数组分组,回显分组后的数组,可以根据配置属性进行分组。

// 分组数据
const storehouse = [
    { name: "asparagus", type: "vegetables", quantity: 5 },
    { name: "bananas", type: "fruit", quantity: 0 },
    { name: "goat", type: "meat", quantity: 23 },
    { name: "cherries", type: "fruit", quantity: 5 },
    { name: "fish", type: "meat", quantity: 22 },
];
const list = this.$Qnyutils.groupByKey(storehouse, ({ type }) => type))
console.log(list);
// 输出结果
{
    "vegetables": [
        {
            "name": "asparagus",
            "type": "vegetables",
            "quantity": 5
        }
    ],
    "fruit": [
        {
            "name": "bananas",
            "type": "fruit",
            "quantity": 0
        },
        {
            "name": "cherries",
            "type": "fruit",
            "quantity": 5
        }
    ],
    "meat": [
        {
            "name": "goat",
            "type": "meat",
            "quantity": 23
        },
        {
            "name": "fish",
            "type": "meat",
            "quantity": 22
        }
    ]
}