polars.Series.round

Series.round(
    decimals: int = 0,
    mode: RoundMode = 'half_to_even',
) → Series

Округляет базовые данные с плавающей точкой до decimals знаков.

Параметры:

decimals

Количество знаков после запятой для округления.

mode{‘half_to_even’, ‘half_away_from_zero’, ‘to_zero’}

Используемая стратегия округления. «Округлённое значение» — это значение, имеющее не более decimals знаков после запятой (например, целые числа при decimals=0, значения, кратные 0.1, при decimals=1, 0.01 при decimals=2 и так далее).

Стратегии, начинающиеся с half_, округляют все значения до ближайшего округлённого значения, используя стратегию только для разрешения случаев равенства, когда значение находится ровно посередине между двумя округлёнными значениями (например, 0.5 при decimals=0, 0.05 при decimals=1). Другие стратегии округления явно задают, какое округлённое значение выбирается, и применяются всегда, а не только при разрешении равенства.

• half_to_even (по умолчанию)

  Округление до ближайшего значения; при равенстве выбирается ближайшее чётное значение. Например, 0.5 округляется до 0, 1.5 — до 2, 2.5 — до 2. Этот метод также известен как «банковское округление»; он используется по умолчанию, поскольку обычно минимизирует накопление ошибки округления.

• half_away_from_zero

  Округление до ближайшего значения; при равенстве выполняется округление от нуля. Например, 0.5 округляется до 1, -0.5 — до -1, 2.5 — до 3. Этот метод также известен как «коммерческое округление».

• to_zero

  Всегда округляет (усекает) в сторону нуля, отбрасывая дробную часть после decimals. Например, 0.9 округляется до 0, -0.9 — до 0, 1.29 — до 1.2 (при decimals=1). Эквивалентно методу truncate().

Примеры

>>> s = pl.Series("a", [1.12345, 2.56789, 3.901234])
>>> s.round(2)
shape: (3,)
Series: 'a' [f64]
[
    1.12
    2.57
    3.9
]

>>> s = pl.Series([-3.5, -2.5, -1.5, -0.5, 0.5, 1.5, 2.5, 3.5])
>>> s.round(mode="half_to_even")
shape: (8,)
Series: '' [f64]
[
    -4.0
    -2.0
    -2.0
    -0.0
    0.0
    2.0
    2.0
    4.0
]