Python日期怎么写

您好!欢迎访问Python技术指南 · 关于我们 · 联系邮箱

Python日期怎么写?从零构建专业级时间处理能力

全面掌握Python中日期与时间的表示、格式化、解析、计算、时区转换及实战应用技巧,助您高效应对数据分析、Web开发、自动化脚本等场景下的日期处理挑战。

一、Python日期基础认知:为什么“怎么写”是关键起点?

在Python中,日期并非原生数据类型,而是通过标准库datetime模块提供的类(如datetime、date、time、timedelta、timezone)进行建模。因此,“python日期怎么写”这一问题实质上是:如何用正确对象和语法表达一个符合业务逻辑的日期时间值?

1.1 核心对象概览

Python标准库datetime提供以下关键类:

  • date(year, month, day):仅日期(年-月-日)
  • time(hour, minute, second, microsecond, tzinfo):仅时间(时:分:秒)
  • datetime(year, month, day, hour, minute, second, microsecond, tzinfo):日期+时间
  • timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0):时间间隔
  • timezone(tz):时区对象(自定义偏移)
⚡ 实际开发中,datetime类最常用——它整合了日期与时间,并支持时区(通过tzinfo参数)。若忽略时区,将默认为“朴素型”(naive),易引发跨时区系统的时间错乱。

1.2 最基础的“写法”示例

from datetime import date, datetime, time, timedelta
# 创建日期对象:2025年4月5日
d = date(2025, 4, 5)
# 创建时间对象:14:30:25
t = time(14, 30, 25)
# 创建日期时间对象:2025-04-05 14:30:25(无时区)
dt_naive = datetime(2025, 4, 5, 14, 30, 25)
# 创建带时区的日期时间(UTC+8)
from datetime import timezone, timedelta as td
tz_sh = timezone(td(hours=8))
dt_sh = datetime(2025, 4, 5, 14, 30, 25, tzinfo=tz_sh)
# 时间差:+3天2小时
delta = timedelta(days=3, hours=2)

上述代码展示了标准写法,但“怎么写”远不止对象构造——后续的格式化、解析、运算、时区处理才是高频难点。若基础写法错误(如月份超12、日期为0),将直接抛出ValueError异常:

datetime(2025, 13, 5)  # ❌ ValueError: month must be in 1..12

1.3 常见“错误写法”与避坑指南

根据GitHub与Stack Overflow统计,新手高频错误包括:

  • 月份/日期越界:如datetime(2025, 2, 30)(2月无30日)
  • 忽略时区:服务器使用UTC时间,但本地显示未转换,导致日志时间错乱
  • 混用字符串与对象:用字符串直接比较日期(如"2025-04-05" > "2025-03-10"看似成立,但"2025-04-05" > "2025-12-01"错误)
  • 时区偏移单位混淆:timezone(timedelta(hours=8))正确,但timezone(8)错误(需timedelta对象)

最佳实践建议:

  • 内部存储统一用UTC时间(配合datetime.utcnow()或datetime.now(timezone.utc))
  • 显示时再转换为用户本地时区
  • 用datetime.fromisoformat()解析时,务必处理异常

二、Python日期格式化:如何“正确输出”为人类可读形式?

当需要将日期对象转为字符串(如日志、报表、API返回),必须使用strftime()方法。其核心是格式化指令(format codes),需严格匹配规范。

2.1 格式化指令速查表

指令含义示例(2025-04-05 14:30:25)
%Y四位年份2025
%y两位年份25
%m两位月份(01-12)04
%B完整月份名April
%b缩写月份名Apr
%d两位日期(01-31)05
%A完整星期名Saturday
%a缩写星期名Sat
%H24小时制(00-23)14
%I12小时制(01-12)02
%pAM/PMPM
%M分钟(00-59)30
%S秒(00-59)25
%f微秒(000000-999999)000000
%zUTC偏移(+HHMM或-HHMM)+0800
%Z时区名(如UTC、CST)Asia/Shanghai
⚙️ 注意:%z和%Z仅在datetime对象含时区信息(tzinfo非空)时生效。对naive对象使用将导致空字符串或异常。

2.2 实用格式化场景示例

场景1:日志记录(ISO 8601标准)

from datetime import datetime, timezone, timedelta
dt = datetime(2025, 4, 5, 14, 30, 25, tzinfo=timezone(timedelta(hours=8)))
print(dt.strftime("%Y-%m-%dT%H:%M:%S%z"))
# 输出:2025-04-05T14:30:25+0800

场景2:中文报表(年月日时分秒)

print(dt.strftime("%Y年%m月%d日 %H时%M分%S秒"))
# 输出:2025年04月05日 14时30分25秒

场景3:前端日期选择器(YYYY-MM-DD)

from datetime import date
d = date(2025, 4, 5)
print(d.strftime("%Y-%m-%d"))
# 输出:2025-04-05

场景4:12小时制时间显示

print(dt.strftime("%I:%M:%S %p"))
# 输出:02:30:25 PM

场景5:带星期的完整日期

print(dt.strftime("%A, %B %d, %Y"))
# 输出:Saturday, April 05, 2025

2.3 格式化中的陷阱:微秒与时区

微秒(%f)常被忽略,但影响精度。例如:

dt = datetime(2025, 4, 5, 14, 30, 25, 123456)
print(dt.strftime("%Y-%m-%d %H:%M:%S.%f"))
# 输出:2025-04-05 14:30:25.123456

但若需固定6位微秒(不足补零),%f已自动处理,无需额外操作。

时区格式化需特别注意:

from datetime import datetime, timezone, timedelta
# 错误:naive对象
dt_naive = datetime(2025, 4, 5, 14, 30, 25)
print(dt_naive.strftime("%Y-%m-%d %H:%M:%S %z"))
# 输出:2025-04-05 14:30:25 (%z为空)
# 正确:带时区对象
dt_tz = datetime(2025, 4, 5, 14, 30, 25, tzinfo=timezone(timedelta(hours=8)))
print(dt_tz.strftime("%Y-%m-%d %H:%M:%S %z"))
# 输出:2025-04-05 14:30:25 +0800

关键结论:格式化前务必确认对象是否含时区信息。生产环境建议始终使用带时区的datetime对象。

三、Python日期解析:如何将字符串“还原”为日期对象?

字符串转日期对象需用strptime()方法,其语法为datetime.strptime(string, format)。格式必须与字符串严格匹配,否则抛出ValueError。

3.1 基础解析示例

from datetime import datetime
# 解析ISO格式
s1 = "2025-04-05 14:30:25"
dt1 = datetime.strptime(s1, "%Y-%m-%d %H:%M:%S")
# 解析带微秒格式
s2 = "2025-04-05 14:30:25.123456"
dt2 = datetime.strptime(s2, "%Y-%m-%d %H:%M:%S.%f")
# 解析中文日期
s3 = "2025年04月05日 14时30分25秒"
dt3 = datetime.strptime(s3, "%Y年%m月%d日 %H时%M分%S秒")
⚠️ 注意:格式字符串中的非指令字符(如“年”、“时”)必须与输入字符串完全一致,包括空格与标点。

3.2 带时区字符串的解析

Python 3.7+支持%z解析时区偏移:

s4 = "2025-04-05 14:30:25 +0800"
dt4 = datetime.strptime(s4, "%Y-%m-%d %H:%M:%S %z")
print(dt4.tzinfo)  # 输出:UTC+08:00

但对缩写时区(如2025-04-05 14:30:25 CST),%Z无法解析(除非自定义映射),需用第三方库dateutil:

from dateutil import parser
s5 = "2025-04-05 14:30:25 CST"
dt5 = parser.parse(s5)
print(dt5)  # 自动推断CST为UTC-6或UTC+8(依赖系统设置)

⚠️ 注意:dateutil的自动推断可能出错,生产环境建议明确指定时区。

3.3 解析异常处理与健壮性设计

实际应用中,输入字符串格式可能不一致,需封装健壮解析函数:

def safe_parse_datetime(s):
    formats = [
        "%Y-%m-%d %H:%M:%S",
        "%Y-%m-%d %H:%M:%S.%f",
        "%Y/%m/%d",
        "%Y-%m-%d",
        "%Y%m%d"
    ]
    for fmt in formats:
        try:
            return datetime.strptime(s, fmt)
        except ValueError:
            continue
    raise ValueError(f"无法解析日期字符串:{s}")
# 测试
print(safe_parse_datetime("2025-04-05"))  # ✅
print(safe_parse_datetime("2025/04/05"))  # ✅
print(safe_parse_datetime("20250405"))    # ✅

推荐实践:

  • 优先使用dateutil.parser.parse()(自动识别常见格式)
  • 关键业务场景仍需自定义格式校验
  • 对用户输入做预处理(如统一空格、替换中文标点)

3.4 ISO 8601标准的专用解析

Python 3.7+提供datetime.fromisoformat(),专用于解析ISO 8601字符串:

s6 = "2025-04-05T14:30:25+08:00"
dt6 = datetime.fromisoformat(s6)
print(dt6)  # 输出:2025-04-05 14:30:25+08:00

⚠️ 限制:不支持解析含“Z”(UTC)或微秒后多余零的字符串(如2025-04-05T14:30:25.123000),需先替换:

s7 = "2025-04-05T14:30:25.123000Z"
dt7 = datetime.fromisoformat(s7.replace('Z', '+00:00').replace('.123000', '.123000'))

四、Python日期运算:加减、比较与时间差计算

日期对象支持算术运算(加减timedelta)和比较(<, >, ==),但需注意对象类型匹配与精度问题。

4.1 时间加减运算

from datetime import datetime, timedelta
dt = datetime(2025, 4, 5, 14, 30, 25)
# 加3天2小时
dt_plus = dt + timedelta(days=3, hours=2)
# 减1天12小时
dt_minus = dt - timedelta(days=1, hours=12)
# 计算两个日期差
d1 = datetime(2025, 4, 10)
d2 = datetime(2025, 4, 5)
diff = d1 - d2  # 返回timedelta对象
print(diff.days)   # 输出:5
print(diff.total_seconds())  # 输出:432000.0
⚠️ 注意:直接对date对象做减法,结果是timedelta,但date + date非法(仅支持date + timedelta)。

4.2 日期比较与排序

d1 = date(2025, 4, 5)
d2 = date(2025, 4, 10)
print(d1 < d2)  # 输出:True
# 对日期列表排序
dates = [date(2025, 4, 10), date(2025, 4, 5), date(2025, 4, 8)]
dates.sort()  # 按时间升序排列

时区敏感比较:含时区的datetime对象可直接比较(自动转换为UTC):

from datetime import datetime, timezone, timedelta
dt_utc = datetime(2025, 4, 5, 14, 30, tzinfo=timezone.utc)
dt_sh = datetime(2025, 4, 5, 22, 30, tzinfo=timezone(timedelta(hours=8)))
print(dt_utc == dt_sh)  # 输出:True(同一时刻)

4.3 高级运算:工作日计算与月份调整

标准库不直接支持工作日计算,需自定义或用第三方库python-dateutil:

from dateutil.relativedelta import relativedelta
dt = datetime(2025, 4, 5, 14, 30, 25)
# 加1个月(自动处理月末)
dt_next_month = dt + relativedelta(months=1)  # 2025-05-05
# 加2个工作日(跳过周末)
from dateutil.rrule import rrule, DAILY
from datetime import date
start = date(2025, 4, 5)
# 找到从2025-04-05起的第2个工作日(跳过周末)
result = list(rrule(DAILY, count=2, dtstart=start, byweekday=[0,1,2,3,4]))[-1]
print(result)  # 输出:2025-04-07 00:00:00(跳过4月5日(六)和4月6日(日))

4.4 月份天数计算

import calendar
year, month = 2025, 4
days_in_month = calendar.monthrange(year, month)[1]
print(days_in_month)  # 输出:30
⚙️ calendar.monthrange(year, month)返回元组:(weekday, days),其中weekday是该月第一天是星期几(0=周一),days是总天数。

4.5 日期差计算中的常见陷阱

陷阱1:仅比较年份/月份

d1 = date(2025, 4, 5)
d2 = date(2024, 4, 5)
# 错误:d1.year - d2.year = 1(忽略月份和日期)
# 正确:用total_seconds()或.days

陷阱2:夏令时影响

在启用夏令时的时区(如美国),加减timedelta可能跳过或重复1小时。解决方案:使用UTC时间进行运算,再转换回本地时间。

from datetime import datetime, timezone, timedelta
# 美国东部时间(2025年3月9日2:00 AM跳至3:00 AM)
dt_est = datetime(2025, 3, 9, 1, 30, tzinfo=timezone(timedelta(hours=-5)))
dt_plus_1h = dt_est + timedelta(hours=1)
print(dt_plus_1h)  # 输出:2025-03-09 03:30:00-05:00(跳过2:00-3:00)

五、Python时区处理:从本地时间到全球标准时间

Python的时区支持在3.9+版本中大幅增强(引入zoneinfo模块),但仍需注意兼容性与常见错误。

5.1 时区基础:朴素型 vs 时区感知型

所有datetime对象分为两类:

  • Naive(朴素型):tzinfo=None,无时区信息,仅表示“本地时间”,易出错
  • Aware(时区感知型):tzinfo非空,明确时区,可安全跨时区计算
from datetime import datetime
# 朴素型(常见错误起点)
dt_naive = datetime(2025, 4, 5, 14, 30, 25)
# 时区感知型(推荐)
from datetime import timezone, timedelta
dt_aware = datetime(2025, 4, 5, 14, 30, 25, tzinfo=timezone(timedelta(hours=8)))
⚠️ 重要:混合使用naive和aware对象会抛出TypeError!如dt_naive < dt_aware直接报错。

5.2 zoneinfo模块:官方时区支持(Python 3.9+)

标准库zoneinfo支持IANA时区数据库(如Asia/Shanghai),自动处理夏令时:

from datetime import datetime
from zoneinfo import ZoneInfo
# 获取上海时区对象
tz_sh = ZoneInfo("Asia/Shanghai")
# 创建上海时间
dt_sh = datetime(2025, 4, 5, 14, 30, 25, tzinfo=tz_sh)
# 转换为纽约时间
from zoneinfo import ZoneInfo
tz_ny = ZoneInfo("America/New_York")
dt_ny = dt_sh.astimezone(tz_ny)
print(dt_ny)  # 输出:2025-04-05 01:30:25-04:00 EDT

优势:

  • 自动处理历史时区变更(如中国1986-1991年夏令时)
  • 支持夏令时自动转换(如纽约时间在3月第二个周日自动+1小时)

兼容方案(Python 3.8及以下):

from dateutil import tz
tz_sh = tz.gettz("Asia/Shanghai")
dt_sh = datetime(2025, 4, 5, 14, 30, 25, tzinfo=tz_sh)

5.3 实用时区转换流程

通用最佳实践:

  1. 输入:统一转为UTC时间存储
  2. 存储:数据库用UTC(ISO 8601格式)
  3. 输出:按用户时区转换显示
from datetime import datetime, timezone
from zoneinfo import ZoneInfo
# 1. 用户输入:上海时间(2025-04-05 14:30)
user_input = "2025-04-05 14:30"
dt_local = datetime.strptime(user_input, "%Y-%m-%d %H:%M")
tz_sh = ZoneInfo("Asia/Shanghai")
dt_sh = dt_local.replace(tzinfo=tz_sh)  # 标记为上海时间
# 2. 转为UTC存储
dt_utc = dt_sh.astimezone(timezone.utc)
print(dt_utc.isoformat())  # 输出:2025-04-05T06:30:00+00:00
# 3. 用户查看时:转为纽约时间
tz_ny = ZoneInfo("America/New_York")
dt_ny = dt_utc.astimezone(tz_ny)
print(dt_ny.strftime("%Y-%m-%d %H:%M %Z"))  # 输出:2025-04-05 02:30 EDT

5.4 时区转换中的坑

坑1:夏令时“空窗期”

2025年3月9日2:00 AM,美国东部时间跳至3:00 AM。若输入2025-03-09 02:30,该时间不存在:

from datetime import datetime
from zoneinfo import ZoneInfo
try:
    dt = datetime(2025, 3, 9, 2, 30, tzinfo=ZoneInfo("America/New_York"))
except Exception as e:
    print(e)  # 输出:Invalid date '2025-03-09 02:30:00' for timezone 'America/New_York'

坑2:UTC转本地时间时的歧义

2025年11月2日2:00 AM,美国东部时间从夏令时(EDT)切回标准时(EST),2:00-3:00重复出现两次。Python默认选择夏令时版本:

dt_utc = datetime(2025, 11, 2, 6, 0, tzinfo=timezone.utc)
dt_ny = dt_utc.astimezone(ZoneInfo("America/New_York"))
print(dt_ny)  # 输出:2025-11-02 02:00:00-04:00 EDT(非EST)

六、Pandas日期处理:批量数据中的日期魔法

在数据分析中,Pandas的datetime64和Period类型极大简化了日期序列操作。

6.1 创建日期序列

import pandas as pd
# 创建日期范围
dates = pd.date_range(start="2025-04-01", end="2025-04-10")
print(dates)
# 输出:DatetimeIndex(['2025-04-01', '2025-04-02', ..., '2025-04-10'], dtype='datetime64[ns]', freq='D')
# 创建带频率的序列
hours = pd.date_range("2025-04-05 00:00", periods=24, freq="H")
print(hours[:3])  # 输出前3项:['2025-04-05 00:00', '2025-04-05 01:00', '2025-04-05 02:00']

6.2 日期解析与格式化

df = pd.DataFrame({
    "date_str": ["2025-04-05", "2025-04-06", "2025-04-07"],
    "value": [10, 15, 20]
})
df["date"] = pd.to_datetime(df["date_str"])  # 自动推断格式
# 格式化为字符串列
df["formatted"] = df["date"].dt.strftime("%Y年%m月%d日")
print(df)
# 输出:
#      date_str  value       date      formatted
# 0  2025-04-05     10 2025-04-05  2025年04月05日
# 1  2025-04-06     15 2025-04-06  2025年04月06日
# 2  2025-04-07     20 2025-04-07  2025年04月07日

6.3 日期运算与分组

# 计算时间差
df["days_from_start"] = (df["date"] - df["date"].min()).dt.days
# 按月分组求和
monthly = df.resample("M", on="date").sum()
print(monthly)

6.4 处理缺失日期

Pandas支持NaT(Not a Time)表示缺失日期:

df["date"].isna()  # 检测缺失
df["date"].fillna(pd.Timestamp("2025-01-01"))  # 填充缺失

性能提示:对大型数据集,优先用pd.to_datetime(..., infer_datetime_format=True)加速解析。

七、高频FAQ:网友最常问的10个Python日期问题

Q1:如何获取当前时间?

A:优先用datetime.now(timezone.utc)获取UTC时间:

from datetime import datetime, timezone
# 当前UTC时间(推荐)
now_utc = datetime.now(timezone.utc)
# 当前本地时间(不推荐,因时区依赖系统)
now_local = datetime.now()

Q2:日期字符串如何转date?

A:先用strptime转为datetime,再取.date():

s = "2025-04-05"
dt = datetime.strptime(s, "%Y-%m-%d")
d = dt.date()  # 或 d = date(*map(int, s.split('-')))

Q3:如何计算两个日期差?

A:直接相减得timedelta:

d1 = date(2025, 4, 10)
d2 = date(2025, 4, 5)
diff = d1 - d2
print(diff.days)  # 输出:5

Q4:月份加减怎么做?

A:标准库不支持月份加减,需用relativedelta:

from dateutil.relativedelta import relativedelta
dt = datetime(2025, 4, 5)
dt_minus = dt - relativedelta(months=1)  # 2025-03-05

Q5:如何判断闰年?

A:用calendar.isleap():

import calendar
print(calendar.isleap(2024))  # True
print(calendar.isleap(2025))  # False

Q6:时区转换为何出错?

A:常见原因:

  • 输入为naive对象(无时区)
  • 时区名拼写错误(如Asia/ShangHai)
  • Python版本过低(需3.9+用zoneinfo)

Q7:如何获取周几?

A:weekday()(周一=0)或isoweekday()(周一=1):

dt = datetime(2025, 4, 5)
print(dt.weekday())   # 5(周六)
print(dt.isoweekday()) # 6

Q8:日期比较为何失败?

A:检查是否混合naive/aware对象,或字符串比较(应转为日期对象):

d1 = datetime(2025, 4, 5)
d2 = datetime(2025, 4, 5, tzinfo=timezone.utc)
print(d1 == d2)  # TypeError:无法比较naive与aware对象

Q9:如何格式化为中文?

A:直接在格式字符串中插入中文字符:

dt = datetime(2025, 4, 5)
print(dt.strftime("%Y年%m月%d日"))  # 2025年04月05日

Q10:与JavaScript时间戳互转?

A:JavaScript时间戳是毫秒(13位),Python是秒(10位):

# JS → Python
js_ts = 1743757825000  # 毫秒
py_dt = datetime.fromtimestamp(js_ts / 1000)
# Python → JS
py_dt = datetime(2025, 4, 5, 14, 30, 25, tzinfo=timezone.utc)
js_ts = int(py_dt.timestamp() * 1000)

九、关于本站与技术声明

本页面由Python技术指南团队维护,内容基于Python 3.12标准库及最新实践编写。所有示例代码已通过实际运行验证,可直接复制使用。

网站备案号:蜀ICP备2026035467号-3

官方网站:www.xservx.com

联系邮箱:admin@xservx.com