<#def title = "工具对象"/> <#def keyword = "ZhiqimUI"/> <#def desc = "工具对象也是静态对象的一种，把一系列常用的静态属性和函数归类到一个工具对象中。目前包括断言工具（Z.A/Z.Asserts）、对象工具（Z.O/Z.Objects）、类型工具（Z.T/Z.Types）、"/> <#def prevUrl = "static.htm"/> <#def nextUrl = "query.htm"/> ${zhiqim_com_header()} ${zhiqim_com_topnav()}
${zhiqim_com_ui("tutorial", "ui", "js", "util")}
${zhiqim_com_breadcrumb("文库", "教程", "工具对象")}
<#-- 标题 -->

工具对象：

工具对象也是静态对象的一种，把一系列常用的静态属性和函数归类到一个工具对象中。目前包括断言工具（Z.A/Z.Asserts）、对象工具（Z.O/Z.Objects）、类型工具（Z.T/Z.Types）、 验证工具（Z.V/Z.Validates）、表单工具（Z.FM/Z.Forms）、JSON工具（Z.J/Z.Jsons）、日期工具（Z.DT/Z.DateTimes）、数组工具（Z.AR/Z.Arrays）、字符串工具（Z.S/Z.Strings）、算术工具（Z.Maths）、 金额工具（Z.AM/Z.Amounts）和颜色工具（Z.Colors）。

<#-- 断言工具（Z.A） -->
断言工具（Z.A/Z.Asserts）
函数 说明 参数 参数说明
Z.A.assertNotEmpty(value, message) 断言不为空 value 断言的值
message 断言失败时告警信息
Z.A.assertNotEmptyBlank(value, message) 断言不为空白 value 断言的值
message 断言失败时告警信息
<#-- 对象工具（Z.O） -->
对象工具（Z.O/Z.Objects）
函数 说明 参数 参数说明
Z.O.isOwn(obj, prop) 是否自己的属性
Object.prototype.hasOwnProperty		 obj 指定的对象
prop 指定的属性名
Z.O.isCommon(obj, prop) 是否普通属性
属性名是数字或字符串，属性值非函数的属性		 obj 指定的对象
prop 指定的属性名
Z.O.toString(obj) 对象字符串并去掉“[object ”和“]”前后缀
Object.prototype.toString		 obj 指定的对象
Z.O.toStyleString(obj) 转化为样式风格字符串，分号分隔
如：width:100px;height:100px;		 obj 指定的对象
Z.O.toJSONString(obj) 转化为JSON字符串
如：{width:"100px",height:"100px"}		 obj 指定的对象
<#-- ID工具（Z.Ids） -->
ID工具（Z.Ids）
函数 说明 备注
Z.Ids.uuid() 生成ID 通过随机数和当前时间生成唯一编号，格式：
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
1、1-8位随机数
2、3段4长度的随机数
3、8位长度时间+4位随机数
<#-- 类型工具（Z.T） -->
对象工具（Z.T/Z.Types）
函数 说明 参数 参数说明
Z.T.isBoolean(obj) 是否布尔值 obj 指定的对象
Z.T.isNumber(obj) 是否数值类型 obj 指定的对象
Z.T.isString(obj) 是否字符串 obj 指定的对象
Z.T.isPrimitive(obj) 是否基本类型（布尔值或数值类型或字符串） obj 指定的对象
Z.T.isFunction(obj) 是否函数 obj 指定的对象
Z.T.isArray(obj) 是否数组 obj 指定的对象
Z.T.isDate(obj) 是否日期 obj 指定的对象
Z.T.isRegExp(obj) 是否正则表达式 obj 指定的对象
Z.T.isObject(obj) 是否对象 obj 指定的对象
Z.T.isPlainObject(obj) 纯对象 obj 指定的对象
Z.T.isLikeArray(obj) 是否类似数组 obj 指定的对象
Z.T.isNull(obj) 是否为null obj 指定的对象
Z.T.isUndefined(obj) 是否未定义 obj 指定的对象
Z.T.isNaN(obj)) 是否非数值 obj 指定的对象
Z.T.isInfinity(obj) 是否无限数 obj 指定的对象
Z.T.isNonInfinity(obj) 是否负无限数 obj 指定的对象
Z.T.isNil(obj) 是否无效数（未定义、null、非数值、无限数、负无限数） obj 指定的对象
Z.T.isWindow(obj) 是否window对象 obj 指定的对象
Z.T.isDocument(obj) 是否文档对象 obj 指定的对象
Z.T.isElement(obj) 是否元素对象 obj 指定的对象
Z.T.isArguments(obj) 是否参数对象 obj 指定的对象
<#-- 验证工具（Z.V） -->
对象工具（Z.V/Z.Validates）
函数 说明 参数 参数说明
单字符验证，支持是否是数字、小数、字母、大写字母、小写字母、字母和数字
Z.V.isDigit(c) 是否是数字 c 指定的字符
Z.V.isDot(c) 单字字符 c 指定的字符
Z.V.isColon(c) 是否是冒号 c 指定的字符
Z.V.isDigitOrDot(c) 是否是数字或小数点 c 指定的字符
Z.V.isDigitOrColon(c) 是否是数字或冒号
如时间表示		 c 指定的字符
Z.V.isLetter(c) 是否是字母大小写 c 指定的字符
Z.V.isLetterLowercase(c) 是否是小写字母 c 指定的字符
Z.V.isLetterUppercase(c) 是否是大写字母 c 指定的字符
Z.V.isLetterOrDigit(c) 是否是字母或者数字 c 指定的字符
字符串验证，支持是否符合正则表达式、为空、非空、空白、非空白、数值型等
Z.V.isRegexp(regexp, s) 是否是正则表达式 regexp 检查是否符合正则表达式规范
s 指定的字符串
Z.V.isEmpty(s) 检查是否为空 s 指定的字符串
Z.V.isNotEmpty(s) 检查是否不为空 s 指定的字符串
Z.V.isEmptyBlank(s) 检查是否为空白（空或长度为0或由空白符构成） s 指定的字符串
Z.V.isNotEmptyBlank(s) 检查不为空白 s 指定的字符串
Z.V.isNumeric(s) 检查是否为数值字符串 s 指定的字符串
Z.V.isNumericLen(s, min, max) 检查是否为数值字符串且符合长度要求 s 指定的字符串
min 指定的最小长度
max 指定的最大长度
Z.V.isInteger(s) 检查是否为整数 s 指定的字符串
Z.V.isIntegerValue(s, min, max) 检查是否为整数且符合值范围 s 指定的字符串
min 指定的最小值
max 指定的最大值
Z.V.isIntegerPositive(s) 检查是否为正整数 s 指定的字符串
Z.V.isFloat(s) 检查是否为浮点型 s 指定的字符串
Z.V.isAmount2R(s) 检查是否为金额值 s 指定的字符串
Z.V.isDate(s) 检查是否为日期 s 指定的字符串
Z.V.isTime(s) 检查是否为时间 s 指定的字符串
Z.V.isDateTime(s) 检查是否为时间，格式为日期+时间 s 指定的字符串
Z.V.isEmail(s) 检查是否为邮件 s 指定的字符串
Z.V.isMobile(s) 检查是否为手机号 s 指定的字符串
Z.V.isMobile11(s) 检查是否为11位手机号 s 指定的字符串
Z.V.isContain(strs, separator, s) 检查是否包含字符串 strs 包含的字符串
s 指定的字符串
其他验证
Z.V.isLeapYear(year) 检查是否闰年 year 输入的年份
<#-- 表单工具（Z.FM） -->
表单工具（Z.FM/Z.Forms）
函数 说明 参数 参数说明
Z.FM.clearForm(form) 清空表单 form 指定的表单
Z.FM.clearSelect(elem) 清空选择框的数据 elem 指定的选择框
Z.FM.isChecked(name, form) 判断是否选中单选框或多选框 name 名称
form 指定的表单，未传入查全部names
Z.FM.getChecked(name, form) 获取被选中单选框和多选框的值 name 名称
form 指定的表单，未传入查全部names
Z.FM.getCheckBoxValue(name, form) 获取多选框的值，多个用逗号隔开 name 名称
form 指定的表单，未传入查全部names
Z.FM.doSelectCheckBox(name, policy, form) 全选,反选和取消，三个参数都可以不传入 name 名称
policy 指定策略，1表示全选，2表示全取消，0表示反选，未传值默认0
form 指定的表单，未传入查全部names
Z.FM.doSelectCheckBoxTree(name, checked, value, form) 选择树，选中自己时同时选中所有子节点，和父继承节点 name 名称
checked 是否选中，true|false
value 当前选择多选框的值，用于子节点和父节点判断是否对应
form 指定的表单，未传入查全部names
<#-- JSON工具（Z.Jsons） -->
JSON工具（Z.J/Z.Jsons）
函数 说明 参数 参数说明
Z.J.toObject(str) 返回JSON对象 str 指定的字符串
Z.J.toString(obj) 转化为字符串 obj 指定的对象
Z.J.toKey(key) 转为带双引号的KEY字符串 str 指定的字符串
Z.J.addEscapeChar(str, quotation) 添加转义符 str 指定的字符串
quotation 引号字符，单引号或双引号
<#-- 日期工具（Z.DT） -->
日期工具（Z.DT/Z.DateTimes）
函数 说明 参数 参数说明
Z.DT.getDateTimeString() 取得当前的日期时间字符串，格式：yyyy-MM-dd HH:mm:ss
Z.DT.getDateString() 取得当前的日期时间字符串，格式：yyyy-MM-dd
Z.DT.getCurrentYear() 获取当前年份
Z.DT.getCurrentMonth() 获取当前月份
Z.DT.getCurrentMonthDays() 获取当前月天数
Z.DT.getCurrentDay() 获取当前日期
Z.DT.getMonthDays(year, month) 获取指定月天数 year 指定的年份(yyyy)
month 指定的月份(1-12)
Z.DT.getDateWeek(year, month, day) 求星期取值,获取指定时间的星期数:星期一=1;星期二=2;星期三=3;星期四=4;星期五=5;星期六=6;星期日=7 year 指定的年份(yyyy)
month 指定的月份(1-12)
day 指定的日期(1-31))
Z.DT.toDateString(date) Date对象转换为String
格式：“yyyy-MM-dd”
date 指定的Date对象
Z.DT.toTimeString(date) Date对象转换为String
格式：“HH:mm:ss”		 date 指定的Date对象
Z.DT.toDateTimeString(date) Date对象转换为String
格式为:"yyyy-MM-dd HH:mm:ss"		 date 指定的Date对象
Z.DT.toDate (date, time) String转为Date对象
标准日期格式:"yyyy-MM-dd"
标准时间格式:"HH:mm:ss"		 date 字符串，格式：“yyyy-MM-dd”
time 字符串，格式：“HH:mm:ss”
<#-- 数组工具（Z.AR） -->
数组工具（Z.AR/Z.Arrays）
函数 说明 参数 参数说明
Z.AR.first(objs) 获取数组中第一个 objs 指定的数组
Z.AR.last(objs) 获取数组中最后一个 objs 指定的数组
Z.AR.indexOf(objs, obj) 获取对象在数组中的索引号
objs 指定的数组
obj 指定的对象
Z.AR.contains(objs, obj) 判断对象是否在数组中
objs 指定的数组
obj 指定的对象
Z.AR.remove(objs, obj) 从数组中删除指定的对象
objs 指定的数组
obj 指定的对象
Z.AR.toArray(strs, separator) 字符串按分隔符转为数组 strs 指定的字符串
Z.AR.toObject(strs, separator) 字符串按分隔符转成对象
如：width:100px;max-height:100px;
转：{width:"100px",maxHeight:"100px"}
注：中杠会去掉并下一字符大写		 strs 指定的字符串
Z.AR.toString(values, separator) 数组按分隔符转换成字符串 values 指定的数组
Z.AR.toJSONString(values) 转换成JSON字符串 values 指定的数组
<#-- 字符串工具（Z.S） -->
字符串工具（Z.S/Z.Strings）
函数 说明 参数 参数说明
Z.S.trim(s) 去掉字符串左边及右边的空格 s 指定的字符串
Z.S.trimLeft(s) 去掉字符串左边的空格 s 指定的字符串
Z.S.trimRight(s) 去掉字符串右边的空格 s 指定的字符串
Z.S.startWith(str, s) 字符串str是否以s开始 str 原字符串
s 比较字符串
Z.S.endWith(str, s) 字符串str是否以s结尾 str 指定的原字符串
s 比较字符串
Z.S.equalsIgnoreCase(s1, s2) 忽略大小写两字符串是否相等 s1 指定的字符串1
s2 指定的字符串2
Z.S.replaceAll(s, src, dest, ignoreCase) 替换字符串，执行全部匹配 s 指定的字符串
src 被替换的字符串
dest 替换后的字符串
ignoreCase 是否忽略大小写，未传入值为false
Z.S.lengthUnicode(s) 转换为Unicode编码长度 s 指定的字符串
Z.S.lengthUnicode35(s) 转换为Unicode35位编码长度 s 指定的字符串
Z.S.toUTF8(s) 转换为UTF8编码 s 指定的字符串
Z.S.toHexString(b) 转换成ASCII字符 s 指定的字符串
Z.S.prefixZero(str, len) 前缀补零，得到给定长度的值,补足0 str 初始str
len 指定的长度
Z.S.prefixLen(str, len, prefix) 前缀补齐，通过给定初始str,和前置char,得到给定长度的值, 通常用于前补0等 str 初始str
len 指定的长度
prefix 前置char
Z.S.prefixNum(text) 取前缀数字 text 指定的字符串
Z.S.prefixZeroRemove(value) 删除整型的前缀0 value 指定的需要删除前缀的数据
Z.S.removeSecondDot(value) 删除小数第二个小数点后面的数据 value 指定的数据
Z.S.removeAmountZero(value) 金额抹零 value 指定的金额值
<#-- 算术工具（Z.Maths） -->
算术工具（Z.Maths）
函数 说明 参数 参数说明
Z.Maths.multiply(m, m2) 数字相乘 m 数字1
m2 数字2
<#-- 金额工具（Z.Amounts） -->
金额工具（Z.AM/Z.Amounts）
函数 说明 参数 参数说明
Z.Amounts.toYuan(amount) 金额分，转为字符串元，转化后最大2位小数点，没有的不保留小数点 amount 金额分值
Z.Amounts.toYuanMustRadix(amount) 金额分，转为字符串元，转化后强制为2位小数点，没有的为.00 amount 金额分值
Z.Amounts.toFen(str, defaultValue) 金额元字符串转int金额分，支持整数、1位小数和2位小数点的金额字符串 str 金额元的字符串
defaultValue 缺省值
<#-- 颜色工具（Z.Colors） -->
颜色工具（Z.Colors）
函数 说明 参数 参数说明
Z.Colors.toString(iColor) 数字的颜色转为字符串十六进制格式（#750848） iColor 指定的颜色
Z.Colors.toInt(sColor) 字符串十六进制（#750848）格式转为数字的颜色 sColor 指定的颜色
Z.Colors.toArray(color) 颜色（数字型或字符串#750848）转为红绿蓝数组 color 指定的颜色
${zhiqim_com_chapter()}
${zhiqim_com_footer()}