x-format

2020-01-16

x-format

simple formatting functions for date and numbers with units. Uses moment.js for date formatting

build status">Build Status

x-format

This module contains formatting functions for numbers and dates.

It offers a simple interface and a configurable default behavior.

Using options you can override the default behavior and use p.e. all date formats as defined by moment.js

usage

var format=require('x-format');

var
    str1 = format.number({value:5,unit:'$'}), // '5.00 $'
    str2 = format.number(1000,4),             // '1,000.40'

    str3 = format.date(1393314010759),  // '02/25/2014' default format 'L'
    str4 = format.date(1393314010759),  // '02/25/2014'
    str5 = format.date('2014');         // '01/01/2014'

format.config.locale='de'; // change the global default locale

var    
    str5_de = format.date('2014'),                                           // '01.01.2014' as defined global, de 
    str5_en = format.date('2014',{locale:'en'}),                             // '01/01/2014' explicit with option
    str6    = format.date('2014-02-22',{locale:'en'}),                       // '02/22/2014' ISO conversion
    str7    = format.date(1393314010759,{format:'MMMM Do YYYY, h:mm:ss a'}), // 'Februar 25\. 2014, 8:40:10 am'
    str8    = format.date(1393314010759,{format:'LLL'}),                     // '25\. Februar 2014 8:40 Uhr'
    str9    = format.date('25\. Februar 2014');                               // '25.02.2014' parse locale specific input

format.config

format.config.locale = 'en'

@param {locale:} contains the default locale to use globally. Default 'en'

format.number: function( value, options )

Formats number, with decimal point, thousend separators, scale and v.unit as suffix

@param {value} a number or an object like { value: <number> , unit: 'MB' } @param {options} optional options merged with format.number.config and format.config @return {the} formatted string

format.number.en, .de ...

contains for each locale the thousands and decimal separator:

de: { thousands:'.', decimal:',' }

format.number.config

contains the global default options:

@param {scale} number of digits to show. Default 2 @param {unit} show units in final string in case number is an object with a unit property. Default: true

format.date: function( date, options )

Formats a date according to the locale settings, Default format is 'L' as defined by moment.js

Example:

var str = require('x-format').date('2012-05-03', {locale:'de'}); // '03.05.2012'

@param {date} the date as a string or long a returned by Date.now()@param {options} optional options. Example {format:'LLL', locale: 'en' }. Default format is 'L' @return {the} formatted string

以上是 x-format 的使用教程帮助文档。


上一篇:Mkoa
下一篇:x-dom
相关教程
关注微信

扫码加入 JavaScript 社区

相关文章

首次访问,需要验证
微信扫码,关注即可
(仅需验证一次)

欢迎加入 JavaScript 社区

号内回复关键字:

回到顶部