Python获取当前时间戳的代码实现

咖啡半糖
咖啡半糖
发布时间:2026-11-17 | 5人浏览过
原创

系统介绍在Python中获取当前时间戳的完整代码实现,覆盖秒级、毫秒级与微秒级时间戳转换,深入解析time与datetime模块的差异及生产环境最佳实践。

假设你正在为接口设计请求限流机制,或者需要在数据库日志中写入毫秒级的事件触发时间,此时最直接的技术手段就是生成当前 Unix 时间戳。在 Python 中,获取当前时间戳最常用的标准做法是通过内置的 time 模块调用 time.time() 获取秒级浮点数,或使用 time.time_ns() 直接获取无精度丢失的纳秒级整数。本文将由浅入深讲解获取秒级、毫秒级和微秒级时间戳的多种实现方式,并分析不同场景下的最佳选型。

一、基于 time 模块的基础实现

time 是 Python 的内置标准库模块,直接封装了操作系统底层的 C 语言时间接口,是获取系统时间戳性能最高、开销最小的方式。

1. 获取秒级时间戳

time.time() 会返回一个自 Unix 纪元(1970年1月1日 00:00:00 UTC)起至当前的浮点型秒数。如果业务场景需要整型秒数(例如 JWT 签发时间或标准 Token 过期时间),可以使用 int() 进行向下截断转换:

import time

# 获取浮点型秒级时间戳
ts_float = time.time()

# 转换为整型秒级时间戳
ts_sec = int(ts_float)

print("秒级浮点时间戳 (示例):", ts_float)
print("秒级整型时间戳 (示例):", ts_sec)

示例输出:

秒级浮点时间戳 (示例): 1760601000.123456
秒级整型时间戳 (示例): 1760601000

2. 获取毫秒级时间戳(13位)

现代 Web 接口与分布式系统(如 Java 后端接口、Kafka 消息队列、雪花算法 Snowflake)普遍使用 13 位毫秒级时间戳。通过乘法缩放浮点秒即可得到:

import time

# 乘以 1000 并取整为 13 位毫秒时间戳
ts_milli = int(time.time() * 1000)
print("毫秒级时间戳 (示例):", ts_milli)

示例输出:

毫秒级时间戳 (示例): 1760601000123
Python获取当前时间戳的代码实现
图1:获取当前时间戳并进行位数换算的完整执行逻辑

二、Python 3.7+ 的高精度原生方案:time_ns

在 Python 3.7 之前,通过 time.time() * 1000 或 * 1000000 获取更高精度时间戳时,底层依赖 64 位 IEEE 754 浮点数运算。由于浮点数在表示大数值时尾数位数有限,毫秒与微秒末位偶尔会出现微小的精度抖动。

为了从根本上规避浮点精度损耗,Python 3.7 引入了 time.time_ns()。该函数直接以整型返回自 Unix 纪元起的纳秒数(19位长整型)。通过整除运算即可纯整型导出毫秒或微秒:

import time

# 获取纳秒时间戳 (整型,无浮点损耗)
ts_nano = time.time_ns()

# 整除 1,000,000 得到 13 位毫秒时间戳
ts_milli_clean = ts_nano // 1_000_000

# 整除 1,000 得到 16 位微秒时间戳
ts_micro_clean = ts_nano // 1_000

print("纳秒整型时间戳 (示例):", ts_nano)
print("毫秒整型时间戳 (示例):", ts_milli_clean)
print("微秒整型时间戳 (示例):", ts_micro_clean)

示例输出:

纳秒整型时间戳 (示例): 1760601000123456789
毫秒整型时间戳 (示例): 1760601000123
微秒整型时间戳 (示例): 1760601000123456
Python获取当前时间戳的代码实现
图2:操作系统内核时间到 Python 运行时的传递机制

三、基于 datetime 模块的对象级时间戳获取

如果在获取时间戳的同时,程序还需要对日期、小时、星期进行格式化输出或计算,使用内置的 datetime 模块会更加直观。

1. datetime.now().timestamp()

从 Python 3.3 开始,datetime 对象原生提供了 timestamp() 方法:

from datetime import datetime

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

# 获取时间戳
ts_dt = now.timestamp()
print("datetime 获取的时间戳 (示例):", ts_dt)

示例输出:

datetime 获取的时间戳 (示例): 1760601000.123456

2. 时区感知(Timezone-Aware)对象的时间戳

直接调用 datetime.now() 得到的是一个朴素时间对象(naive datetime),它不包含显式的时区信息。如果服务器运行在跨国云环境,或者需要严格保证时区一致性,建议使用带 UTC 时区的感知对象(aware datetime):

from datetime import datetime, timezone

# 显式使用 UTC 时区获取当前时间
now_utc = datetime.now(timezone.utc)

# 转换时间戳
ts_utc = now_utc.timestamp()
print("UTC 感知对象时间戳 (示例):", ts_utc)

注意:不论是本地时间还是显式 UTC 时间,只要它们表示现实中的同一瞬时,调用 .timestamp() 计算出的 Unix 秒数必定完全相同,因为时间戳本身就是全球统一的基准计量。

四、主流实现方案对比与选型指南

在实际工程开发中,选择哪种方法主要取决于性能诉求、精度要求以及是否涉及日期解析。

方法名称 所属模块 返回值类型 典型使用场景 调用耗时与开销
time.time() time float (秒) 常规秒级/毫秒级记录、日志打点 极低 (纯 C 函数调用)
time.time_ns() time int (纳秒) 严格整数毫秒、微秒计算、高精度计时 极低 (无浮点转换开销)
datetime.now().timestamp() datetime float (秒) 同时需要日期提取与时间戳转换的业务 中等 (需构建 datetime 实例)
Python获取当前时间戳的代码实现
图3:根据业务场景与精度诉求选择最契合的 API

五、工程实践中的避坑检查项

在生产环境中处理时间戳时,经常会出现因精度位数不一致或时区理解偏差导致的偶发缺陷。建议在代码落地时关注以下四点:

  • 区分时间戳位数(10位 vs 13位):Python 原生返回的秒级整型是 10 位数,而前端 JavaScript(如 Date.now())及很多 Java 接口默认采用 13 位毫秒级。在与外部系统交互时,必须提前确认对端要求的单位,避免时间错位几百年。
  • 优先使用整除避免截断异常:如果使用 time.time_ns() 换算毫秒,务必使用整除运算符 // 1_000_000,而不是单斜杠 /,否则结果又会退化为浮点数。
  • 性能敏感路径避免频繁实例化 datetime:在高并发循环中,time.time() 的耗时通常在几十纳秒级别,而创建 datetime.now() 对象需要分配内存和初始化属性,耗时会有数倍差异。纯打点场景首选 time 模块。
  • 跨平台墙上时钟同步注意:time.time() 反映的是系统的真实时间。如果服务器启用了 NTP 且发生时间大幅回拨,时间戳可能会出现非单调递增。若需要测量某段代码的精确耗时,应使用单调时钟 time.monotonic() 或 time.perf_counter(),而不是时间戳。
Python获取当前时间戳的代码实现
图4:上线前关键规范与常见隐患核对清单

六、快速上手代码汇总

为方便日常查阅与快速复制,以下汇总了最常用的几个时间戳获取函数封装:

import time
from datetime import datetime

def get_current_timestamps():
    """获取多种规格的当前时间戳字典"""
    now_ns = time.time_ns()
    return {
        "second_int": now_ns // 1_000_000_000,    # 10 位整型秒
        "second_float": time.time(),              # 浮点型秒
        "milli_int": now_ns // 1_000_000,         # 13 位整型毫秒 (推荐)
        "micro_int": now_ns // 1_000,             # 16 位整型微秒
        "nano_int": now_ns                        # 19 位整型纳秒
    }

if __name__ == "__main__":
    result = get_current_timestamps()
    for k, v in result.items():
        print(f"{k:12s}: {v}")
相关专题:

本站声明

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

Python 相关产品和应用

全部下载

专题列表