polars.Series.dt.replace#

Series.dt.replace(
*,
year: int | Series | None = None,
month: int | Series | None = None,
day: int | Series | None = None,
hour: int | Series | None = None,
minute: int | Series | None = None,
second: int | Series | None = None,
microsecond: int | Series | None = None,
ambiguous: Ambiguous | Series = 'raise',
) → Series[source]#

替换时间单位。

Parameters:
year

字面量或系列。

month

字面量或系列，范围从1到12。

day

字面量或系列，范围从1到31。

hour

字面量或系列，范围从0到23。

minute

字面量或系列，范围从0到59。

second

字面量或系列，范围从0到59。

microsecond

字面量或系列，范围从0到999999。

ambiguous

确定如何处理模糊的日期时间：

  • 'raise' (默认): 抛出异常

  • 'earliest': 使用最早的日期时间

  • 'latest': 使用最新的日期时间

  • 'null': 设置为null

Returns:
Series

数据类型为 Date 或 Datetime 的序列，其中指定的时间单位已被替换。

示例

>>> from datetime import date
>>> s = pl.Series("date", [date(2013, 1, 1), date(2024, 1, 2)])
>>> s.dt.replace(year=1800)
shape: (2,)
Series: 'date' [date]
[
        1800-01-01
        1800-01-02
]
On this page