Python获取当前时间字符串的标准写法

温以宁
温以宁
发布时间:2026-10-10 | 3人浏览过
原创

获取当前时间的字符串形式是编程中最常见的日常需求之一。在现代 Python(Python 3.8 及以上版本)中,最标准、稳妥的做法是通过内置标准库 datetime 来完成。根据具体的应用场景,行业公认的标准写法主要分为两类:一是生成面向人类日常阅读的常规格式(如 2026-10-08 15:30:00),使用 datetime.now().strftime("%Y-%m-%d %H:%M:%S");二是生成面向日志与跨系统数据通信的国际标准化格式(ISO 8601,带有时区偏移量),使用 datetime.now(timezone.utc).isoformat()。这两种写法均无需安装任何第三方库,具备极高的执行效率与跨平台兼容性。

为什么优先推荐 datetime 模块而非旧版 time 模块

很多初学者在早期教程中会接触到 time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()) 这种写法。虽然该写法依然可以运行,但在现代工程开发中,推荐优先使用 datetime 模块,原因主要包括以下三点:

  • 面向对象与类型安全:datetime 模块生成的 datetime 对象包含完整的年、月、日、时、分、秒以及微秒属性,便于在格式化之前或之后进行时间加减、比对等计算操作。
  • 原生的时区感知能力:datetime 原生支持 timezone 时区对象,能够精确表示 UTC 协调世界时或本地时区,避免由于跨时区服务器部署导致的时间偏差。
  • 调用方式更为简洁:无需像 time 模块那样先获取时间戳再转为时间元组(struct_time),只需一步即可直接从对象导出目标字符串。
Python获取当前时间字符串的标准写法
图1:Python时间对象生成与格式化字符串输出的完整流转过程

场景一:获取“年-月-日 时:分:秒”格式字符串

日常业务开发中最普遍的需求是将当前时间格式化为形如 2026-10-08 15:30:45 的文本。实现该需求最核心的方法是 strftime(),它的全称为“String Format Time”(字符串格式化时间)。

核心标准代码实现

from datetime import datetime

# 获取当前本地时间对象
now = datetime.now()

# 按照指定模板转换为字符串
time_str = now.strftime("%Y-%m-%d %H:%M:%S")

print(time_str)
# 示例输出:2026-10-08 15:30:45

在这段代码中,datetime.now() 负责抓取当前系统时钟,返回一个 datetime 类型的实例;随后调用该实例的 strftime() 方法,传入对应的格式控制符。传入的模板字符串会保持其中的横线、空格和冒号等字面符号不变,而以百分号开头的占位符则会被当前对应的时间数值精准替换。

Python获取当前时间字符串的标准写法
图2:Python strftime 格式化占位符的字符映射与大小写避坑指引

核心格式控制符速查表

控制符 中文含义与说明 示例值 注意事项
%Y 四位数完整年份 2026 生产代码中务必使用大写 Y,避免跨世纪识别混淆
%m 两位数月份(01 到 12) 10 务必小写 m,不足两位会自动在前方补零
%d 两位数日期(01 到 31) 08 小写 d,不足两位在前方补零
%H 24小时制小时(00 到 23) 15 后台服务、日志记录的默认选择
%M 两位数分钟(00 到 59) 30 务必大写 M,若误写为小写 m 则会被解析为月份
%S 两位数秒数(00 到 59) 45 大写 S,表示整数秒
%f 六位数微秒(000000 到 999999) 123456 小写 f,多用于微秒或截取生成毫秒时间戳
避坑重点:含有中文字符时的跨平台报错问题
在 Windows 操作系统或部分默认编码非 UTF-8 的环境中,如果直接书写 now.strftime("%Y年%m月%d日"),极易抛出 UnicodeEncodeError: 'locale' codec can't encode character 异常。这是因为 Python 底层的 strftime 会调用系统的 C 语言标准库接口,而旧版本 C 库无法正确识别并解析格式串中的中文字符。

标准解决方案:使用 f-string 配合格式说明符
从 Python 3.6 起,推荐直接利用 f-string 的日期格式化语法,既优雅又完全跨平台安全:
from datetime import datetime

now = datetime.now()
# 优雅且跨平台安全的中文日期拼接写法
chinese_time_str = f"{now:%Y}年{now:%m}月{now:%d}日 {now:%H}时{now:%M}分{now:%S}秒"

print(chinese_time_str)
# 示例输出:2026年10月08日 15时30分45秒

场景二:现代工程推荐规范——带时区的 ISO 8601 标准字符串

如果获取的时间字符串需要用于前后端接口传输(如 JSON 格式接口)、数据库入库或微服务之间的远程通信,仅仅使用 2026-10-08 15:30:45 这样的字符串存在严重的隐患。因为该文本中完全没有指明这个“15点30分”到底属于哪个时区。如果服务器部署在东京(东九区)、北京(东八区)或者伦敦(零时区),直接读取无时区的时间字符串会导致不同服务产生数小时的理解偏差。

为了解决这个问题,国际标准化组织制定了 ISO 8601 规范(在互联网标准中对应 RFC 3339)。其标准格式形如 2026-10-08T15:30:45+08:00,其中字符 T 作为日期和时间的分隔符,结尾的 +08:00 明确告知任何接收系统:该时间相对于 UTC 协调世界时快了8个小时。

Python获取当前时间字符串的标准写法
图3:朴素时间(Naive)与时区感知时间(Aware)的属性与安全价值对比

获取 UTC 时间的 ISO 8601 字符串写法

在分布式系统、多可用区微服务或国际业务中,服务器通常统一采用 UTC 时间进行数据存储与内部流转:

from datetime import datetime, timezone

# 显式指定获取当前 UTC 协调世界时
utc_now = datetime.now(timezone.utc)

# 调用 isoformat() 直接生成符合国际标准的字符串
iso_str = utc_now.isoformat()

print(iso_str)
# 示例输出:2026-10-08T07:30:45.123456+00:00

获取带当前本地时区偏移的 ISO 8601 字符串写法

如果希望以本地时间呈现,同时保留准确的时区偏移信息,可以在获取时间后调用 astimezone() 将本地系统的默认时区自动附加到对象中:

from datetime import datetime

# 获取当前时间并自动附带操作系统的本地时区信息
local_aware_now = datetime.now().astimezone()

# 生成带有时区偏移的标准字符串
local_iso_str = local_aware_now.isoformat()

print(local_iso_str)
# 示例输出(中国标准时间):2026-10-08T15:30:45.123456+08:00

场景三:日志与排错场景下的高精度时间字符串(精确到毫秒)

在排查系统性能瓶颈、追踪微服务调用链路或生成高频订单编号时,精确到秒级的时间通常不够用,极易发生并发冲突。此时需要精确到“毫秒”(千分之一秒)级别的时间字符串。

使用 isoformat 的 timespec 参数快速控制精度

Python 标准库的 isoformat() 方法内置了 timespec 参数,无需编写繁琐的字符串切片代码,即可规范控制时间精度:

from datetime import datetime

now = datetime.now().astimezone()

# 精确到秒(去除多余的小数微秒)
seconds_str = now.isoformat(timespec='seconds')
print("精确到秒:", seconds_str)
# 示例输出:2026-10-08T15:30:45+08:00

# 精确到毫秒(保留三位小数,最适合系统日志)
millis_str = now.isoformat(timespec='milliseconds')
print("精确到毫秒:", millis_str)
# 示例输出:2026-10-08T15:30:45.123+08:00

传统日志格式下提取毫秒的通用写法

若团队现有日志采集系统规定必须采用 YYYY-MM-DD HH:MM:SS.mmm 的格式,由于 strftime 中的 %f 默认输出6位微秒,可以通过在末尾截取前3位的方式安全获取毫秒:

from datetime import datetime

now = datetime.now()

# %f 输出6位微秒,切片[:-3]保留前3位得到毫秒
log_time_str = now.strftime("%Y-%m-%d %H:%M:%S.%f")[:-3]

print(log_time_str)
# 示例输出:2026-10-08 15:30:45.123

主流实现方式综合对比与场景选型决策

在 Python 中将当前时间转为字符串有多种写法,不同写法在适用场景、可读性及功能完备度上存在差异。下表总结了主流写法的对比要点:

写法模式 标准语法示例 典型输出结果 适用业务场景
常规 strftime datetime.now().strftime("%Y-%m-%d %H:%M:%S") 2026-10-08 15:30:45 内部控制台输出、普通报表、本地日志记录
带时区 isoformat datetime.now(timezone.utc).isoformat() 2026-10-08T07:30:45+00:00 前后端通信、RESTful API、分布式系统日志
f-string 格式化 f"{datetime.now():%Y-%m-%d %H:%M:%S}" 2026-10-08 15:30:45 中文字符串拼接、简单脚本、Python 3.6+ 代码
高精度 timespec datetime.now().astimezone().isoformat(timespec='milliseconds') 2026-10-08T15:30:45.123+08:00 性能排查、微服务分布式链路追踪(APM)
旧版 time 模块 time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()) 2026-10-08 15:30:45 维护旧项目遗留代码(新代码不推荐作为首选)
Python获取当前时间字符串的标准写法
图4:Python获取时间字符串在不同业务场景下的推荐选型路径

总结与最佳实践准则

在日常开发与工程架构中,掌握时间字符串的标准写法能够大幅降低后续排错与数据维护的成本。建议遵循以下三条核心准则:

  1. 弃用旧式的 time 字符串拼接:全面转向标准库 datetime,代码更加现代化、易读且便于后续维护。
  2. 系统边界交互优先选用带时区的 ISO 8601:凡是跨服务传输、写数据库或对外提供 API 的时间字符串,优先使用 datetime.now(timezone.utc).isoformat(),彻底消除跨时区带来的歧义。
  3. 中文格式优先采用 f-string:当格式模板中包含中文汉字时,使用 f-string 语法(如 f"{now:%Y}年{now:%m}月{now:%d}日")能有效防止不同操作系统下底层 C 语言库抛出的编码异常。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表