XiongLiding / litdate

litdate

一个非常简单的时间处理工具

目标

与语言无关的时间处理工具，本身没有多语言支持但可以方便的结合中文使用，使用客户端的时区

安装

现在可以通过 npm 安装和使用 litdate 了。

npm install @xiongliding/litdate

node

const litdate = require('litdate');

webpack 等

import litdate from 'litdate';

用法

var ld = litdate(); // 当前时间
ld.Y // 2017;
ld.format('Y-m-d H:i:s'); // 2017-12-05 22:16:07

var ld20170101 = litdate(new Date(2017, 0, 1, 22, 16, 7)); // 传入 Date 对象
ld20170101.format('y年n月j日 G时I分S秒'); // 17年1月1日 22时16分7秒

更多用法可参考 test.js 中的测试用例。

属性与方法

内容基本参照了 php 的日期页面，但由于不需要支持语言和时区，把 Z I S e 的用途做了改变。

无前导 0 的为数值类型，前导 0 的为字符串类型。

属性	描述	例子	备注
日	----	----	----
d	每月的几号，2 位数字，前导 0	01 到 31
j	每月的几号，无前导 0	1 到 31
N	ISO-8601 周日历，每周第几天	1(周一)到 7(周日)
w	每周第几天	0(周日)到 6(周六)
z	每年第几天(从 0 开始)	0 到 365
Z	每年第几天(从 1 开始)	1 到 366	变化
周	----	----	----
W	ISO-8601 周日历第几周，每周从周一开始，前导 0	01-53
e	ISO-8601 周日历第几周，每周从周一开始，无前导 0	1-53	变化
月	----	----	----
m	月份，前导 0	01-12
n	月份，无前导 0	1-12
t	本月有几天	28-31
年	----	----	----
L	是否闰年	闰年 1，否则 0
o	ISO-8601 周日历中的年份，一般和 Y 相同，年初和年尾的那周可能不同	例子：1999、2003
Y	年份，4 位数字	例子：1999、2003
y	年份，2 位数字	例子：99、03
时间	----	----	----
a	午前午后	am pm
A	午前午后	AM PM
g	12 小时制，无前导 0	1 到 12	12 小时制没有 0 点
G	24 小时制，无前导 0	0 到 23
h	12 小时制，前导 0	01 到 12	12 小时制没有 0 点
H	24 小时制，前导 0	00 到 23
i	分，前导 0	00 到 59
I	分，无前导 0	0 到 59	变化
s	秒，前导 0	00 到 59
S	秒，无前导 0	0 到 59	变化

方法	描述	例子
format	将字符串中与属性名匹配的部分替换成数值	ld.format('Y-m-d') => '2017-12-05'

测试

npm run test

变更

现在主流环境都支持 ES6 语法，因此 litdate.js 也改用了新语法，尽管没什么实质性的提升。 新版本使用了 CommonJS 风格的 module.exports ，因为此方法兼容 node 和 webpack 等工具，但不能直接放到浏览器中运行。 等 node 默认支持 ES 标准的模块管理一段时间后，会将其改为 export 的形式。

早先的版本被更名为 litdate.legacy.js ，仍然使用了经典语法，方便直接在浏览器中引用。