# @wedjs/date

> ----

Latest version **1.0.0-Alpha.7** (published 2020-09-19) · 0 weekly downloads

## Install

```sh
npm install @wedjs/date
pnpm add @wedjs/date
yarn add @wedjs/date
bun add @wedjs/date
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0-Alpha.7 |
| Published | 2020-09-19 |
| First published | 2020-09-15 |
| Weekly downloads | 0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 6.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | w_494917128 |
| Maintainers | w_494917128 |

## Links

- npm: https://www.npmjs.com/package/@wedjs/date
- npm.io page: https://npm.io/package/@wedjs/date

## Dependencies (2)

- [clean-webpack-plugin](https://npm.io/package/clean-webpack-plugin.md) ^3.0.0
- [terser-webpack-plugin](https://npm.io/package/terser-webpack-plugin.md) ^4.2.0

## Recent versions

- 1.0.0-Alpha.7 (latest) — 2020-09-19
- 1.0.0-Alpha.4 — 2020-09-18
- 1.0.0-Alpha.2 — 2020-09-17
- 1.0.0-Alpha.1 — 2020-09-16
- 1.0.0-Alpha.0 — 2020-09-15

## README

# @wedjs/date

----

## 介绍

参考了 PHP 的 date 方法，实现了 **时间戳转换为时间格式** 的方法。

----

## 安装

通过 `NPM` 安装：
``` base
npm i @wedjs/date
```
或者 直接引用 `CDN`：
``` html
<script src="https://cdn.wangerdi.cn/wedjs/date.js"></script>
```

----

## 使用

> #### _.date(format, timestamp)

时间戳转换为时间格式，返回字符串。

##### 参数

| 参数名 | 类型 | 默认值 | 是否必填 | 描述 |
| --- | --- | --- | --- | --- |
| format | String |  | 必填 | 规定输出日期字符串的格式（例：'Y-m-d H:i:s'） |
| timestamp | Number | 当前时间戳 | 选填 | 规定整数的 Unix 时间戳（精确到毫秒） |

##### format参数对应的字符

- d - 一个月中的第几天（从 01 到 31）
- D - 星期几的文本表示（用三个字母表示）
- j - 一个月中的第几天，不带前导零（1 到 31）
- l（'L' 的小写形式）- 星期几的完整的文本表示
- N - 星期几的 ISO-8601 数字格式表示（1 表示 Monday[星期一]，7 表示 Sunday[星期日]）
- S - 一个月中的第几天的英语序数后缀（2 个字符：st、nd、rd 或 th。与 j 搭配使用）
- w - 星期几的数字表示（0 表示 Sunday[星期日]，6 表示 Saturday[星期六]）
- z - 一年中的第几天（从 0 到 365）
- W - 用 ISO-8601 数字格式表示一年中的星期数字（每周从 Monday[星期一]开始）
- F - 月份的完整的文本表示（January[一月份] 到 December[十二月份]）
- m - 月份的数字表示（从 01 到 12）
- M - 月份的短文本表示（用三个字母表示）
- n - 月份的数字表示，不带前导零（1 到 12）
- t - 给定月份中包含的天数
- L - 是否是闰年（如果是闰年则为 1，否则为 0）
- Y - ISO-8601 标准下的年份数字
- y - 年份的两位数表示
- a - 小写形式表示：am 或 pm
- A - 大写形式表示：AM 或 PM
- g - 12 小时制，不带前导零（1 到 12）
- G - 24 小时制，不带前导零（0 到 23）
- h - 12 小时制，带前导零（01 到 12）
- H - 24 小时制，带前导零（00 到 23）
- i - 分，带前导零（00 到 59）
- e - 分，不带前导零（0 到 59）
- s - 秒，带前导零（00 到 59）
- c - 秒，不带前导零（0 到 59）
- u - 微秒
- I（i 的大写形式）- 日期是否是在夏令时（如果是夏令时则为 1，否则为 0）

##### 示例

``` js
_.date('Y-m-d H:i:s', 1577808000000); // "2020-01-01 00:00:00"
_.date('y-n-j G:e:c (l)', 1577808000000); // "20-1-1 0:0:0 (Wednesday)"
```

---
_Source: https://npm.io/package/@wedjs/date · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._