跳到主要内容
Python 第三方库 Pandas Timestamp 类及属性用法精讲 | 极客日志
Python 算法
Python 第三方库 Pandas Timestamp 类及属性用法精讲 综述由AI生成 pandas 库中 Timestamp 类的创建方法及常用属性。内容包括通过字符串、参数、时区或数值创建时间戳，以及 asm8 属性转换 numpy 对象。此外还讲解了 day 属性获取日期中的日，dayofweek 和 day_of_week 属性获取星期几的用法与返回值说明，并提供了相应的代码示例和结果输出。
时间旅人 发布于 2026/3/30 更新于 2026/5/23 用法精讲
631、pandas.Timestamp 类
语法
class pandas .Timestamp(ts_input=<object object >, year=None , month=None , day=None , hour=None , minute=None , second=None , microsecond=None , tzinfo=None , *, nanosecond=None , tz=None , unit=None , fold=None )
Pandas replacement for python datetime.datetime object. Timestamp is the pandas equivalent of python's Datetime and is interchangeable with it in most cases. It's the type used for the entries that make up a DatetimeIndex, and other timeseries oriented data structures in pandas.
Parameters:
ts_input: datetime-like, str, int, float. Value to be converted to Timestamp.year, month, day: int. Optional, default None.hour, minute, second, microsecond: int, optional, default 0.tzinfo: datetime.tzinfo, optional, default None.nanosecond: int, optional, default 0.tz: str, pytz.timezone, dateutil.tz.tzfile or None. Time zone for time which Timestamp will have.unit: str. Unit used for conversion if ts_input is of type int or float. Valid values are 'D', 'h', 'm', 's', 'ms', 'us', and 'ns'.fold: {0, 1}, default None, keyword-only. Due to daylight saving time, one wall clock time can occur twice when shifting from summer to winter time; fold describes whether the datetime-like corresponds to the first (0) or the second time (1) the wall clock hits the ambiguous time.
参数
**ts_input(可选，默认值为)：**这可以是一个字符串、数值、datetime 对象或者其他可以被解释为时间戳的对象，如果提供了 ts_input，其他单独的时间参数 (如 year, month 等) 会被忽略。
**year(可选，默认值为 None)：**指定年份 (非负整数)。
**month(可选，默认值为 None)：**指定月份 (1 到 12 的整数)。
**day(可选，默认值为 None)：**指定日期 (1 到 31 的整数，具体取决于月份和年份)。
**hour(可选，默认值为 None)：**指定小时 (0 到 23 的整数)。
**minute(可选，默认值为 None)：**指定分钟 (0 到 59 的整数)。
**second(可选，默认值为 None)：**指定秒数 (0 到 59 的整数)。
**microsecond(可选，默认值为 None)：**指定微秒数 (0 到 999999 的整数)。
**tzinfo(可选，默认值为 None)：**一个 tzinfo 对象，表示时区信息。
**nanosecond(可选，默认值为 None)：**指定纳秒 (0 到 999999999 的整数)。
**tz(可选，默认值为 None)：**时区名称或 tzinfo 对象，可以用于设置时间戳的时区，此参数为可选参数，如果提供则默认为 None。
**unit(可选，默认值为 None)：**字符串，指定 ts_input 值的单位。例如's'(秒)、'ms'(毫秒)、'us'(微秒)、'ns'(纳秒) 等等。
**fold(可选，默认值为 None)：**仅仅用于支持 Python 3.6 及以上的 PEP 495，表示时间折叠，在有 DST 变化时，时间会重复出现两次。
功能 用于创建和操作时间戳，它提供了多种方法来格式化、比较和解析时间数据，它兼容 datetime.datetime，因此可以与标准 Python 的日期和时间处理方法互操作。
返回值 返回一个时间戳对象，该对象封装了日期和时间信息，并提供了一些有用的方法和属性来操作时间数据。
说明
用法
数据准备
代码示例
import pandas as pd
timestamp1 = pd.Timestamp('2024-10-04 18:47:00' )
print (timestamp1)
timestamp2 = pd.Timestamp(year=2024 , month=10 , day=4 , hour=18 , minute=47 , second=0 )
print (timestamp2)
timestamp3 = pd.Timestamp('2024-10-04 18:47:00' , tz='UTC' )
print (timestamp3)
timestamp4 = pd.Timestamp(1728067620.0 , unit='s' )
print (timestamp4)
print ("Year:" , timestamp1.year)
print ("Month:" , timestamp1.month)
print ("Day:" , timestamp1.day)
print ("Hour:" , timestamp1.hour)
print ("Minute:" , timestamp1.minute)
print ("Second:" , timestamp1.second)
print ("Microsecond:" , timestamp1.microsecond)
print ("Nanosecond:" , timestamp1.nanosecond)
print ("Time zone:" , timestamp3.tz)
结果输出
632、pandas.Timestamp.asm8 属性
语法 Return numpy datetime64 format in nanoseconds.
参数
功能 将一个 pandas.Timestamp 对象转换为 NumPy 的 datetime64 对象，这对于需要进行高效矢量化操作或与 NumPy 数组进行兼容性处理的操作特别有用。
返回值 返回一个 NumPy datetime64 对象，其值与 Timestamp 对象表示的日期和时间相对应。
说明
用法
数据准备
代码示例
import pandas as pd
timestamp = pd.Timestamp('2024-10-04 18:47:00' )
numpy_datetime = timestamp.asm8
print (type (numpy_datetime), numpy_datetime)
结果输出 <class 'numpy.datetime64' > 2024 -10 -04 T18:47 :00
633、pandas.Timestamp.day 属性
语法
参数
功能 从一个 pandas.Timestamp 对象中提取并返回其表示的日期中的'日'，这对于需要从时间戳中获取具体日期信息的场景，尤其是需要对日期进行过滤、分组或显示格式化等操作时非常有用。
返回值 返回一个整数值，表示该 Timestamp 对象对应日期是一个月中的第几天。
说明
用法
数据准备
代码示例
import pandas as pd
timestamp1 = pd.Timestamp('2024-10-04 18:47:00' )
print (timestamp1.day)
timestamp2 = pd.Timestamp(year=2024 , month=8 , day=15 , hour=12 , minute=30 )
print (timestamp2.day)
结果输出
634、pandas.Timestamp.dayofweek 属性
语法 pandas.Timestamp.dayofweek
Return day of the week. Returns: int
参数
功能 从一个 pandas.Timestamp 对象中提取并返回其表示的星期几，对于需要对日期进行特定的逻辑条件检查 (例如，判断是否是工作日或周末) 以及分组分析的场景，这一特性非常有帮助。
返回值 返回一个整数值，表示该 Timestamp 对象对应日期的星期几，其中 0 代表星期一，1 代表星期二，以此类推，直到 6 代表星期日。
说明
用法
数据准备
代码示例
import pandas as pd
timestamp1 = pd.Timestamp('2024-10-04 18:47:00' )
print (timestamp1.dayofweek)
timestamp2 = pd.Timestamp('2024-10-15 12:30:00' )
print (timestamp2.dayofweek)
结果输出
635、pandas.Timestamp.day_of_week 属性
语法 pandas.Timestamp.day_of_week
Return day of the week. Returns: int
参数
功能 从一个 pandas.Timestamp 对象中提取并返回其表示的星期几，这对于需要日期分析和逻辑条件判断的场景非常有用。例如，判断某天是否是工作日或周末，或者在分组分析中按星期几分组等。
返回值 返回一个整数值，表示该 Timestamp 对象对应日期的星期几，0 代表星期一，1 代表星期二，一直到 6 代表星期日。
说明
用法
数据准备
代码示例
import pandas as pd
timestamp1 = pd.Timestamp('2024-10-06 18:47:00' )
print (timestamp1.day_of_week)
timestamp2 = pd.Timestamp('2024-06-15 12:30:00' )
print (timestamp2.day_of_week)
结果输出 相关免费在线工具 加密/解密文本 使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
Gemini 图片去水印 基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印，支持批量处理与下载。 在线工具，Gemini 图片去水印在线工具，online
curl 转代码 解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
Markdown转HTML 将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
