0.0.7 • Published 5 years ago
format-tools v0.0.7
format-tools
一个简单的格式化工具;包含格式化日期时间、数字、字符串的几个常用方法;
安装
node
$ npm install format-tools
浏览器
<script src='./dist/index.js'></script>
以amd或cmd模式引入,如果环境不支持amd或cmd,挂载到window上,window.formatTools;
点击此处查看测试页面
// seajs测试
seajs.use('formatTools', function (formatTools) {
console.log(formatTools);
});
// requirejs 测试
requirejs(['formatTools'], function (formatTools) {
console.log(formatTools);
});
// 浏览器原生
console.log(window.formatTools);
用法
引用
var formatTools = require('format-tools'); // node环境中的require引用、浏览器环境
import formatTools from 'format-tools/index'; // es6的import引用
format(str, args)
一个简单的字符串格式化工具,支持下标和属性两种方式,属性名称为数字、字母和下划线的组合;
- str:模板字符串
formatTools.format('{0}-{1}-{2}', 2018, '08', 10); // => '2018-08-10'
formatTools.format('{year}-{month}-{day}', {year:2018, month:'08', day: 10}); // => '2018-08-10'
formatDate(date, splitChar)
格式化日期,返回日期部分;有两个参数:
- date:date|number|string,支持日期对象、时间戳;
- splitChar: 可选,日期的分隔符号,默认为 '-'
formatTools.formatDate(new Date(2018, 9, 10, 12, 34, 56)); // => '2018-10-10'
formatTools.formatDate(1539146096000, '/'); // => '2018/10/10'
formatTime(date)
格式化日期,返回时间部分;一个参数:
- date:date|number|string,支持日期对象、时间戳;
formatTools.formatTime(new Date(2018, 9, 10, 12, 34, 56)); // => '12:34:56'
formatTools.formatTime(1539146096000); // => '12:34:56'
formatDateTime(date, splitChar)
格式化日期时间,返回日期+时间;有两个参数:
- date:date|number|string,支持日期对象、时间戳;
- splitChar: 可选,日期的分隔符号,默认为 '-'
formatTools.formatDateTime(new Date(2018, 9, 10, 12, 34, 56)); // => '2018-10-10 12:34:56'
formatTools.formatDateTime(1539146096000, '/'); // => '2018/10/10 12:34:56'
formatByThousand(num)
格式化数字,金额用到的时候较多,三位加一个千分位符号,参数:
- num: number|string,需要格式化的数字;
formatTools.formatByThousand(1234567); // => '1,234,567'
formatTools.formatDateTime('1234.56'); // => '1,234.56'
1234.56.toLocaleString('en-us'); // => '1,234.56'
split4(str)
格式化字符串,四位加一个空格,银行卡号用到的较多;
- str: number|string,需要格式化的字符串;
formatTools.split4(6225880112345678); // => '6225 8801 1234 5678'
getType(args)
获取参数类型字符串(小写);
- args: String|Object|Number|Date|null|undefined,需要格式化的字符串;
formatTools.getType(new Date()); // => 'date'
formatTools.getType(123); // => 'number'
formatTools.getType('test'); // => 'string'
formatTools.getType({a: 1}); // => 'object'
formatTools.getType(null); // => 'null'
formatTools.getType(undefined); // => 'undefined'