notime

v1.2.6

Published

4 years ago

A js lib,for date,time, format,timezone,etc , support for no limit time.i,hope

0High
0Medium
0Low

lakepx

date js-libs timezone notime gmt time date-formatting

notime

A js lib,for date,time, format,timezone,etc , support for no limit time.i,hope

是一个小的js的时间处理工具库，可用来处理极大或极久远的时间，精确到毫秒。或可用来格式化时间，转化时间，初始化时间，获取时间，记录时间的间隔，进行时区的时间转换等

Email: [email protected]

使用：


var nt = require('notime');  // node require进去

//获取当前时间
nt.getnowts();
//得到一个json对象如下：
/*
{ 
    strts: '1500017861106',
    numts: 1500017861106,
    objts:{ 
      yy: '2017',
      mm: '07',
      dd: '14',
      hh: '15',
      mi: '37',
      ss: '41',
      ms: '106'
    } 
}
*/

// 得到当前时间戳 
// 10位 unix秒的时间戳
console.log(
	nt.getnowts().strts.substr(0,10)  /* '1500618707' */
);
// 13位 毫秒计数的时间戳
console.log(
    nt.getnowts().strts  /* '1500618707330' */
);


// 将时间戳转化指定格式的字符串

// 1500618707330 -> 2017-07-21 14:31:47:330
console.log(
	nt.strtstotext('1500618707330')
);

// 1500618707330 -> 2017-07-21
console.log(
	nt.strtstotext('1500618707330',{hh:false,mi:false,ss:false,ms:false})
);

// 1500618707330 -> 14:31
console.log(
	nt.strtstotext('1500618707330',{yy:false,mm:false,dd:false,ss:false,ms:false})
);
//...

// 将常用的时间形式转换为时间戳
// 2017-07-21 -> 1500566400000
console.log(
	nt.convts('2017-07-21').strts
);

// 2017-07-21 14:31:47 -> 1500618707000
console.log(
	nt.convts('2017-07-21 14:31:47').strts
);
// ...

//將 4分30秒转化为毫秒数
// {mi:'04',ss:'30'} -> 270000
console.log(
	nt.rolltoms({mi:'04',ss:'30'})
);
//...

// 把毫秒转化为时长
// 3456532243 -> { yy:'0000', mm:'01', dd:'10', hh:'00', mi:'08', ss:'52', ms:'243' }
console.log(
	nt.msconv('3456532243')
);
// 得到多少天
// 3456532243 （ms） -> 40 （天）
console.log(
	nt.msconvto('3456532243','dd').cnt
);

// 把时间进行时区换算
// 东一区 2017-05-01 10:30  ->  东八区 2017-05-01 17:30
nt.tzset('E1');
var e1ts = nt.convts('2017-05-01 10:30').strts;
nt.tzset('E8');
var e8time = nt.strtstotext(e1ts,{ss:false,ms:false});
console.log(e8time); // 2017-05-01 17:30
// ...

// 极长和极早的时间支持
// 53917-07-21 10:30:50 -> 1639305138650000
console.log(
	nt.convts('53917-07-21 10:30:50').strts
);

// -54830513865000 -> 232-06-28 21:42:15
console.log(
	nt.strtstotext('-54830513865000',{ms:false})
);


// 得到昨天 24小时之前的时间
var yesterdayts = nt.timeminus( nt.getnowts().strts, nt.rolltoms({dd:'1'}) ); 
console.log(
	nt.strtstotext( yesterdayts)
);

// 得到最近n天的日期 
function lastnday(n) {
	var cuts = nt.getnowts().strts;
	var ts, str, arr = [], cuday;
	for(var i = 1;i<=n;i++ ){
		cuday = i.toString();
		ts = nt.timeminus( cuts, nt.rolltoms({dd: cuday}) );
		str = nt.strtstotext( ts,{hh:false,mi:false,ss:false,ms:false} );
		arr.push(str);
	}
	return arr;
}

// 最近一周的日期的数组
console.log( lastnday(7) );
/*
[ 
'2017-07-20',  '2017-07-19',  '2017-07-18',  
'2017-07-17',  '2017-07-16',  '2017-07-15',  '2017-07-14' 
]
*/

// 最近30天的日期的数组
console.log( lastnday(30) );
// ...

详情参见utest.js

note:

broswer-version: 纯js在页面前端使用可引用单文件 notime-broswer.js
node-version: 在nodejs服务器端使用notime.js require('notime')
在es6里使用: 可引入 notime-es6.js
（ // 当然一般来说因为前端的一些打包工具的原因，也可以直接：

> npm i notime  (npm命令行安装)
import notime from 'notime'  //页面内使用
notime.getnowts()  // ...

）

方法索引：

逻辑结构：

定义了4种时间模型，包括3种通用模型和1种自然语言模型,模型精确到毫秒

1.objts: (对象形式)

{
  yy:numstr,
  mm:numstr,
  dd:numstr,
  hh:numstr,
  mi:numstr,
  ss:numstr,
  ms:numstr
}

由于js使用53个2进制为存储整数部分，使用IEEE754双精度浮点数标准，所以数字的范围为js最大的安全整数范围：即： Number.MAX_SAFE_INTEGER +-/9007199254740991 （ (2^53)-1 ）

但这里并没有这个限制，因为键值是数字的字符串形式其中月份(mm)的范围是01-12 天数(dd)的范围是01-31

2.strts （字符串形式）

"12312123123222222222222223334444..."

一个字符串，存储从unix纪元1970年1月1日起的毫秒数，字符串的长度理论上不受限制，可用来表示和用于极大的数字时间，不受固定位长的数字类型的限制

3.numts （数字形式）纯数字，同strts一样表示毫秒数时间戳，但有范围，即+-/9007199254740991 （285,616.414年+1970）约28万年自1970年1月1日加上或减去273785年的时间

4.自然语言模型 （字符串形式）
包括以下几个例子

2010-10-10
2010-10-10 10:12 
2010-10-10 10:12:12 
2010-10-10 10:12:12:233

定义了几类方法和一个角度，来操作和处理上述的四种模型

1.获取和重置当前时间：

getnowts
resetnow

2.自然语言时间模型和通用模型之间的转换

convts
strtstotext
objtstotext
numtstotext

3.通用时间模型之间的转换

objtostrts
strtoobjts
numtostrts

4.时间的操作和运算

timeplus: 处理一段时间的计算 strts + 一定毫秒数 返回strts对象
timeminus: 处理一段时间的计算 strts - 一定毫秒数 返回strts对象
timespace: 处理一段时间的计算 strts与strts 返回它们之间相距的时间距离毫秒数
msconv:  处理一段时间的计算 将一定毫秒数 转化为多少年多少月..几时几分几秒 返回 一个对象
msconvto: 处理一段时间的计算 将一定毫秒数 转化为xx天 或者 xx秒等
rolltoms: 处理一段时间的计算 将多少天 多少小时 转化为多少毫秒数

5.一个角度时区：对于自然语言时间模型的概念会有一个时区设置方法，以输出多角度的当前时间模型，有以下3个方式设置时区角度默认时区：东八区，北京，480

tzset  E1-E12 W1-W12 WE0  25个时区范围东1到东12区，西1到西12区
tzmiset 设置与GMT时间的偏移分钟数 +/-480
tzcityset  设置以某个城市拼写所在的时区为准，

支持以下城市：

tzcityset :查看支持城市

此外还有一些透明的辅助工具方法，被以上这些暴露出去的使用方法所调用。统一归纳在util对象下实现:

bnplus   大数加法
bnminus  大数减法
bnmultip 大数乘法
bndivis  大数除法
bnmod    大数取余
bnisnega    判断是否是负数
bnabscomp   比较两数的绝对值大小

API

getnowts

方法描述：用来获取当前时间，返回1个json对象，里面有3种格式的当前时间（strts,numts,objts）

输入：无输入参数

输出:

{ strts: '1503989677195',
  numts: 1503989677195,
  objts: {
    yy: '2017',
    mm: '08',
    dd: '29',
    hh: '14',
    mi: '54',
    ss: '37',
    ms: '195' 
  } 
}

resetnow

用来重置当前时间，一旦设定该项后，会启用内置的定时器，每隔500ms更新一次getnowts获取到的当前时间,默认getnowts获取当前时间使用的js的new Date(); 若调用过该方法重置后，则会使用重置的时间为起点自动更新当前时间

输入： '1503989677195'

无输出

convts

用来将输入的，或者人类便于理解的自然语言格式的时间字符串转化为3种通用的时间模型（strts,numts,objts）支持以下4种格式的字符串

输入：

    2010-10-10
    2010-10-10 10:12 
    2010-10-10 10:12:12 
    2010-10-10 10:12:12:233

格式:年：1位或1位以上月：01-12或者1-12都可以日：01-31 或者1-31 时：01-23或者1-23 分秒：01-59或者1-59 毫秒：01-999或者1-999

输出：

{
  objts:{ 
    yy: '2010',
    mm: '01',
    dd: '10',
    hh: '00',
    mi: '00',
    ss: '00',
    ms: '000'
  },
  strts: '1263139200000',
  numts: 1263139200000
}
// 或者格式不对 返回 'no'

strtstotext

用来将给出的strts 转化为想要的便于人类理解的字符串时间格式，该方法接收2个参数，一个必填参数和一个可选的参数对象，用来定制输出字符串的格式

输入：参数1: strts: "2342432423423432432"

参数2： format: {yy:true,mm:true,dd:true,hh:true,mi:true,ss:true,ms:true,ymdf:'-',hmsf:':'}

yy:true/false 表示是否输出年份 //年份可能是4位或以上 ymdf: 表示年月日之间的分隔符采用什么 hmsf: 表示时分秒毫秒之间的分隔符采用什么

返回：形如： "2010-10-10 10:12:12:233" 之类的格式

objtstotext

用来将给出的objts 转化为想要的便于人类理解的字符串时间格式，该方法接收2个参数，一个必填参数和一个可选的参数对象，用来定制输出字符串的格式

参数1: objts: {yy:1995,mm:1,dd:20,hh:12,mi:30,ss:59,ms:0}

参数2： format: 默认值： {yy:true,mm:true,dd:true,hh:true,mi:true,ss:true,ms:true,ymdf:'-',hmsf:':'}

yy:true/false 表示是否输出年份 //年份可能是4位或以上 ymdf: 表示年月日之间的分隔符采用什么 hmsf: 表示时分秒毫秒之间的分隔符采用什么 mm,dd,hh,mi,ss,ms可以为'03'-xx 或'0'-xxx或0-xxx

返回：形如： "2010-10-10 10:12:12:233" "2010-10-10 10:12:12:003" 之类的格式

numtstotext

同上的strtstotext方法，只是传的第一个参数是一个数字该方法实现采用js原生的Date对象实现，理论上处理速度应该会更快一点

objtostrts

将 objts 转换为 strts

输入：

{
  yy: '2010',
  mm: '01',
  dd: '10',
  hh: '01',
  mi: '00',
  ss: '23',
   ms: '056' 
}

格式: yy:'0'-xxx或者0-xxx mm可以为'01'-'12'或者'1'-'12'或者数字1-12 dd: '01'-31或'1'-'31'或1-31 hh:'00'-'23'或'0'-'23' mi,ss:'00''59'或'0'-'59'或0-59
ms:'000'-'999' 或'0'-'999' 或0-999

输出：'1263142823056'

strtoobjts

objtostrts的反向转换

numtostrts

将numts 转化为 strts

timeplus

处理并得到在某时间点上增加多长时间后的时间，接收两个参数，

参数1： strts

参数2：一定时间的毫秒数String 如： '12312323'

返回:新的strts

timeminus

参数1： strts

参数2：一定时间的毫秒数String 如： '12312323'

返回:新的strts

timespace

得到时间轴上两个时间点之间相距的时间,返回以毫秒计数的字符串

参数1： strts

参数2： strts

返回：这中间的这段时间的毫秒数形如 '23433433332'

msconv

将以毫秒计数的一段时间的字符串转化为多少天多少小时的形式，注意这里返回的按每月30天每年365天的形式计算返回，所以对于公历闰年，大小月而言是有小误差的

参数1： '234343333'

返回：形如：{yy:'0000',mm:'00',dd:'12',hh:'03',mi:'30',ss:'01',ms:'000'}

msconvto

按指定的时间单位来将一段毫秒数时间划分，余数不足的部分会被直接忽略

参数1： '123321313123123' 表示一段时间的毫秒数

参数2： 'yy' || 'mm' || 'dd' || 'hh' || 'mi' || 'ss'

返回：如：{cnt:'50',ret:'xxx',code:'yes'} // cnt 代表多少数量的该单位 ret代表该单位后的余数毫秒数 code:yes/no 是否成功

rolltoms

将多少年，多少月之类的形式反过来转化为一定毫秒数，msconv的逆向方法

输入： {dd:123,...} // dd,yy,mm,mi,hh,ss均为可选项

格式: yy(可选):'1'-xxx或者1-xxx mm,dd,hh,mi,ss（可选）:'01'-xxx或者'1'-xxx或1-xxx

输出： '3453324343242' // 代表毫秒数

tzset

设置转化为自然语言时，格式化输出的时间处于哪一个当前时区，默认时区：E8

7.5W-7.5E 中时区零时区经度每15度一个时区,东12区和西12区重合,中间180度经线为国际日期变更线

东12区为8日，西12区为7日

由西向东越过日期变更线即：东12->西12 -1日,

由东向西越过即:西12->东12 +1日

参数: 'WE0/ E1'/'E2'.../'E12'/'W1'/.../'W12' // 东西12个时区和零时区（中时区WE0）

tzmiset

设置与GMT时间的偏移分钟数

参数： 480/-30 //可为正数或负数

tzcityset

设置当前采用全球某个主要城市的时区实际上，世界上不少国家和地区都不严格按时区来计算时间。为了在全国范围内采用统一的时间，一般都把某一个时区的时间作为全国统一采用的时间。

例如，我国把首都北京所在的东8区的时间作为全国统一的时间，称为北京时间。

又例如，英国、法国、荷兰和比利时等国，虽地处中时区，但为了和欧洲大多数国家时间相一致，则采用东1区的时间。

参数： 'beijing'/... //主要城市的拼音或英文名参数支持范围如下:

beijing(中国-北京+8) 480,  hongkong(中国-香港+8) 480, Honolulu(美国-夏威夷檀香山-10) -600, alaska(美国-阿拉斯加-8) -480,
sanfrancisco(美国-旧金山-8) -480,     henei(越南-河内+7)   420, huzhiming(越南-胡志明+7) 420, dubai(迪拜+4) 240, 
kabul(阿富汗-卡布+4) 240, cairo(埃及-开罗+2) 120, seoul (韩国-首尔汉城+9) 540, moscow(俄罗斯-莫斯科+3) 180

GMT: 格林尼治标准时间 GMT使用地球公转和自转作为标准现世界已使用utc代替，utc使用国际原子时钟作为标准但gmt的时区仍然在utc中延用，协调世界时区会使用“Z”

中国北京时间 gmt+8 utc+8都是一样的意思,

国际原子时间精度每日数纳秒世界协调时精度精确到毫秒

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

notime

Email: [email protected]

使用：

方法索引：

逻辑结构：

定义了4种时间模型，包括3种通用模型和1种自然语言模型,模型精确到毫秒

定义了几类方法和一个角度，来操作和处理上述的四种模型

API

getnowts

resetnow

convts

strtstotext

objtstotext

numtstotext

objtostrts

strtoobjts

numtostrts

timeplus

timeminus

timespace

msconv

msconvto

rolltoms

tzset

tzmiset

tzcityset