Nice Paintings, Mondrian

    format-tools

    0.0.7 • Public • Published

    format-tools

    Build Status

    NPM

    一个简单的格式化工具;包含格式化日期时间、数字、字符串的几个常用方法;

    安装

    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'

    Install

    npm i format-tools

    DownloadsWeekly Downloads

    1

    Version

    0.0.7

    License

    MIT

    Unpacked Size

    13.2 kB

    Total Files

    6

    Last publish

    Collaborators

    • sun2dan