polars.Expr.cast

Expr.cast(
    dtype: PolarsDataType | DataTypeExpr | type[Any],
    *,
    strict: bool = True,
    wrap_numerical: bool = False,
) → Expr

Преобразование между типами данных.

движок:В памятиПотоковая обработкаРаспределённая обработка

Параметры:

dtype

Тип данных, к которому нужно привести значение.

strict

Вызывать исключение, если преобразование недопустимо для строк после проталкивания предикатов. Если False, недопустимые преобразования будут давать значения null.

wrap_numerical

Если True, при числовых преобразованиях переполняющиеся значения циклически переходят в допустимый диапазон, а не помечаются как результат недопустимого преобразования.

Примеры

>>> df = pl.DataFrame(
...     {
...         "a": [1, 2, 3],
...         "b": ["4", "5", "6"],
...     }
... )
>>> df.with_columns(
...     pl.col("a").cast(pl.Float64),
...     pl.col("b").cast(pl.Int32),
... )
shape: (3, 2)
┌─────┬─────┐
│ a   ┆ b   │
│ --- ┆ --- │
│ f64 ┆ i32 │
╞═════╪═════╡
│ 1.0 ┆ 4   │
│ 2.0 ┆ 5   │
│ 3.0 ┆ 6   │
└─────┴─────┘