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 ，仍然使用了经典语法，方便直接在浏览器中引用。