polars as-datetime для dataframe

Сигнатура

> polars as-datetime {flags} (format)

Флаги

• --not-exact, -n: Строка формата может содержаться в дате (например, foo-2021-01-01-bar может соответствовать 2021-01-01).
• --naive: Входные значения даты и времени должны обрабатываться как значения без часового пояса (то есть без привязки к часовому поясу). Игнорируется, если входные данные являются выражением.
• --ambiguous, -a {oneof<string, nothing>}: Определяет способ обработки неоднозначных значений даты и времени: raise (по умолчанию): вызвать ошибку earliest: использовать самое раннее значение даты и времени latest: использовать самое позднее значение даты и времени null: установить значение null Используется только для lazyframe или выражения, в остальных случаях игнорируется
• --time-unit {string}: Единица измерения времени для выходного значения даты и времени. Возможные значения: ns, us, ms. По умолчанию — ns.
• --time-zone {string}: Часовой пояс для выходного значения даты и времени. Например, 'UTC', 'America/New_York'.

Параметры

• format: Формат строки даты и времени.

Типы входных и выходных данных:

Примеры

Преобразует строку в дату и время

> ["2021-12-30 00:00:00 -0400" "2021-12-31 00:00:00 -0400"] | polars into-df | polars as-datetime "%Y-%m-%d %H:%M:%S %z"
╭───┬─────────────╮
│ # │  datetime   │
├───┼─────────────┤
│ 0 │ 4 years ago │
│ 1 │ 4 years ago │
╰───┴─────────────╯

Преобразует строку в дату и время с высокой точностью

> ["2021-12-30 00:00:00.123456789" "2021-12-31 00:00:00.123456789"] | polars into-df | polars as-datetime "%Y-%m-%d %H:%M:%S.%9f" --naive
╭───┬─────────────╮
│ # │  datetime   │
├───┼─────────────┤
│ 0 │ 4 years ago │
│ 1 │ 4 years ago │
╰───┴─────────────╯

Преобразует строку в дату и время с использованием флага --not-exact, даже если присутствуют лишние символы

> ["2021-12-30 00:00:00 GMT+4"] | polars into-df | polars as-datetime "%Y-%m-%d %H:%M:%S" --not-exact --naive
╭───┬─────────────╮
│ # │  datetime   │
├───┼─────────────┤
│ 0 │ 4 years ago │
╰───┴─────────────╯

Преобразует строку в дату и время с использованием флага --not-exact, даже если в выражении присутствуют лишние символы

> ["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 select (polars col 0 | polars as-datetime "%Y-%m-%d %H:%M:%S")
╭───┬──────────────╮
│ # │   datetime   │
├───┼──────────────┤
│ 0 │ 6 months ago │
│ 1 │ 6 months ago │
│ 2 │ 6 months ago │
│ 3 │ 6 months ago │
╰───┴──────────────╯

Примечания

Примеры форматов: "%y/%m/%d %H:%M:%S" => 21/12/31 12:54:98 "%y-%m-%d %H:%M:%S" => 2021-12-31 24:58:01 "%y/%m/%d %H:%M:%S" => 21/12/31 24:58:01 "%y%m%d %H:%M:%S" => 210319 23:58:50 "%Y/%m/%d %H:%M:%S" => 2021/12/31 12:54:98 "%Y-%m-%d %H:%M:%S" => 2021-12-31 24:58:01 "%Y/%m/%d %H:%M:%S" => 2021/12/31 24:58:01 "%Y%m%d %H:%M:%S" => 20210319 23:58:50 "%FT%H:%M:%S" => 2019-04-18T02:45:55 "%FT%H:%M:%S.%6f" => микросекунды "%FT%H:%M:%S.%9f" => наносекунды