# `naisi_get_utc_date`

按指定时区格式化时间；$time 为 null 时使用当前时间。

## 函数签名

```php
function naisi_get_utc_date(string $format, int|string|null $time = null, int $timezone = NAISI_TIMEZONE_PRC): string
```

## 调用前提

应用入口先调用 [naisi_is_ext_license_valid](/web/developers/naisilib/naisi-is-ext-license-valid) 并确认返回 `true`。只验证同一请求内已有的有效 FULL/BASIC 证明；没有证明或证明失效时立即返回失败值，不现场补做完整校验。

授权类别：`LICENSE`；执行模式：`PROOF`。许可不代替登录、租户或权限上下文；身份与数据要求见本页参数及用途说明。

## 参数

### `$format`

- 类型：`string`
- 必填：是
- 默认值：无
- 方向：输入参数。

日期时间输出格式，遵循 PHP 日期格式字符约定。

### `$time`

- 类型：`int|string|null`
- 必填：否
- 默认值：`null`
- 方向：输入参数。

时间文本、Unix 时间戳或 null；允许的形式由当前函数签名限定。

### `$timezone`

- 类型：`int`
- 必填：否
- 默认值：`NAISI_TIMEZONE_PRC`
- 方向：输入参数。

NAISI_TIMEZONE_* 整数常量；默认 NAISI_TIMEZONE_PRC（1，Asia/Shanghai），UTC 使用 NAISI_TIMEZONE_UTC（0）。不接收 IANA 名称字符串。

## 返回值

类型：`string`

返回处理后的字符串；未授权或处理失败时按接口契约返回空字符串。

## 关联常量

- [`NAISI_TIMEZONE_UTC`](/web/developers/naisilib/const#naisi-timezone-utc) = `0` — NAISI_TIMEZONE_UTC 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_PRC`](/web/developers/naisilib/const#naisi-timezone-prc) = `1` — NAISI_TIMEZONE_PRC 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_SHANGHAI`](/web/developers/naisilib/const#naisi-timezone-asia-shanghai) = `1` — NAISI_TIMEZONE_ASIA_SHANGHAI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_HONG_KONG`](/web/developers/naisilib/const#naisi-timezone-asia-hong-kong) = `2` — NAISI_TIMEZONE_ASIA_HONG_KONG 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_MACAU`](/web/developers/naisilib/const#naisi-timezone-asia-macau) = `3` — NAISI_TIMEZONE_ASIA_MACAU 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_TAIPEI`](/web/developers/naisilib/const#naisi-timezone-asia-taipei) = `4` — NAISI_TIMEZONE_ASIA_TAIPEI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_TOKYO`](/web/developers/naisilib/const#naisi-timezone-asia-tokyo) = `5` — NAISI_TIMEZONE_ASIA_TOKYO 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_SEOUL`](/web/developers/naisilib/const#naisi-timezone-asia-seoul) = `6` — NAISI_TIMEZONE_ASIA_SEOUL 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_SINGAPORE`](/web/developers/naisilib/const#naisi-timezone-asia-singapore) = `7` — NAISI_TIMEZONE_ASIA_SINGAPORE 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_KUALA_LUMPUR`](/web/developers/naisilib/const#naisi-timezone-asia-kuala-lumpur) = `8` — NAISI_TIMEZONE_ASIA_KUALA_LUMPUR 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_BANGKOK`](/web/developers/naisilib/const#naisi-timezone-asia-bangkok) = `9` — NAISI_TIMEZONE_ASIA_BANGKOK 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_JAKARTA`](/web/developers/naisilib/const#naisi-timezone-asia-jakarta) = `10` — NAISI_TIMEZONE_ASIA_JAKARTA 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_MANILA`](/web/developers/naisilib/const#naisi-timezone-asia-manila) = `11` — NAISI_TIMEZONE_ASIA_MANILA 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_HO_CHI_MINH`](/web/developers/naisilib/const#naisi-timezone-asia-ho-chi-minh) = `12` — NAISI_TIMEZONE_ASIA_HO_CHI_MINH 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_KOLKATA`](/web/developers/naisilib/const#naisi-timezone-asia-kolkata) = `13` — NAISI_TIMEZONE_ASIA_KOLKATA 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_DHAKA`](/web/developers/naisilib/const#naisi-timezone-asia-dhaka) = `14` — NAISI_TIMEZONE_ASIA_DHAKA 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_KATHMANDU`](/web/developers/naisilib/const#naisi-timezone-asia-kathmandu) = `15` — NAISI_TIMEZONE_ASIA_KATHMANDU 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_KARACHI`](/web/developers/naisilib/const#naisi-timezone-asia-karachi) = `16` — NAISI_TIMEZONE_ASIA_KARACHI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_DUBAI`](/web/developers/naisilib/const#naisi-timezone-asia-dubai) = `17` — NAISI_TIMEZONE_ASIA_DUBAI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_RIYADH`](/web/developers/naisilib/const#naisi-timezone-asia-riyadh) = `18` — NAISI_TIMEZONE_ASIA_RIYADH 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_JERUSALEM`](/web/developers/naisilib/const#naisi-timezone-asia-jerusalem) = `19` — NAISI_TIMEZONE_ASIA_JERUSALEM 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_ASIA_ISTANBUL`](/web/developers/naisilib/const#naisi-timezone-asia-istanbul) = `20` — NAISI_TIMEZONE_ASIA_ISTANBUL 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_EUROPE_LONDON`](/web/developers/naisilib/const#naisi-timezone-europe-london) = `21` — NAISI_TIMEZONE_EUROPE_LONDON 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_EUROPE_PARIS`](/web/developers/naisilib/const#naisi-timezone-europe-paris) = `22` — NAISI_TIMEZONE_EUROPE_PARIS 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_EUROPE_BERLIN`](/web/developers/naisilib/const#naisi-timezone-europe-berlin) = `23` — NAISI_TIMEZONE_EUROPE_BERLIN 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_EUROPE_MADRID`](/web/developers/naisilib/const#naisi-timezone-europe-madrid) = `24` — NAISI_TIMEZONE_EUROPE_MADRID 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_EUROPE_ROME`](/web/developers/naisilib/const#naisi-timezone-europe-rome) = `25` — NAISI_TIMEZONE_EUROPE_ROME 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_EUROPE_AMSTERDAM`](/web/developers/naisilib/const#naisi-timezone-europe-amsterdam) = `26` — NAISI_TIMEZONE_EUROPE_AMSTERDAM 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_EUROPE_MOSCOW`](/web/developers/naisilib/const#naisi-timezone-europe-moscow) = `27` — NAISI_TIMEZONE_EUROPE_MOSCOW 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AFRICA_CAIRO`](/web/developers/naisilib/const#naisi-timezone-africa-cairo) = `28` — NAISI_TIMEZONE_AFRICA_CAIRO 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AFRICA_JOHANNESBURG`](/web/developers/naisilib/const#naisi-timezone-africa-johannesburg) = `29` — NAISI_TIMEZONE_AFRICA_JOHANNESBURG 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AFRICA_LAGOS`](/web/developers/naisilib/const#naisi-timezone-africa-lagos) = `30` — NAISI_TIMEZONE_AFRICA_LAGOS 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AFRICA_NAIROBI`](/web/developers/naisilib/const#naisi-timezone-africa-nairobi) = `31` — NAISI_TIMEZONE_AFRICA_NAIROBI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AMERICA_NEW_YORK`](/web/developers/naisilib/const#naisi-timezone-america-new-york) = `32` — NAISI_TIMEZONE_AMERICA_NEW_YORK 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AMERICA_CHICAGO`](/web/developers/naisilib/const#naisi-timezone-america-chicago) = `33` — NAISI_TIMEZONE_AMERICA_CHICAGO 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AMERICA_DENVER`](/web/developers/naisilib/const#naisi-timezone-america-denver) = `34` — NAISI_TIMEZONE_AMERICA_DENVER 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AMERICA_LOS_ANGELES`](/web/developers/naisilib/const#naisi-timezone-america-los-angeles) = `35` — NAISI_TIMEZONE_AMERICA_LOS_ANGELES 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AMERICA_ANCHORAGE`](/web/developers/naisilib/const#naisi-timezone-america-anchorage) = `36` — NAISI_TIMEZONE_AMERICA_ANCHORAGE 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_PACIFIC_HONOLULU`](/web/developers/naisilib/const#naisi-timezone-pacific-honolulu) = `37` — NAISI_TIMEZONE_PACIFIC_HONOLULU 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AMERICA_TORONTO`](/web/developers/naisilib/const#naisi-timezone-america-toronto) = `38` — NAISI_TIMEZONE_AMERICA_TORONTO 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AMERICA_VANCOUVER`](/web/developers/naisilib/const#naisi-timezone-america-vancouver) = `39` — NAISI_TIMEZONE_AMERICA_VANCOUVER 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AMERICA_MEXICO_CITY`](/web/developers/naisilib/const#naisi-timezone-america-mexico-city) = `40` — NAISI_TIMEZONE_AMERICA_MEXICO_CITY 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AMERICA_SAO_PAULO`](/web/developers/naisilib/const#naisi-timezone-america-sao-paulo) = `41` — NAISI_TIMEZONE_AMERICA_SAO_PAULO 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AMERICA_BUENOS_AIRES`](/web/developers/naisilib/const#naisi-timezone-america-buenos-aires) = `42` — NAISI_TIMEZONE_AMERICA_BUENOS_AIRES 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AUSTRALIA_SYDNEY`](/web/developers/naisilib/const#naisi-timezone-australia-sydney) = `43` — NAISI_TIMEZONE_AUSTRALIA_SYDNEY 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AUSTRALIA_MELBOURNE`](/web/developers/naisilib/const#naisi-timezone-australia-melbourne) = `44` — NAISI_TIMEZONE_AUSTRALIA_MELBOURNE 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AUSTRALIA_BRISBANE`](/web/developers/naisilib/const#naisi-timezone-australia-brisbane) = `45` — NAISI_TIMEZONE_AUSTRALIA_BRISBANE 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_AUSTRALIA_PERTH`](/web/developers/naisilib/const#naisi-timezone-australia-perth) = `46` — NAISI_TIMEZONE_AUSTRALIA_PERTH 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_PACIFIC_AUCKLAND`](/web/developers/naisilib/const#naisi-timezone-pacific-auckland) = `47` — NAISI_TIMEZONE_PACIFIC_AUCKLAND 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_PACIFIC_FIJI`](/web/developers/naisilib/const#naisi-timezone-pacific-fiji) = `48` — NAISI_TIMEZONE_PACIFIC_FIJI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
- [`NAISI_TIMEZONE_PACIFIC_GUAM`](/web/developers/naisilib/const#naisi-timezone-pacific-guam) = `49` — NAISI_TIMEZONE_PACIFIC_GUAM 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。

## 调用示例

当前请求须满足上方调用前提；请检查实际返回值和引用输出，随机结果及数据包内容以运行环境为准。

```php
$format = 'Y-m-d H:i:s';
$time = null;
$timezone = 1;

$result = naisi_get_utc_date($format, $time, $timezone);
var_export($result);
```

## 版本信息

- 自版本：`1.0.6`
- 实现模块：`time`
- 授权类别：`LICENSE` / `PROOF`
- 失败回退：空字符串 `""`
- 文档同步：`2026-10-18`