ac-format

针对多格式、多时区，进行转换输出sdk，目前只提供一个api。 bee-input-number>2.2.11 

如何使用

  安装
  ynpm install ac-format --save

  引入
  import {
    initJDiwork,
    getFormatNumber,
    getDateFormat,
    getTimeFormat,
    getGlobalizationDateFormat,
    getGlobalizationTimeFormat,
    getGlobalizationDateFormatString,
    getGlobalizationFormatNumber
    } from "ac-format"; 

  使用 
  ...
 
 getFormatNumber.formatNumber()

cnd 标签使用

  <script src="//design.yonyoucloud.com/static/tinper-bee/latest/ac-format/dist/index.js"></script>

多格式 转换规则如下

分量	数字的显示方式	示例
0	表示一个数字，被格式化数值不够的位数会补0	7、8 等
#	表示一个数字，被格式化数值不够的位数会忽略	07、08 等
[.]	小数点分隔符的占位符，由方括号标记，方括号里的字符用来标记小数点	, . 等
%	前缀或后缀，将数值乘以100并显示为百分数	#[.]##%，%#[.]##
\u2030	前缀或后缀，将数值乘以1000并显示为千分数	#[.]##\u2030
\u00A4	前缀或后缀，货币记号，由货币号替换。
E	科学计数法，根据前面的表达式计算有效位数，将结果按科学计数法表示一般使用E0，而不能使用E#	#[.]##E0
‘	单引号，转义字符，如果在结果中需要拼接特殊字符，需要将其包含在单引号中	'#'#
(	前缀，使用这个符号代表负数需要用括号来表示，与+不能同时出现	-3.14表示成(3.14)
+	正负号的符号位，与(不能同时出现	+ ###，###[.]####

多时区转换格式如下(详细介绍)

https://uap.wiki.yonyou.com/pages/viewpage.action?pageId=96698548

分量	数字的显示方式	示例
TT	大写进制周期标志（12小时AM/PM） 只有当指定了12小时h（例如，hh TT）时，才能使用此分量。	8:01 AM 08:01:01.02 PM

示例

 
以 -10000003.1415926为例

+ ###,###[.]####  =  - 10000,003.1416

###,###,###[.]####### +  =  10,000,003.1415926 -

(### ### ###[,]####### = (10 000 003,1415926)    

(#.####.####[,]####### = (1000.0003,1415926)  

API

API	说明	类型	默认值/参数
initJDiwork	获取上下文，在项目初始化的时候调用	function(don)	把业务逻辑写在回调中，必须有上下文，否则项目上给默认值
getFormatNumber	多格式转换	function(格式,值)	-
getDateFormat	多时区，转moment对象	function(值,时区,格式)	-
getTimeFormat	多时区，转string 显示对象	function(值,值对应的时区,时区,格式,返回值)	-
getGlobalizationFormatNumber	获取上下文设置多格式	function(value)	-
getGlobalizationDateFormatString	时区、格式 互转，省略值会从上下文获取	function(value,valueUtc,utc,dateType,gloformat,toFormat)	详细使用见demo4
getGlobalizationDateFormat	通过上下文设置 datePicker/dateTimePicker	function(value,utc,dateType,format,resultType)	dateType 转换类型,是date、还是dateTime【"YYYY-MM-DD"/"YYYY-MM-DD HH:mm:ss",默认 "YYYY-MM-DD"】、resultType 返回数据类型
getGlobalizationTimeFormat	通过上下文设置 timePacker	function(value,valueUtc,utc,resultType)	-

API 参数字段注解

 1. valueUtc 指 当前字符串的时区。

 2. utc 指 上下问的时区，也可以自己指定时区(缺省值是上下文时区)。

 3. dateType 当前需要转的类型 datePicker/dateTimePicker。

 4. gloformat 当前数据的格式(缺省值是获取上下文的格式)。

 5. toFormat 指定转出数据的格式(缺省值会自动获取上下文的格式。此字段建议按照数据能存储的字段进行)

多格式

getFormatNumber("+ ###,###[.]####", 123456789.123) 

多时区

dateTpicker

import {  getDateFormat } from ac-format;

render(){
  let d = '2020/02/06 14:30:06';
  value={getDateFormat(d,"UTC-10:00")}
  //返回Moment对象
  value={getDateFormat(d,"UTC-10:00")}
  //返回时间字符串
  ...
}
    

timeTpicker

import {  getDateFormat } from ac-format;

render(){
  let _t = '14:30:06';
  //夏威夷时区
  value = getTimeFormat(_t,'UTC-10:00','hh:mm:ss a');
  //东八区
  value = getTimeFormat(_t,'UT+8:00');
  ...
}
    

上下文封装调用

在使用前，要保证加载了jDiwork 上下文环境，如果没有的话，需要加载一下js

jDiwork 加载方式一(推荐)

<script src="//cdn.yonyoucloud.com/pro/diwork/download/jDiwork.js"></script>

jDiwork 加载方式二

import { initJDiwork } from ac-format;

所以例子都有github的demo 为准

import {  getGlobalizationDateFormat,getGlobalizationTimeFormat,getGlobalizationDateFormatString } from ac-format;
 
let d = '2020/02/06 14:30:06'; 

//转东八区时间
value = getGlobalizationDateFormat(d,datetime,"UT+8:00",true)

//获取上下文时间
value = getGlobalizationDateFormat(d,datetime)

let _t = '14:30:06';
//获取上下文时间
value = getGlobalizationTimeFormat(_t);

value = getGlobalizationFormatNumber('1000003.45656');

//根据时区转换,输入、输出都是字符串(demo4)
let toFormat = 'YYYY-MM-DD HH:mm:ss';
let utc8 = "UTC+08:00";
let  {value:__value} = getGlobalizationDateFormatString(this.state.value,null,utc8,'datetime');
let  {value:__value2,format} = getGlobalizationDateFormatString(__value,utc8,"UTC+07:00",'datetime');
  

注意事项

bee-input-number>2.2.21 必须安装 moment 对象。

更新日志