python中怎么将字符串转换为datetime对象？-Python教程-PHP中文网

使用datetime.strptime()可将字符串转为datetime对象，需确保格式代码与字符串严格匹配，如%Y-%m-%d对应"2023-10-27"；对不同时区或模糊格式，可借助dateutil.parser.parse或fromisoformat()处理，并建议内部统一用UTC时间。

python中怎么将字符串转换为datetime对象？

在Python中，将字符串转换为

datetime

登录后复制

对象，核心在于

datetime

登录后复制

模块提供的

strptime()

登录后复制

方法。这个方法就像一个翻译官，它能理解你给出的日期时间字符串的“语言（格式）”，并将其准确地解析成Python能够处理的

datetime

登录后复制

类型。理解并正确使用格式代码是关键，一旦格式对不上，它就会直接报错，毫不留情。

解决方案

要将字符串转换为

datetime

登录后复制

对象，你需要使用

datetime

登录后复制

模块中的

datetime.strptime(date_string, format)

登录后复制

函数。

```
date_string
```
登录后复制
：这是你要转换的日期时间字符串。
```
format
```
登录后复制
：这是一个格式字符串，它告诉
```
strptime()
```
登录后复制
如何解析
```
date_string
```
登录后复制
。这个格式字符串由各种“格式代码”组成，比如
```
%Y
```
登录后复制
代表四位数的年份，
```
%m
```
登录后复制
代表两位数的月份，
```
%d
```
登录后复制
代表两位数的日期等等。

基本示例：

from datetime import datetime

# 示例1: 常见的日期时间格式
date_str_1 = "2023-10-27 14:30:00"
# 对应的格式字符串：%Y (年)-%m (月)-%d (日) %H (小时):%M (分钟):%S (秒)
dt_object_1 = datetime.strptime(date_str_1, "%Y-%m-%d %H:%M:%S")
print(f"字符串 '{date_str_1}' 转换为: {dt_object_1}, 类型: {type(dt_object_1)}")

# 示例2: 只有日期
date_str_2 = "2023/10/27"
# 对应的格式字符串：%Y (年)/%m (月)/%d (日)
dt_object_2 = datetime.strptime(date_str_2, "%Y/%m/%d")
print(f"字符串 '{date_str_2}' 转换为: {dt_object_2}, 类型: {type(dt_object_2)}")

# 示例3: 包含毫秒（注意：strptime对毫秒的支持有限，通常需要手动处理）
# 如果字符串是 "2023-10-27 14:30:00.123"，%f 可以解析微秒
date_str_3 = "2023-10-27 14:30:00.123456"
dt_object_3 = datetime.strptime(date_str_3, "%Y-%m-%d %H:%M:%S.%f")
print(f"字符串 '{date_str_3}' 转换为: {dt_object_3}, 类型: {type(dt_object_3)}")

# 示例4: ISO 8601 格式，通常推荐使用 fromisoformat()
# 但 strptime 也能处理
date_str_4 = "2023-10-27T14:30:00"
dt_object_4 = datetime.strptime(date_str_4, "%Y-%m-%dT%H:%M:%S")
print(f"字符串 '{date_str_4}' 转换为: {dt_object_4}, 类型: {type(dt_object_4)}")

登录后复制

常用的格式代码包括：

立即学习“Python免费学习笔记（深入）”；

```
%Y
```
登录后复制
: 四位数的年份 (e.g., 2023)
```
%m
```
登录后复制
: 两位数的月份 (01-12)
```
%d
```
登录后复制
: 两位数的日期 (01-31)
```
%H
```
登录后复制
: 24小时制的小时 (00-23)
```
%I
```
登录后复制
: 12小时制的小时 (01-12)
```
%m
```
登录后复制
: 两位数的分钟 (00-59)
```
%S
```
登录后复制
: 两位数的秒 (00-59)
```
%f
```
登录后复制
: 微秒 (000000-999999)
```
%p
```
登录后复制
: AM/PM (如果使用
```
%I
```
登录后复制
)
```
%w
```
登录后复制
: 星期几 (0-6，星期天是0)
```
%a
```
登录后复制
,
```
%a
```
登录后复制
: 简写或完整星期几名称
```
%b
```
登录后复制
,
```
%b
```
登录后复制
: 简写或完整月份名称
```
%z
```
登录后复制
: UTC偏移量 (e.g., +0800)
```
%z
```
登录后复制
: 时区名称 (e.g., CST)
```
%j
```
登录后复制
: 一年中的第几天 (001-366)
```
%U
```
登录后复制
: 一年中的第几周 (星期天作为一周的开始)
```
%w
```
登录后复制
: 一年中的第几周 (星期一作为一周的开始)
```
%%
```
登录后复制
: 字面上的 '%' 字符

完整列表可以参考Python官方文档。

如何处理不同格式的日期字符串？

在实际开发中，我们经常会遇到来自不同系统、不同用户输入的日期时间字符串，它们的格式可能五花八门，甚至有些混乱。说实话，这确实是个让人头疼的问题。

strptime()

登录后复制

要求格式严格匹配，如果输入字符串的格式不固定，直接用一个

format

登录后复制

字符串去解析，那肯定会频繁报错。

面对这种情况，我通常会采取几种策略：

1. 预设多种格式，尝试解析： 这是最常见也最直接的方法。如果你知道可能出现的几种日期时间格式，你可以将它们放在一个列表中，然后尝试用

try-except

登录后复制

块逐一解析。只要有一个格式成功解析，就停止尝试。

from datetime import datetime

def parse_flexible_datetime(date_string):
    formats = [
        "%Y-%m-%d %H:%M:%S",
        "%Y/%m/%d %H:%M:%S",
        "%Y-%m-%d",
        "%Y/%m/%d",
        "%m/%d/%Y",  # 注意这种格式可能引起歧义，比如 "01/02/2023" 是 M/D/Y 还是 D/M/Y
        "%d-%m-%Y %H:%M",
        "%Y-%m-%dT%H:%M:%S.%f", # ISO 8601 with microseconds
        "%Y-%m-%dT%H:%M:%S", # ISO 8601 without microseconds
    ]
    for fmt in formats:
        try:
            return datetime.strptime(date_string, fmt)
        except ValueError:
            continue
    raise ValueError(f"无法解析日期字符串 '{date_string}'，没有匹配的格式。")

# 测试
print(parse_flexible_datetime("2023-10-27 10:00:00"))
print(parse_flexible_datetime("2023/10/27"))
print(parse_flexible_datetime("10/27/2023")) # 假设是 M/D/Y
print(parse_flexible_datetime("27-10-2023 15:00"))
print(parse_flexible_datetime("2023-10-27T14:30:00.123456"))

# 如果遇到无法解析的字符串
try:
    parse_flexible_datetime("Invalid Date String")
except ValueError as e:
    print(e)

登录后复制

这种方法的缺点是，如果格式列表很长，性能可能会受影响。而且，对于像

"01/02/2023"

登录后复制

这种模糊的格式，你必须预先决定它应该被解析成M/D/Y还是D/M/Y，否则可能会得到意料之外的结果。

2. 使用第三方库

dateutil

登录后复制

：对于更“随意”的日期字符串，

dateutil

登录后复制

库（特别是

dateutil.parser.parse

登录后复制

）是一个非常强大的工具。它能够智能地猜测日期字符串的格式并进行解析，省去了手动维护格式列表的麻烦。

from dateutil.parser import parse
from datetime import datetime

# 确保已安装：pip install python-dateutil

print(parse("2023-10-27 10:00:00"))
print(parse("October 27, 2023"))
print(parse("27 Oct 2023"))
print(parse("2023/10/27 10am"))
print(parse("tomorrow")) # 甚至能解析相对日期
print(parse("2023-10-27T14:30:00Z")) # 包含时区的ISO格式

# 它的一个缺点是，对于模糊的格式，它有自己的默认解析规则，可能不总是你想要的
# 比如，"01/02/2023" 默认可能解析成 YYYY-MM-DD 或 YYYY-DD-MM，这取决于区域设置和内部逻辑
# 可以通过 dayfirst=True 或 yearfirst=True 参数来调整
print(parse("01/02/2023", dayfirst=True)) # 假设是 DD/MM/YYYY
print(parse("01/02/2023", yearfirst=True)) # 假设是 YY/MM/DD

登录后复制

dateutil

登录后复制

的优点是方便，能处理很多复杂的场景；缺点是它不是Python标准库的一部分，需要额外安装，并且在某些极端情况下，其“智能”解析可能不符合你的预期，尤其是在处理模糊格式时。在对性能要求极高或对解析结果有严格确定性要求的场景，我还是倾向于自己控制

strptime

登录后复制

的格式列表。

转换过程中常见的错误有哪些，以及如何调试？

转换字符串到

datetime

登录后复制

对象时，最最常见的错误，没有之一，就是

ValueError: time data '...' does not match format '%'

登录后复制

. 这个错误信息非常直白，它告诉你输入字符串和你的格式字符串对不上。每次遇到这个错误，我都得深吸一口气，然后开始“找茬”。

常见的错误原因及调试方法：

快转字幕

新一代 AI 字幕工作站，为创作者提供字幕制作、学习资源、会议记录、字幕制作等场景，一键为您的视频生成精准的字幕。

357

查看详情

格式字符串与输入不匹配：
- 原因： 这是最普遍的情况。比如，你的日期字符串是
```
"2023-10-27"
```
  登录后复制
  ，但你却用了
```
"%Y/%m/%d"
```
  登录后复制
  去解析，分隔符不一致。或者字符串里有时间，但你的格式里没有
```
%H:%M:%S
```
  登录后复制
  。
- 调试：
  - 逐字对比： 把你的输入字符串和
```
format
```
    登录后复制
    字符串并排打印出来，然后一个字符一个字符地对比。看看分隔符是否一致（
```
-
```
    登录后复制
    vs
```
/
```
    登录后复制
    vs ` `），数字位数是否一致，是否有额外的字符（比如末尾的空格）。
  - 检查大小写： 格式代码是大小写敏感的！
```
%m
```
    登录后复制
    是分钟，
```
%m
```
    登录后复制
    是月份。
```
%H
```
    登录后复制
    是24小时制，
```
%I
```
    登录后复制
    是12小时制。这些小细节很容易被忽略。
  - 缺失部分： 字符串里有秒，但格式里没有
```
%S
```
    登录后复制
    ？字符串里有毫秒，但格式里没有
```
%f
```
    登录后复制
    ？这都会导致匹配失败。
  - 多余部分： 字符串里只有日期，但格式里却包含了时间部分，如果时间部分在字符串里缺失，也会报错。
```
# 错误示例
try:
    datetime.strptime("2023-10-27", "%Y/%m/%d") # 分隔符不匹配
except ValueError as e:
    print(f"错误示例1: {e}")

try:
    datetime.strptime("2023-10-27 10:00", "%Y-%m-%d") # 缺少时间部分
except ValueError as e:
    print(f"错误示例2: {e}")

try:
    datetime.strptime("2023-10-27 10:00:00", "%Y-%M-%d %H:%M:%S") # %M 应该是 %m
except ValueError as e:
    print(f"错误示例3: {e}")
```
登录后复制
数据本身不合法：
- 原因： 比如日期字符串是
```
"2023-13-01"
```
  登录后复制
  （月份13），或者
```
"2023-02-30"
```
  登录后复制
  （2月没有30号）。
```
strptime()
```
  登录后复制
  在解析时会进行基本的合法性检查。
- 调试： 确认输入数据是否在逻辑上是有效的日期时间。
时区信息处理不当：
- 原因： 字符串里有
```
Z
```
  登录后复制
  （Zulu/UTC）或
```
+HHMM
```
  登录后复制
  这样的时区偏移，但格式字符串没有正确处理，或者处理方式不正确。
- 调试： 如果有
```
Z
```
  登录后复制
  ，
```
strptime
```
  登录后复制
  的
```
%z
```
  登录后复制
  无法直接解析
```
Z
```
  登录后复制
  ，通常需要手动替换
```
Z
```
  登录后复制
  为
```
+0000
```
  登录后复制
  或使用
```
datetime.fromisoformat()
```
  登录后复制
  。如果有时区偏移，确保
```
%z
```
  登录后复制
  在正确的位置。
Locale（本地化）问题：
- 原因： 当你使用
```
%a
```
  登录后复制
  、
```
%a
```
  登录后复制
  （星期几名称）或
```
%b
```
  登录后复制
  、
```
%b
```
  登录后复制
  （月份名称）时，这些名称是依赖于当前系统locale的。如果你的字符串是英文月份名，但系统locale是中文，或者反过来，就会解析失败。
- 调试： 确保你的程序运行环境的locale设置与日期字符串的语言环境一致，或者避免使用这些依赖locale的格式代码。

调试小技巧：

逐步构建格式字符串： 如果不确定，可以从日期部分开始，逐步添加时间、秒、毫秒等，每次添加后都测试一下。
使用
strftime()
登录后复制
反向验证：如果你有一个
```
datetime
```
登录后复制
对象，你可以用
```
dt_object.strftime(your_format)
```
登录后复制
来生成一个字符串。如果这个生成的字符串和你原始的输入字符串相似，那么你的
```
your_format
```
登录后复制
很可能就是正确的。这是一个很好的验证方法。

如何处理带有时区信息的日期字符串？

处理带有时区信息的日期字符串是另一个经常让人感到困惑的地方。

datetime.strptime()

登录后复制

默认创建的是“naive”（天真）的

datetime

登录后复制

对象，这意味着它们没有附带任何时区信息。在很多业务场景中，尤其涉及到跨区域数据时，时区信息至关重要。

1. 使用

%z

登录后复制

解析固定偏移时区： 如果你的日期字符串包含类似

+0800

登录后复制

、

-0500

登录后复制

这样的UTC偏移量，

strptime()

登录后复制

的

%z

登录后复制

格式代码可以解析它们，并创建一个“aware”（感知）的

datetime

登录后复制

对象。

from datetime import datetime

date_str_with_offset = "2023-10-27 14:30:00+0800"
dt_aware = datetime.strptime(date_str_with_offset, "%Y-%m-%d %H:%M:%S%z")
print(f"带偏移量的字符串 '{date_str_with_offset}' 转换为: {dt_aware}, 时区信息: {dt_aware.tzinfo}")

date_str_utc_offset = "2023-10-27 06:30:00Z" # Z 通常表示 UTC，等同于 +0000
# strptime 无法直接解析 'Z'，需要手动替换
dt_aware_utc = datetime.strptime(date_str_utc_offset.replace('Z', '+0000'), "%Y-%m-%d %H:%M:%S%z")
print(f"UTC字符串 '{date_str_utc_offset}' 转换为: {dt_aware_utc}, 时区信息: {dt_aware_utc.tzinfo}")

登录后复制

需要注意的是，

%z

登录后复制

只能解析数字形式的偏移量，对于像

"PST"

登录后复制

、

"EST"

登录后复制

这样的时区缩写，它无法直接识别。而且，

登录后复制

（Zulu time，即UTC）也需要特殊处理。

2. 使用

datetime.fromisoformat()

登录后复制

解析 ISO 8601 字符串： 如果你的日期字符串遵循ISO 8601标准（例如

"YYYY-MM-DDTHH:MM:SS.ffffff[+HH:MM]"

登录后复制

），Python 3.7+ 提供的

datetime.fromisoformat()

登录后复制

方法是最佳选择。它能直接解析包含时区信息的ISO 8601字符串，并返回一个aware的

datetime

登录后复制

对象。

from datetime import datetime

iso_str_utc = "2023-10-27T06:30:00Z"
dt_iso_utc = datetime.fromisoformat(iso_str_utc.replace('Z', '+00:00')) # fromisoformat 支持 +HH:MM 或 +HHMM
print(f"ISO UTC 字符串 '{iso_str_utc}' 转换为: {dt_iso_utc}, 时区信息: {dt_iso_utc.tzinfo}")

iso_str_offset = "2023-10-27T14:30:00+08:00"
dt_iso_offset = datetime.fromisoformat(iso_str_offset)
print(f"ISO 带偏移字符串 '{iso_str_offset}' 转换为: {dt_iso_offset}, 时区信息: {dt_iso_offset.tzinfo}")

登录后复制

fromisoformat()

登录后复制

简洁高效，强烈推荐在处理ISO 8601格式时使用。

3. 结合

pytz

登录后复制

或
zoneinfo
登录后复制
(Python 3.9+) 处理命名时区：如果你的字符串只包含日期时间，但你知道它属于哪个命名时区（如

"Asia/Shanghai"

登录后复制

，

"America/New_York"

登录后复制

），你需要先用

strptime()

登录后复制

解析成naive对象，然后使用第三方库

pytz

登录后复制

（或Python 3.9+的内置

zoneinfo

登录后复制

）将其“本地化”（localize）。

from datetime import datetime
import pytz # pip install pytz

# 假设输入字符串是北京时间（东八区）的naive时间
naive_date_str = "2023-10-27 14:30:00"
naive_dt = datetime.strptime(naive_date_str, "%Y-%m-%d %H:%M:%S")

# 获取北京时区对象
beijing_tz = pytz.timezone('Asia/Shanghai')
# 将naive datetime对象本地化为北京时区
aware_dt_beijing = beijing_tz.localize(naive_dt)
print(f"本地化后的北京时间: {aware_dt_beijing}, 时区信息: {aware_dt_beijing.tzinfo}")

# 转换为UTC时间（通常推荐内部存储和处理使用UTC）
utc_dt = aware_dt_beijing.astimezone(pytz.utc)
print(f"转换为UTC时间: {utc_dt}, 时区信息: {utc_dt.tzinfo}")

# 转换到另一个时区，比如纽约时间
new_york_tz = pytz.timezone('America/New_York')
new_york_dt = aware_dt_beijing.astimezone(new_york_tz)
print(f"转换为纽约时间: {new_york_dt}, 时区信息: {new_york_dt.tzinfo}")

登录后复制