polars replace-time-zone для таблицы данных
Заменяет информацию о часовом поясе в столбце даты и времени.
Сигнатура
> polars replace-time-zone {flags} (time_zone)
Флаги
-
--ambiguous, -a {oneof<string, nothing>}: Определяет способ обработки неоднозначных дат и времени:raise(по умолчанию): вызвать ошибкуearliest: использовать самую раннюю дату и времяlatest: использовать самую позднюю дату и времяnull: установить значение null -
--nonexistent, -n {oneof<string, nothing>}: Определяет способ обработки несуществующих дат и времени: вызвать ошибку (по умолчанию) или установить значение null.
Параметры
-
time_zone: Часовой пояс для серии Datetime. Передайтеnull, чтобы сбросить часовой пояс.
Типы входных и выходных данных:
| входные данные | выходные данные |
|---|---|
| polars_expression | polars_expression |
| polars_selector | polars_expression |
Примеры
Применение часового пояса к дате и времени без часового пояса
> ["2021-12-30 00:00:00" "2021-12-31 00:00:00"] | polars into-df
| polars as-datetime "%Y-%m-%d %H:%M:%S" --naive
| polars select (polars col datetime | polars replace-time-zone "America/New_York")
╭───┬─────────────╮
│ # │ datetime │
├───┼─────────────┤
│ 0 │ 4 years ago │
│ 1 │ 4 years ago │
╰───┴─────────────╯Применение часового пояса к неоднозначной дате и времени
> ["2025-11-02 00:00:00", "2025-11-02 01:00:00", "2025-11-02 02:00:00", "2025-11-02 03:00:00"]
| polars into-df
| polars as-datetime "%Y-%m-%d %H:%M:%S" --naive
| polars select (polars col datetime | polars replace-time-zone "America/New_York" --ambiguous null)
╭───┬──────────────╮
│ # │ datetime │
├───┼──────────────┤
│ 0 │ 6 months ago │
│ 1 │ │
│ 2 │ 6 months ago │
│ 3 │ 6 months ago │
╰───┴──────────────╯
Применение часового пояса к несуществующей дате и времени
> ["2025-03-09 01:00:00", "2025-03-09 02:00:00", "2025-03-09 03:00:00", "2025-03-09 04:00:00"]
| polars into-df
| polars as-datetime "%Y-%m-%d %H:%M:%S" --naive
| polars select (polars col datetime | polars replace-time-zone "America/New_York" --nonexistent null)
╭───┬────────────╮
│ # │ datetime │
├───┼────────────┤
│ 0 │ a year ago │
│ 1 │ │
│ 2 │ a year ago │
│ 3 │ a year ago │
╰───┴────────────╯
Copyright © 2019–2026 The Nushell Project DevelopersLicensed under the MIT License.
https://www.nushell.sh/commands/docs/polars_replace-time-zone.html
