根据区域设置格式化 GMT/UTC 时间/日期

# gmstrftime

(PHP 4, PHP 5, PHP 7, PHP 8)

gmstrftime — 根据区域设置格式化 GMT/UTC 时间/日期

警告

该函数自 PHP 8.1 起弃用。强烈建议不要依赖此函数。

此函数可以使用如下替代：

- gmdate()
- IntlDateFormatter::format()

### 说明

#[\Deprecated]
function gmstrftime(string `$format`, ?int `$timestamp` = null): string|false

行为和 strftime() 相同，只是返回的时间是格林威治标准时（GMT）。例如，在东部标准时（EST，GMT -0500）运行时，下面第一行显示“Dec 31 1998 20:00:00”，而第二行显示“Jan 01 1999 01:00:00”。

警告

此函数依赖于操作系统区域设置信息，这些信息可能彼此不一致，或者根本不能用。而是使用 IntlDateFormatter::format() 方法。

### 参数

`format`

  See description in strftime().

`timestamp`
  可选的 `timestamp` 参数是一个 int 的 Unix 时间戳，如未指定或是 `null`，参数值默认为当前本地时间。也就是说，其值默认为 time() 的返回值。

### 返回值

根据指定的格式字符串使用指定的 `timestamp` 或当前本地时间（若未提供时间戳）返回格式化的字符串。月份、星期名称及其他与语言相关的字符串遵循通过 setlocale() 设置的当前区域。失败时返回 `false`。

### 更新日志

版本 | 说明
--- | ---
8.0.0 | 现在 `timestamp` 允许为 null。

### 示例

示例 #1 gmstrftime() 示例

    <?php
    setlocale(LC_TIME, 'en_US');
    echo strftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";
    echo gmstrftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";

### 参见

- IntlDateFormatter::format() - Format the date/time value as a string
- DateTimeInterface::format() - 按照指定格式返回格式化后的日期
- strftime() - 根据区域设置格式化本地时间/日期

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open