polars.lit

polars.lit(
    value: Any,
    dtype: PolarsDataType | DataTypeExpr | None = None,
    *,
    allow_object: bool = False,
) → Expr

Возвращает выражение, представляющее литеральное значение.

Параметры:

value

Значение, которое следует использовать в качестве literal.

dtype

Тип данных результирующего выражения. Если задано None (по умолчанию), тип данных определяется на основе входных данных value.

allow_object

Если тип неизвестен, используется тип «object». По умолчанию, если тип неизвестен, будет вызвана ошибка ValueException.

Примечания

Ожидаемые типы данных:

• pl.lit([]) -> пустой List<Null>
• pl.lit([1, 2, 3]) -> List<i64>
• pl.lit(pl.Series([]))-> пустой Series Null
• pl.lit(pl.Series([1, 2, 3])) -> Series Int64
• pl.lit(None) -> Null

Примеры

Скалярные литеральные значения:

>>> pl.lit(1)  
>>> pl.lit(5.5)  
>>> pl.lit(None)  
>>> pl.lit("foo_bar")  
>>> pl.lit(date(2021, 1, 20))  
>>> pl.lit(datetime(2023, 3, 31, 10, 30, 45))  

Литеральные данные списка/Series (1D):

>>> pl.lit([1, 2, 3])  
>>> pl.lit(pl.Series("x", [1, 2, 3]))  

Литеральные данные списка/Series (2D):

>>> pl.lit([[1, 2], [3, 4]])  
>>> pl.lit(pl.Series("y", [[1, 2], [3, 4]]))