# time-formatting

**Repository Path**: nmgwap/time-formatting

## Basic Information

- **Project Name**: time-formatting
- **Description**: 时间格式化插件
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2022-11-07
- **Last Updated**: 2024-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## nmgwap-time-formatting

> 时间格式化插件，返回指定字符串

## 安装

```js
npm i nmgwap-time-formatting
```

## 导入

```js
import {
  getY,
  getM,
  getD,
  getYMD,
  getYMDHM,
  getYMDHMS,
  getMD,
  getHM,
  getHMS,
  getTimeStamp
} from "nmgwap-time-formatting";
```

### 获取年

```js
// 获取当前
let y = getY(); // 2022
// 获取指定 - 时间戳
let y = getY(1667801172090); // 2022
// 获取指定 - 字符串格式
let y = getY("2022-10-10"); // 2022
let y = getY("2022-10-10 10:10:10"); // 2022
let y = getY("Mon Nov 07 2022 15:24:23 GMT+0800 (中国标准时间)"); // 2022
```

### 获取月

> 参数同上，自动补全到两位

```js
let m = getM(); // 11
```

### 获取日

> 参数同上，自动补全到两位

```js
let d = getD(); // 01
```

### 获取年月日

> 两个参数，都是可选参数

- date:时间格式，支持字符串、时间戳
- connector：连接符号，默认“-”，如果是字符串“HZ”，则返回格式为汉字年月日

```js
let ymd = getYMD("2020-10-10", "/"); // 2020/10/10
let ymd = getYMD("2020-10-10", "HZ"); // 2020年10月10日
```

### 获取月日

> 两个参数，都是可选参数

- date:时间格式，支持字符串、时间戳
- connector：连接符号，默认“-”，如果是字符串“HZ”，则返回格式为汉字月日

```js
let md = getMD("2020-10-10", "/"); // 10/10
let md = getMD("2020-10-10", "HZ"); // 10月10日
```

### 获取年月日时分

> 两个参数，都是可选参数

- date:时间格式，支持字符串、时间戳
- connector：连接符号，默认“-”，如果是字符串“HZ”，则返回格式为汉字年月日时分

```js
let ymdhm = getYMDHM("2020-10-10", "/"); // 2020/10/10 08:00
let ymdhm = getYMDHM("2020-10-10", "HZ"); // 2020年10月10日08时00分
```

### 获取年月日时分秒

> 两个参数，都是可选参数

- date:时间格式，支持字符串、时间戳
- connector：连接符号，默认“-”，如果是字符串“HZ”，则返回格式为汉字年月日时分秒

```js
let ymdhms = getYMDHMS("2020-10-10", "/"); // 2020/10/10 08:00:00
let ymdhms = getYMDHMS("2020-10-10", "HZ"); // 2020年10月10日08时00分00秒
```

### 获取时分

> 两个参数，都是可选参数

- date:时间格式，支持字符串、时间戳
- connector：连接符号，默认“:”，如果是字符串“HZ”，则返回格式为汉字时分

```js
let hm = getHM("2020-10-10", "/"); // 08:00
let hm = getHM("2020-10-10", "HZ"); // 08时00分
```

### 获取时分秒

> 两个参数，都是可选参数

- date:时间格式，支持字符串、时间戳
- connector：连接符号，默认“:”，如果是字符串“HZ”，则返回格式为汉字时分秒

```js
let hms = getHMS("2020-10-10", "/"); // 08:00:00
let hms = getHMS("2020-10-10", "HZ"); // 08时00分00分
```

### 获取时间戳

> 一个参数，为可选参数

- date:时间格式，支持字符串

```js
let timeStamp = getTimeStamp("2020-10-10"); // 1602288000000
```