---
order: 7
---

# 🍍 日期转换

::: tip
用于爬虫爬取网页或第三方程序对接时,时间格式不统一的转换
:::

## format()

### 任意格式时间转换为指定格式

#### 参数

|    参数    |          描述           |        是否必须        |
|:--------:|:---------------------:|:------------------:|
|  format  | 日期格式,用法与系统函数date()的一致 | 可选, 默认为Y-m-d H:i:s |
| datetime |    任意类型的字符串时间或时间戳     |    可选, 默认为当前时间     |

#### 返回值

> 指定格式的时间字符串

#### 示例代码

```php
/* 将以下日期转换为中国常用的日期格式 */
TimeHelper::format('Y-m-d H:i:s','May 3, 2022 12:01:33');
// 2022-03-03 12:01:33

/* 将时间戳转换为西方常用的日期格式 */
TimeHelper::format('F j, Y, g:i a',1698762509);
// October 31, 2023, 10:28 pm
```

## isTimestamp()

### 判断字符串或数字是否为时间戳

#### 参数

|    参数     |     描述     | 是否必须 |
|:---------:|:----------:|:----:|
| timestamp | 要判断的字符串或数字 |  必须  |

#### 返回值

> 如果是时间戳则返回`true`,否则返回`false`

#### 示例代码

```php
/* 判断以下字符串是否为时间戳 */
TimeHelper::isTimestamp('1646360133');
// true

/* 判断以下数字是否为时间戳 */
TimeHelper::isTimestamp(164636013);
// false
```

## toTimestamp()

### 任意格式时间转换为时间戳

#### 参数

|    参数    |       描述       |    是否必须     |
|:--------:|:--------------:|:-----------:|
| datetime | 任意类型的字符串时间或时间戳 | 可选, 默认为当前时间 |

#### 返回值

> 转换后的时间戳

#### 示例代码

```php
/* 将以下日期转换为时间戳 */
TimeHelper::toTimestamp('Apr 11, 2020');
// 1586534400

/* 将不规则的日期转换为时间戳 */
TimeHelper::toTimestamp('2023年9月 5点');
// 1693515600
```

## modifyTimestamp()

### 根据日期字符串, 修改指定时间

#### 参数

|    参数    |       描述       |    是否必须     |
|:--------:|:--------------:|:-----------:|
| modifier |    日期修改字符串     |     必须      |
| datetime | 任意类型的字符串时间或时间戳 | 可选, 默认为当前时间 |

#### 返回值

> 修改后的日期时间戳

#### 示例代码

```php
/* 将指定日期增加一天 */
TimeHelper::modifyTimestamp('+1 day', '2023-9-1 12:00:00');
// 1693627200
```

## now()

### 获取当前时间

#### 参数

|   参数   |          描述           |        是否必须        |
|:------:|:---------------------:|:------------------:|
| format | 日期格式,用法与系统函数date()的一致 | 可选, 默认为Y-m-d H:i:s |

#### 返回值

> 指定格式的当前时间

#### 示例代码

```php
/* 获取当前时间 */
TimeHelper::now();
// 2024年7月2日 10:01:33

/* 获取指定格式的当前时间 */
TimeHelper::now('M d, Y H:i:s');
// July 2, 2024 10:01:33
```