一、用法精讲
661、pandas.Timestamp.value 属性
661-1、语法
pandas.Timestamp.value
661-2、参数
无
661-3、功能
用于返回时间戳对应的纳秒级别的整数值，这对于处理时间数据，特别是在需要进行时间计算的场景中非常有用。
661-4、返回值
返回一个整数，表示自 Unix 纪元以来的纳秒数。
661-5、说明
无
661-6、用法
661-6-1、数据准备
无
661-6-2、代码示例
import pandas as pd
# 创建一个 Timestamp 对象
timestamp = pd.Timestamp('2024-10-13 21:53:56')
# 获取其对应的纳秒值
nanoseconds = timestamp.value
print(f'The Timestamp is: {timestamp}')
print(f'The number of nanoseconds since Unix epoch: {nanoseconds}')
661-6-3、结果输出
The Timestamp is: 2024-10-13 21:53:56
The number of nanoseconds since Unix epoch: 1728856436000000000
662、pandas.Timestamp.week 属性
662-1、语法
pandas.Timestamp.week
662-2、参数
无
662-3、功能
用于获取时间戳所在年份的第几周。
662-4、返回值
返回一个整数，表示这一年份的第几周，按照 ISO 8601 标准计算。
662-5、说明
无
662-6、用法
662-6-1、数据准备
无
662-6-2、代码示例
import pandas as pd
# 创建一个 Timestamp 对象
timestamp = pd.Timestamp('2024-10-13')
# 获取该时间戳所在的周数
week_number = timestamp.week
print(f'The Timestamp is: {timestamp}')
print(f'The week number of the year is: {week_number}')
662-6-3、结果输出
The Timestamp is: 2024-10-13 00:00:00
The week number of the year is: 41
663、pandas.Timestamp.weekofyear 属性
663-1、语法
pandas.Timestamp.weekofyear
663-2、参数
无
663-3、功能
一个已经被弃用的属性，用于获取时间戳在一年中的周数。虽然它在较早的版本中可用，但建议使用 pandas.Timestamp.isocalendar() 方法来获取更准确的信息。
663-4、返回值
返回时间戳在一年中的周数。
663-5、说明
无
663-6、用法
663-6-1、数据准备
无
663-6-2、代码示例
import pandas as pd
# 创建一个 Timestamp 对象
timestamp = pd.Timestamp('2024-10-13')
# 获取该时间戳的 ISO 年、周和周的一天
iso_calendar = timestamp.isocalendar()
# 返回一个元组 (year, week, weekday)
# 获取周数
week_of_year = iso_calendar[1]
print(f'The Timestamp is: {timestamp}')
print(f'The week number of the year is: {week_of_year}')
663-6-3、结果输出
The Timestamp is: 2024-10-13 00:00:00
The week number of the year is: 41
664、pandas.Timestamp.year 属性
664-1、语法
pandas.Timestamp.year
664-2、参数
无
664-3、功能
用于获取 Timestamp 对象对应的年份，它的功能是提取时间戳表示日期的年份部分。
664-4、返回值
返回一个整数，表示年份。
664-5、说明
无
664-6、用法
664-6-1、数据准备
无
664-6-2、代码示例
import pandas as pd
# 创建一个 Timestamp 对象
ts = pd.Timestamp('2024-10-13 22:06:00')
# 获取年份
year = ts.year
print(year)
664-6-3、结果输出
2024
665、pandas.Timestamp.as_unit 方法
665-1、语法
pandas.Timestamp.as_unit(unit, round_ok=True)
665-2、参数
**unit(必须)：**字符串，指定所需的时间单位，支持的单位包括 's'(秒),'ms'(毫秒), 'us'(微秒)和'ns'(纳秒)。
**round_ok(可选，默认值为 True)：**布尔值，指定是否允许四舍五入，当为 True 时，如果 Timestamp 无法精确地转换为指定的单位，会自动进行四舍五入；如果为 False，则抛出一个误差超过容差范围的异常。
665-3、功能
将 Timestamp 对象转换为指定的时间单位，使之可以更方便地进行时间单位的精确操作，例如对不同时间单位间进行转换和比较。
665-4、返回值
返回一个新的 Timestamp 对象，这个对象表示转换为指定时间单位后的时间戳。
665-5、说明
无
665-6、用法
665-6-1、数据准备
无
665-6-2、代码示例
import pandas as pd
# 创建一个 Timestamp 对象
timestamp = pd.Timestamp('2024-10-13 22:16:56.789123456')
# 转换为秒
timestamp_sec = timestamp.as_unit('s')
print(timestamp_sec)
# 转换为毫秒
timestamp_ms = timestamp.as_unit('ms')
print(timestamp_ms)
665-6-3、结果输出
2024-10-13 22:16:56
2024-10-13 22:16:56.789000
