前言

为了方便时间戳管理和按时区显示，后端统一生成UTC时间（格式为 ISO 8601 UTC ），前端可以根据时区跳转显示。

使用Python获取当前 UTC 时间（带时区信息）正确写法如下所示：

1
2
3
4

from datetime import datetime, timezone

utc_now = datetime.now(timezone.utc)
print(utc_now)  # 带时区信息的 UTC 时间

示例用 Day.js 强制转 UTC，再转换到用户所在时区

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

import dayjs from 'dayjs';
import utc from 'dayjs/plugin/utc';
import timezone from 'dayjs/plugin/timezone';
dayjs.extend(utc);
dayjs.extend(timezone);

const userTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;


const formatDate = (utcDateString) => {
  if (!utcDateString) return '';
  // 1. 先把字符串解析为UTC时间
  const utcDate = dayjs.utc(utcDateString);
  // 2. 转换到用户所在时区时间
  const customizedTime = utcDate.tz(userTimeZone);
  // 3. 格式化输出
  return customizedTime.format('YYYY年MM月DD日 HH:mm');
};

详细说明

1. Python 端生成时间的推荐写法

  • 千万别用 datetime.utcnow()，它返回的是“naive”（无时区信息）的时间，容易导致和时区混淆。
  • 用带时区的 datetime.now(timezone.utc) 生成“aware”时间对象，明确标识这是 UTC 时间。

示例：

1
2
3
4

from datetime import datetime, timezone

utc_now = datetime.now(timezone.utc)
print(utc_now)  # 2025-04-24 08:21:53.687+00:00，带时区信息的 UTC 时间

🎯数据库建议统一存储 带时区的 UTC 时间字符串，方便跨时区统一管理。

2. JavaScript 端的时区处理

2.1 标准 JS Date 对象

new Date('2025-04-24T08:21:53.687+00:00') 会被解析为 UTC 时间，且转成本地时间。

  • date.toLocaleString() 显示本地时区的日期和时间

  • date.toLocaleDateString() 默认只显示日期，传入时间选项可显示时间部分

  • 获取客户端时区：

    1

    const userTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;  // 比如 Asia/Shanghai

2.2 推荐使用 Day.js 处理时间

Day.js 插件 utc + timezone 能很好处理解析 UTC 字符串并转成用户时区的时间。

示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

import dayjs from 'dayjs';
import utc from 'dayjs/plugin/utc';
import timezone from 'dayjs/plugin/timezone';

dayjs.extend(utc);
dayjs.extend(timezone);

const userTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;

function formatDate(utcDateString) {
  if (!utcDateString) return '';
  const utcDate = dayjs.utc(utcDateString);  // 解析为 UTC 时间
  const localDate = utcDate.tz(userTimeZone); // 转换为用户时区时间
  return localDate.format('YYYY年MM月DD日 HH:mm');
}

3. 关于时区管理的最佳实践建议

方案优缺点
方案一数据库统一存 UTC 时间，前端按用户时区转换，简洁且跨时区统一方便查询
方案二存用户本地时间和时区，查询复杂且容易出错
方案三前端直接传带时区信息的 ISO 时间，配合方案一效果更优，增加准确度

推荐依然是方案一 —— 在后端统一存储 UTC 时间，前端根据浏览器时区展示。

4. 总结对比 toLocaleString() 和 toLocaleDateString() 的差异

方法显示内容备注
toLocaleString()日期 + 时间（默认本地时区）直接显示年月日及时分秒
toLocaleDateString()默认仅日期部分若传 { hour, minute } 选项也显示时间

5. 注意点

  • UTC 时间格式推荐使用包含时区偏移的 ISO 8601 字符串，如
    "2025-04-24T08:21:53.687+00:00" 或 "2024-04-24T08:47:00Z"
    两者等效，Z 表示 UTC。
  • JS Date 解析时，字符串必须符合标准 ISO 格式，否则时区和时间解析可能出错。
  • 服务器端和客户端一定要确认时间维度是一致的，否则会有跨时区的显示错误。