# moment-ago

> 人性化显示时间相对现在过去多久

Latest version **1.2.3** (published 2019-01-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install moment-ago
pnpm add moment-ago
yarn add moment-ago
bun add moment-ago
```

## Health

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

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.3 |
| Published | 2019-01-14 |
| First published | 2018-09-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 265.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | andesome |
| Maintainers | andesome |
| Keywords | timeAgo, moment, dayjs, momentAgo |

## Links

- npm: https://www.npmjs.com/package/moment-ago
- Repository: https://github.com/Andesome/moment-ago
- Homepage: https://github.com/Andesome/moment-ago#readme
- Issues: https://github.com/Andesome/moment-ago/issues
- npm.io page: https://npm.io/package/moment-ago

## Dependencies (1)

- [dayjs](https://npm.io/package/dayjs.md) ^1.7.7

## Alternatives

- [@js-joda/timezone](https://npm.io/package/@js-joda/timezone.md) — 383.4K weekly downloads
- [chartjs-adapter-moment](https://npm.io/package/chartjs-adapter-moment.md) — 210.8K weekly downloads
- [strftime](https://npm.io/package/strftime.md) — 171.2K weekly downloads
- [vue-flatpickr-component](https://npm.io/package/vue-flatpickr-component.md) — 115.8K weekly downloads
- [timepicker](https://npm.io/package/timepicker.md) — 51.0K weekly downloads

## Recent versions

- 1.2.3 (latest) — 2019-01-14
- 1.2.2 — 2019-01-10
- 1.2.1 — 2019-01-10
- 1.2.0 — 2018-10-13
- 1.1.0 — 2018-10-13
- 1.0.0 — 2018-10-03
- 0.0.7 — 2018-10-03
- 0.0.6 — 2018-10-03
- 0.0.5 — 2018-09-30
- 0.0.4 — 2018-09-30
- 0.0.3 — 2018-09-30
- 0.0.2 — 2018-09-29
- 0.0.1 — 2018-09-29

## README

## momentAgo

人性化显示已过去时间

## 规则

```
// -------------规则描述------------------
/**
 * 1.时间的转义：
 *
 * 60秒以内： “多少秒前”
 *
 * 1小时内:“xx分钟前”
 *
 * 1小时后，24小时前：“xx小时前”
 *
 * 24小时后，48小时前：“昨天  xx：xx”
 *
 * 48小时后，72小时前：“前天  xx：xx”
 *
 * 72小时后，一年内：“xx-xx xx：xx”
 *
 * 一年前："xxxx-xx-xx  xx：xx"
 */
// --------------------------------------
```

## Install

`yarn add moment-ago`  
或者  
`npm install moment-ago`


## 使用

nodejs
```
const momentAgo = require("moment-ago");
```

ES6
```
import momentAgo from("moment-ago");

```

使用
```
//刚刚
momentAgo(new Date()).ago();

//5秒前
momentAgo(new Date() - 5000).ago();

//1分钟前
momentAgo(new Date() - 60 * 1000).ago()

// 1小时前
momentAgo("2018-09-30 09:30:23").ago() 
...

//未来
momentAgo(new Date() + 60 * 1000).ago()

//刚刚
> adjust 时差绝对值小于矫正值，显示刚刚
momentAgo(new Date() + 60 * 1000, { adjustVal: 60 }).ago()

```

## API

- momentAgo().ago()
```
momentAgo('2018-08-08') // 解析

momentAgo(new Date()).ago() //刚刚


// ----- 传入时间戳 ---------
momentAgo(new Date().valueOf() - 1000).ago({ adjustVal: 0 }) // 1秒前

momentAgo(new Date().valueOf() - 5000).ago({ adjustVal: 0 }) // 5秒前

momentAgo(new Date().valueOf() - 5000).ago({ adjustVal: 5 }) // 刚刚

// ------ 传入一个标准的ISO 8601时间字符串-----
momentAgo("2018-09-30 10:35:23").ago() // 17秒前

momentAgo("2018-09-30 10:30:23").ago() // 6分钟前

momentAgo("2018-09-30 09:30:23").ago() // 1小时前
```

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