z-formatter v1.3.4

z-formatter

一个简单js方法库，目的是简化js数据操作

使用方法

使用npm安装

npm install z-formatter

引用

import $z from 'z-formatter'

索引

1. 类型判断

isString

isNumber

isArray

isBoolean

isFunction

isObject

2. 一般字符串操作

时间格式化

cookie设置

cookie获取

3. 一般对象操作

对象的深浅拷贝

对象的合并

4. 一般数组操作

数组去重

数组添加

数组删除

数组排序（支持复杂对象排序）

对象数组分组

5. 正则验证

邮箱

手机号码

文档

isString

判断是否为字符串类型

$z.isString(value)
// value: any

$z.isString('123')
// true

$z.isString(123)
// false

$z.isString({ a: 1, b: 2 })
// false

isNumber

判断是否为数字类型

$z.isNumber(value)
// value: any

$z.isNumber(123)
// true

$z.isNumber('123')
// false

$z.isNumber({ a: 1, b: 2 })
// false

isArray

判断是否为数组类型

$z.isArray(value)
// value: any

$z.isArray([ 1, 2, 3 ])
// true

$z.isArray('123')
// false

$z.isArray({ a: 1, b: 2 })
// false

isBoolean

判断是否为数组类型

$z.isBoolean(value)
// value: any

$z.isBoolean(false)
// true

$z.isBoolean('123')
// false

$z.isBoolean({ a: 1, b: 2 })
// false

isFunction

判断是否为函数类型

$z.isFunction(value)
// value: any

$z.isFunction(function(){})
// true

$z.isFunction('123')
// false

$z.isFunction({ a: 1, b: 2 })
// false

isObject

判断是否为对象类型

$z.isObject(value)
// value: any

$z.isObject({ a: 1, b: 2 })
// true

$z.isObject(function(){})
// false

$z.isObject('123')
// false

setCookie

设置cookie

$z.setCookie(key, val, time)
// key: String
// val: any
// time: 保存时间（一小时为单位）

$z.setCookie('name','zhang')
// key: 'name' value: 'zhang'

$z.setCookie('data',{a:1,b:2},3)
// key: 'data' value: [{'a':1,'b':2}]

getCookie

获取cookie

$z.getCookie(key)
// key: String

$z.getCookie('name')
// 'zhang'

$z.getCookie('data')
// {a: 1, b: 2}

toDate

时间格式化函数

$z.toDate(date,format)
// date: Date 毫秒数 ||日期格式
// format: String 'YY-MM-DD hh:mm:ss'

$z.toDate('2018-3-3') // 默认格式化
// 2018/03/03

$z.toDate(1234567890, 'YY/MM/DD hh:mm:ss') //指定格式化（可自由组合）
// 1970/01/15 14:56:07

objectCopy

数组或对象的拷贝

$z.objectCopy(obj, params)
// obj: Array || Object
// params: 'deep' || 'shallow'

$z.objectCopy({a: 1, b: 2, c: 3}) // 浅拷贝
// {a: 1, b: 2, c: 3} 默认浅拷贝

$z.objectCopy({a: 1, b: 2, c: {a: function(){}}}, 'deep') //深拷贝
// {a: 1, b: 2, c: {a: function(){}}}

objectMerge

合并对象并返回一个合并后的对象

$z.objectMerge(obj, obj2...)
// obj: Object

var a = {a: 1, b: 2}
var b = {c: 2, d: 4}
var c = {e: 5, f: 6}

$z.objectMerge(a,b,c)
// {a: 1, b: 2, c: 2, d: 4, e: 5, f: 6}

sort

数组排序（支持复杂对象排序）

$z.sort(arr, type, key)
// arr: Array
// type: 'order' || 'invert'
// key: 当传入对象数组时，要指定一个key用来排序

var arr = [2, 1, 3]

$z.sort(arr, 'order')
// [1, 2, 3]

$z.sort(arr, 'invert')
// [3, 2, 1]

var arr = [
  {id:3,name:'zhang'},
  {id:1,name: 'wang'},
  {id:2,name:'li'}
]

$z.sort(arr, 'order', 'id')
// {id:1,name: 'wang'},{id:2,name:'li'},{id:3,name:'zhang'},

$z.sort(arr, 'invert', 'id')
//  {id:3,name:'zhang'}, {id:2,name:'li'}, {id:1,name: 'wang'},

simplify

数组去重

$z.simplify(arr)
// val: Array

$z.simplify([1,2,3,2,3,2,4,5,6])
// [1, 2, 3, 4, 5, 6]

append

数组添加

$z.append(val, i, data)
// val: Array
// i: index
// data: any

$z.append([1,2,3], 2, {a:1})
// [1, 2, {a:1}, 3]

remove

数组删除

$z.remove(val, start, count)
// val: Array
// start: index
// count: 数量any

$z.remove([1,2,3], 2, 1)
// [1, 2]

arrayGrounp

根据传入的对象数组和key进行分组

$z.arrayGrounp(arr, key)
// arr: Array
// key: String

var arr = [
  {id: 1, year: 2018},
  {id: 2, year: 2017},
  {id: 3, year: 2016},
  {id: 4, year: 2017},
  {id: 5, year: 2018},
  {id: 6, year: 2017}
]


$z.arrayGrounp(arr, 'year')
// {
//   "2016": [
//     {"id": 3, "year": 2016}
//   ],
//   "2017": [
//     {"id": 2, "year": 2017},
//     {"id": 4, "year": 2017},
//     {"id": 6, "year": 2017}
//   ],
//   "2018": [
//     {"id": 1, "year": 2018},
//     {"id": 5, "year": 2018}
//   ]
// }

isEmail

表单验证邮箱

$z.isEmail(val)
// val: String

$z.isEmail('123@qq.com')
// true

$z.isEmail('$zhang@$zhangan.cn')
// true

isPhone

表单验证手机号

$z.isPhone(val)
// val: String || Number

$z.isPhone('13233333333')
// true

$z.isPhone('18623456543')
// true

更多功能陆续添加中...