NaisiNaisi Lib Docs

naisi_get_utc_date

查看 Markdown

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

函数签名

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

调用前提

应用入口先调用 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 = 0 — NAISI_TIMEZONE_UTC 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_PRC = 1 — NAISI_TIMEZONE_PRC 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_SHANGHAI = 1 — NAISI_TIMEZONE_ASIA_SHANGHAI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_HONG_KONG = 2 — NAISI_TIMEZONE_ASIA_HONG_KONG 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_MACAU = 3 — NAISI_TIMEZONE_ASIA_MACAU 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_TAIPEI = 4 — NAISI_TIMEZONE_ASIA_TAIPEI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_TOKYO = 5 — NAISI_TIMEZONE_ASIA_TOKYO 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_SEOUL = 6 — NAISI_TIMEZONE_ASIA_SEOUL 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_SINGAPORE = 7 — NAISI_TIMEZONE_ASIA_SINGAPORE 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_KUALA_LUMPUR = 8 — NAISI_TIMEZONE_ASIA_KUALA_LUMPUR 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_BANGKOK = 9 — NAISI_TIMEZONE_ASIA_BANGKOK 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_JAKARTA = 10 — NAISI_TIMEZONE_ASIA_JAKARTA 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_MANILA = 11 — NAISI_TIMEZONE_ASIA_MANILA 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_HO_CHI_MINH = 12 — NAISI_TIMEZONE_ASIA_HO_CHI_MINH 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_KOLKATA = 13 — NAISI_TIMEZONE_ASIA_KOLKATA 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_DHAKA = 14 — NAISI_TIMEZONE_ASIA_DHAKA 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_KATHMANDU = 15 — NAISI_TIMEZONE_ASIA_KATHMANDU 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_KARACHI = 16 — NAISI_TIMEZONE_ASIA_KARACHI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_DUBAI = 17 — NAISI_TIMEZONE_ASIA_DUBAI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_RIYADH = 18 — NAISI_TIMEZONE_ASIA_RIYADH 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_JERUSALEM = 19 — NAISI_TIMEZONE_ASIA_JERUSALEM 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_ASIA_ISTANBUL = 20 — NAISI_TIMEZONE_ASIA_ISTANBUL 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_EUROPE_LONDON = 21 — NAISI_TIMEZONE_EUROPE_LONDON 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_EUROPE_PARIS = 22 — NAISI_TIMEZONE_EUROPE_PARIS 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_EUROPE_BERLIN = 23 — NAISI_TIMEZONE_EUROPE_BERLIN 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_EUROPE_MADRID = 24 — NAISI_TIMEZONE_EUROPE_MADRID 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_EUROPE_ROME = 25 — NAISI_TIMEZONE_EUROPE_ROME 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_EUROPE_AMSTERDAM = 26 — NAISI_TIMEZONE_EUROPE_AMSTERDAM 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_EUROPE_MOSCOW = 27 — NAISI_TIMEZONE_EUROPE_MOSCOW 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AFRICA_CAIRO = 28 — NAISI_TIMEZONE_AFRICA_CAIRO 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AFRICA_JOHANNESBURG = 29 — NAISI_TIMEZONE_AFRICA_JOHANNESBURG 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AFRICA_LAGOS = 30 — NAISI_TIMEZONE_AFRICA_LAGOS 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AFRICA_NAIROBI = 31 — NAISI_TIMEZONE_AFRICA_NAIROBI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AMERICA_NEW_YORK = 32 — NAISI_TIMEZONE_AMERICA_NEW_YORK 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AMERICA_CHICAGO = 33 — NAISI_TIMEZONE_AMERICA_CHICAGO 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AMERICA_DENVER = 34 — NAISI_TIMEZONE_AMERICA_DENVER 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AMERICA_LOS_ANGELES = 35 — NAISI_TIMEZONE_AMERICA_LOS_ANGELES 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AMERICA_ANCHORAGE = 36 — NAISI_TIMEZONE_AMERICA_ANCHORAGE 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_PACIFIC_HONOLULU = 37 — NAISI_TIMEZONE_PACIFIC_HONOLULU 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AMERICA_TORONTO = 38 — NAISI_TIMEZONE_AMERICA_TORONTO 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AMERICA_VANCOUVER = 39 — NAISI_TIMEZONE_AMERICA_VANCOUVER 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AMERICA_MEXICO_CITY = 40 — NAISI_TIMEZONE_AMERICA_MEXICO_CITY 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AMERICA_SAO_PAULO = 41 — NAISI_TIMEZONE_AMERICA_SAO_PAULO 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AMERICA_BUENOS_AIRES = 42 — NAISI_TIMEZONE_AMERICA_BUENOS_AIRES 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AUSTRALIA_SYDNEY = 43 — NAISI_TIMEZONE_AUSTRALIA_SYDNEY 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AUSTRALIA_MELBOURNE = 44 — NAISI_TIMEZONE_AUSTRALIA_MELBOURNE 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AUSTRALIA_BRISBANE = 45 — NAISI_TIMEZONE_AUSTRALIA_BRISBANE 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_AUSTRALIA_PERTH = 46 — NAISI_TIMEZONE_AUSTRALIA_PERTH 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_PACIFIC_AUCKLAND = 47 — NAISI_TIMEZONE_PACIFIC_AUCKLAND 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_PACIFIC_FIJI = 48 — NAISI_TIMEZONE_PACIFIC_FIJI 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。
  • NAISI_TIMEZONE_PACIFIC_GUAM = 49 — NAISI_TIMEZONE_PACIFIC_GUAM 时区选择器。 供 naisi_get_utc_date() 选择对应地区的时区和夏令时规则。

调用示例

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

$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