# litdate

**Repository Path**: czmagic/litdate

## Basic Information

- **Project Name**: litdate
- **Description**: 一个非常简单但强大的时间处理工具，模拟了PHP中的date函数
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 6
- **Created**: 2018-04-12
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 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' |

## 测试

```
mocha test.js
```