h SSKJr SSKrSSKJr SSKJrJr SSKJ r SSK J r SSK Jr SSKJr \R""\5 SSKJr SSS5 \(aSS KJr SS KJr SS KJrJr SS KJrJr \SS S S.SSjjj5r\SS S.SSjjj5r\SS S.SSjjj5rSSSS.SSjjjr\SS S S.SSjjj5r\SS S.SSjjj5r\SS S.SSjjj5rSSSS.SSjjjrg!,(df  GN=f)) annotationsN)time) TYPE_CHECKINGoverload) functions)parse_into_expression) wrap_expr)parse_interval_argument) timedelta)Literal)ExprSeries)ClosedIntervalIntoExprColumn.)closedeagercgNstartendintervalrrs [/home/james-whalen/.local/lib/python3.13/site-packages/polars/functions/range/time_range.py time_ranger )rcgrrrs rrr"rcgrrrs rrr-rbothFc^[U5nSHnXR;dM SU<3n[U5e Uc [SSS5nUc[SSSS5n[U5n[U5n[ [ R "XxX#55n U(a$[R"U 5R5$U $)ax Generate a time range. Parameters ---------- start Lower bound of the time range. If omitted, defaults to `time(0,0,0,0)`. end Upper bound of the time range. If omitted, defaults to `time(23,59,59,999999)`. interval Interval of the range periods, specified as a Python `timedelta` object or using the Polars duration string language (see "Notes" section below). closed : {'both', 'left', 'right', 'none'} Define which sides of the range are closed (inclusive). eager Evaluate immediately and return a `Series`. If set to `False` (default), return an expression instead. Returns ------- Expr or Series Column of data type `:class:Time`. Notes ----- `interval` is created according to the following string language: - 1ns (1 nanosecond) - 1us (1 microsecond) - 1ms (1 millisecond) - 1s (1 second) - 1m (1 minute) - 1h (1 hour) - 1d (1 calendar day) - 1w (1 calendar week) - 1mo (1 calendar month) - 1q (1 calendar quarter) - 1y (1 calendar year) Or combine them: "3d12h4m25s" # 3 days, 12 hours, 4 minutes, and 25 seconds By "calendar day", we mean the corresponding time on the next day (which may not be 24 hours, due to daylight savings). Similarly for "calendar week", "calendar month", "calendar quarter", and "calendar year". See Also -------- time_ranges : Create a column of time ranges. Examples -------- >>> from datetime import time, timedelta >>> pl.time_range( ... start=time(14, 0), ... interval=timedelta(hours=3, minutes=15), ... eager=True, ... ).alias("time") shape: (4,) Series: 'time' [time] [ 14:00:00 17:15:00 20:30:00 23:45:00 ] ymowd,invalid interval unit for time_range: found r;?B) r ValueErrorrrr plrrFselect to_series rrrrrunitmsg start_pyexpr end_pyexprresults rrr8sZ'x0H%  @ICS/ !&  }Q1  {2r2v&(/L&s+J s~~lQ RF xx))++ Mrcgrrrs r time_rangesr9rrcgrrrs rr9r9rrcgrrrs rr9r9r!rc^[U5nSHnXR;dM SU<3n[U5e Uc [SSS5nUc[SSSS5n[U5n[U5n[ [ R "XxX#55n U(a$[R"U 5R5$U $)u Create a column of time ranges. Parameters ---------- start Lower bound of the time range. If omitted, defaults to `time(0, 0, 0, 0)`. end Upper bound of the time range. If omitted, defaults to `time(23, 59, 59, 999999)`. interval Interval of the range periods, specified as a Python `timedelta` object or using the Polars duration string language (see "Notes" section below). closed : {'both', 'left', 'right', 'none'} Define which sides of the range are closed (inclusive). eager Evaluate immediately and return a `Series`. If set to `False` (default), return an expression instead. Returns ------- Expr or Series Column of data type `List(Time)`. Notes ----- `interval` is created according to the following string language: - 1ns (1 nanosecond) - 1us (1 microsecond) - 1ms (1 millisecond) - 1s (1 second) - 1m (1 minute) - 1h (1 hour) - 1d (1 calendar day) - 1w (1 calendar week) - 1mo (1 calendar month) - 1q (1 calendar quarter) - 1y (1 calendar year) Or combine them: "3d12h4m25s" # 3 days, 12 hours, 4 minutes, and 25 seconds By "calendar day", we mean the corresponding time on the next day (which may not be 24 hours, due to daylight savings). Similarly for "calendar week", "calendar month", "calendar quarter", and "calendar year". See Also -------- time_range : Generate a single time range. Examples -------- >>> from datetime import time >>> df = pl.DataFrame( ... { ... "start": [time(9, 0), time(10, 0)], ... "end": time(11, 0), ... } ... ) >>> df.with_columns(time_range=pl.time_ranges("start", "end")) shape: (2, 3) ┌──────────┬──────────┬────────────────────────────────┐ │ start ┆ end ┆ time_range │ │ --- ┆ --- ┆ --- │ │ time ┆ time ┆ list[time] │ ╞══════════╪══════════╪════════════════════════════════╡ │ 09:00:00 ┆ 11:00:00 ┆ [09:00:00, 10:00:00, 11:00:00] │ │ 10:00:00 ┆ 11:00:00 ┆ [10:00:00, 11:00:00] │ └──────────┴──────────┴────────────────────────────────┘ r$r)rr*r+r,) r r-rrr r.r9r/r0r1r2s rr9r9s`'x0H%  @ICS/ !&  }Q1  {2r2v&(/L&s+J s|R SF xx))++ Mr)...) rtime | IntoExprColumn | Nonerr=rstr | timedeltarrrzLiteral[False]returnr ) rr=rr=rr>rrrz Literal[True]r?r) rr=rr=rr>rrrboolr?z Series | Expr)NN1h) __future__r contextlibdatetimertypingrrpolarsrr/polars._utils.parserpolars._utils.wrapr polars.functions.range._utilsr suppress ImportError polars._plr_plrr.r r r rpolars._typingrrrr9rrrrOsI"*!5(A%&"#= *-(+ # !  ' %       *-(+ # !  ' %       *-(+ # !  ' %     +/(, $` $ ` '` %``  `  ``F *-(+ # !  ' %       *-(+ # !  ' %       *-(+ # !  ' %     +/(, $c $ c 'c %cc  c  cca&%s E  E/