如何修改pandas中Timestamp的默认字符串格式？

问题场景 #

默认情况下，Pandas的Timestamp打印时会显示完整的时分秒信息，即使原时间没有秒数：

import pandas as pd
ts = pd.Timestamp('2017-01-01T12')

print(f"Timestamp: {ts}")
# 输出: Timestamp: 2017-01-01 12:00:00

虽然可以通过strftime()手动指定格式，但大量print语句中重复写这个方法会很繁琐：

print(f"Timestamp: {ts.strftime('%Y-%m-%d %H:%M')}")
# 输出: Timestamp: 2017-01-01 12:00

可行解决方案 #

方案1：设置全局时间显示格式 #

通过修改Pandas的全局配置项，统一调整所有时间对象的字符串输出格式，包括Timestamp和DataFrame中的日期列：

import pandas as pd

# 全局设置时间显示格式
pd.options.display.date_format = '%Y-%m-%d %H:%M'

ts = pd.Timestamp('2017-01-01T12')
print(f"Timestamp: {ts}")
# 输出: Timestamp: 2017-01-01 12:00

注意：该设置会作用于所有Pandas时间相关对象，适合全局统一格式的场景。

方案2：子类化Timestamp并重写字符串方法 #

如果不想影响全局配置，可以自定义Timestamp子类，重写__str__（或__repr__）方法来定制输出：

import pandas as pd

class CustomTimestamp(pd.Timestamp):
    def __str__(self):
        return self.strftime('%Y-%m-%d %H:%M')
    
    # 可选：重写__repr__以在交互式环境中也显示自定义格式
    def __repr__(self):
        return f"CustomTimestamp('{self.__str__()}')"

# 使用自定义时间戳类
ts = CustomTimestamp('2017-01-01T12')
print(f"Timestamp: {ts}")
# 输出: Timestamp: 2017-01-01 12:00

这种方式仅对自定义子类生效，原生Timestamp不受影响，适合局部定制的场景。

内容的提问来源于stack exchange，提问作者fuenfundachtzig