polars-df 0.2.5 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +8 -0
  3. data/Cargo.lock +290 -137
  4. data/Cargo.toml +1 -1
  5. data/ext/polars/Cargo.toml +5 -4
  6. data/ext/polars/src/apply/dataframe.rs +6 -6
  7. data/ext/polars/src/apply/series.rs +10 -10
  8. data/ext/polars/src/batched_csv.rs +6 -4
  9. data/ext/polars/src/conversion.rs +40 -13
  10. data/ext/polars/src/dataframe.rs +45 -43
  11. data/ext/polars/src/error.rs +8 -8
  12. data/ext/polars/src/file.rs +5 -4
  13. data/ext/polars/src/lazy/apply.rs +1 -1
  14. data/ext/polars/src/lazy/dataframe.rs +12 -6
  15. data/ext/polars/src/lazy/dsl.rs +99 -45
  16. data/ext/polars/src/lazy/meta.rs +10 -9
  17. data/ext/polars/src/lib.rs +28 -29
  18. data/ext/polars/src/object.rs +2 -1
  19. data/ext/polars/src/series.rs +23 -21
  20. data/lib/polars/cat_expr.rb +0 -4
  21. data/lib/polars/cat_name_space.rb +0 -4
  22. data/lib/polars/convert.rb +0 -7
  23. data/lib/polars/data_frame.rb +139 -204
  24. data/lib/polars/date_time_expr.rb +19 -151
  25. data/lib/polars/date_time_name_space.rb +17 -17
  26. data/lib/polars/expr.rb +68 -315
  27. data/lib/polars/group_by.rb +68 -51
  28. data/lib/polars/io.rb +1 -1
  29. data/lib/polars/lazy_frame.rb +1 -103
  30. data/lib/polars/lazy_functions.rb +0 -26
  31. data/lib/polars/lazy_group_by.rb +0 -8
  32. data/lib/polars/list_expr.rb +5 -27
  33. data/lib/polars/list_name_space.rb +5 -8
  34. data/lib/polars/series.rb +20 -16
  35. data/lib/polars/string_expr.rb +20 -76
  36. data/lib/polars/string_name_space.rb +5 -15
  37. data/lib/polars/struct_expr.rb +0 -2
  38. data/lib/polars/version.rb +1 -1
  39. metadata +3 -3
data/lib/polars/date_time_expr.rb CHANGED
@@ -51,17 +51,11 @@ module Polars
51
51
  # # │ datetime[μs] │
52
52
  # # ╞═════════════════════╡
53
53
  # # │ 2001-01-01 00:00:00 │
54
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
55
54
  # # │ 2001-01-01 03:45:00 │
56
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
57
55
  # # │ 2001-01-01 07:30:00 │
58
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
59
56
  # # │ 2001-01-01 11:15:00 │
60
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
61
57
  # # │ 2001-01-01 15:00:00 │
62
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
63
58
  # # │ 2001-01-01 18:45:00 │
64
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
65
59
  # # │ 2001-01-01 22:30:00 │
66
60
  # # └─────────────────────┘
67
61
  #
@@ -75,17 +69,11 @@ module Polars
75
69
  # # │ datetime[μs] │
76
70
  # # ╞═════════════════════╡
77
71
  # # │ 2001-01-01 00:00:00 │
78
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
79
72
  # # │ 2001-01-01 03:00:00 │
80
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
81
73
  # # │ 2001-01-01 07:00:00 │
82
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
83
74
  # # │ 2001-01-01 11:00:00 │
84
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
85
75
  # # │ 2001-01-01 15:00:00 │
86
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
87
76
  # # │ 2001-01-01 18:00:00 │
88
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
89
77
  # # │ 2001-01-01 22:00:00 │
90
78
  # # └─────────────────────┘
91
79
  #
@@ -102,17 +90,11 @@ module Polars
102
90
  # # │ datetime[μs] ┆ datetime[μs] │
103
91
  # # ╞═════════════════════╪═════════════════════╡
104
92
  # # │ 2001-01-01 00:00:00 ┆ 2001-01-01 00:00:00 │
105
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
106
93
  # # │ 2001-01-01 00:10:00 ┆ 2001-01-01 00:00:00 │
107
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
108
94
  # # │ 2001-01-01 00:20:00 ┆ 2001-01-01 00:00:00 │
109
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
110
95
  # # │ 2001-01-01 00:30:00 ┆ 2001-01-01 00:30:00 │
111
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
112
96
  # # │ 2001-01-01 00:40:00 ┆ 2001-01-01 00:30:00 │
113
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
114
97
  # # │ 2001-01-01 00:50:00 ┆ 2001-01-01 00:30:00 │
115
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
116
98
  # # │ 2001-01-01 01:00:00 ┆ 2001-01-01 01:00:00 │
117
99
  # # └─────────────────────┴─────────────────────┘
118
100
  def truncate(every, offset: nil)
@@ -177,17 +159,11 @@ module Polars
177
159
  # # │ datetime[μs] │
178
160
  # # ╞═════════════════════╡
179
161
  # # │ 2001-01-01 00:00:00 │
180
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
181
162
  # # │ 2001-01-01 03:45:00 │
182
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
183
163
  # # │ 2001-01-01 07:30:00 │
184
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
185
164
  # # │ 2001-01-01 11:15:00 │
186
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
187
165
  # # │ 2001-01-01 15:00:00 │
188
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
189
166
  # # │ 2001-01-01 18:45:00 │
190
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
191
167
  # # │ 2001-01-01 22:30:00 │
192
168
  # # └─────────────────────┘
193
169
  #
@@ -201,17 +177,11 @@ module Polars
201
177
  # # │ datetime[μs] │
202
178
  # # ╞═════════════════════╡
203
179
  # # │ 2001-01-01 00:00:00 │
204
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
205
180
  # # │ 2001-01-01 04:00:00 │
206
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
207
181
  # # │ 2001-01-01 08:00:00 │
208
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
209
182
  # # │ 2001-01-01 11:00:00 │
210
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
211
183
  # # │ 2001-01-01 15:00:00 │
212
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
213
184
  # # │ 2001-01-01 19:00:00 │
214
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
215
185
  # # │ 2001-01-01 23:00:00 │
216
186
  # # └─────────────────────┘
217
187
  #
@@ -228,17 +198,11 @@ module Polars
228
198
  # # │ datetime[μs] ┆ datetime[μs] │
229
199
  # # ╞═════════════════════╪═════════════════════╡
230
200
  # # │ 2001-01-01 00:00:00 ┆ 2001-01-01 00:00:00 │
231
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
232
201
  # # │ 2001-01-01 00:10:00 ┆ 2001-01-01 00:00:00 │
233
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
234
202
  # # │ 2001-01-01 00:20:00 ┆ 2001-01-01 00:30:00 │
235
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
236
203
  # # │ 2001-01-01 00:30:00 ┆ 2001-01-01 00:30:00 │
237
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
238
204
  # # │ 2001-01-01 00:40:00 ┆ 2001-01-01 00:30:00 │
239
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
240
205
  # # │ 2001-01-01 00:50:00 ┆ 2001-01-01 01:00:00 │
241
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
242
206
  # # │ 2001-01-01 01:00:00 ┆ 2001-01-01 01:00:00 │
243
207
  # # └─────────────────────┴─────────────────────┘
244
208
  def round(every, offset: nil)
@@ -283,11 +247,8 @@ module Polars
283
247
  # # │ datetime[μs] │
284
248
  # # ╞═════════════════════╡
285
249
  # # │ 2001-01-01 00:00:00 │
286
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
287
250
  # # │ 2001-06-30 00:00:00 │
288
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
289
251
  # # │ 2001-12-27 00:00:00 │
290
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
291
252
  # # │ 2002-06-25 00:00:00 │
292
253
  # # └─────────────────────┘
293
254
  #
@@ -301,11 +262,8 @@ module Polars
301
262
  # # │ i32 │
302
263
  # # ╞══════╡
303
264
  # # │ 2001 │
304
- # # ├╌╌╌╌╌╌┤
305
265
  # # │ 2001 │
306
- # # ├╌╌╌╌╌╌┤
307
266
  # # │ 2001 │
308
- # # ├╌╌╌╌╌╌┤
309
267
  # # │ 2002 │
310
268
  # # └──────┘
311
269
  def year
@@ -344,9 +302,7 @@ module Polars
344
302
  # # │ datetime[μs] │
345
303
  # # ╞═════════════════════╡
346
304
  # # │ 2001-01-01 00:00:00 │
347
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
348
305
  # # │ 2001-06-30 00:00:00 │
349
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
350
306
  # # │ 2001-12-27 00:00:00 │
351
307
  # # └─────────────────────┘
352
308
  #
@@ -360,9 +316,7 @@ module Polars
360
316
  # # │ u32 │
361
317
  # # ╞══════╡
362
318
  # # │ 1 │
363
- # # ├╌╌╌╌╌╌┤
364
319
  # # │ 2 │
365
- # # ├╌╌╌╌╌╌┤
366
320
  # # │ 4 │
367
321
  # # └──────┘
368
322
  def quarter
@@ -390,9 +344,7 @@ module Polars
390
344
  # # │ datetime[μs] │
391
345
  # # ╞═════════════════════╡
392
346
  # # │ 2001-01-01 00:00:00 │
393
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
394
347
  # # │ 2001-02-01 00:00:00 │
395
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
396
348
  # # │ 2001-03-04 00:00:00 │
397
349
  # # └─────────────────────┘
398
350
  #
@@ -406,9 +358,7 @@ module Polars
406
358
  # # │ u32 │
407
359
  # # ╞══════╡
408
360
  # # │ 1 │
409
- # # ├╌╌╌╌╌╌┤
410
361
  # # │ 2 │
411
- # # ├╌╌╌╌╌╌┤
412
362
  # # │ 3 │
413
363
  # # └──────┘
414
364
  def month
@@ -436,9 +386,7 @@ module Polars
436
386
  # # │ datetime[μs] │
437
387
  # # ╞═════════════════════╡
438
388
  # # │ 2001-01-01 00:00:00 │
439
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
440
389
  # # │ 2001-02-01 00:00:00 │
441
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
442
390
  # # │ 2001-03-04 00:00:00 │
443
391
  # # └─────────────────────┘
444
392
  #
@@ -452,9 +400,7 @@ module Polars
452
400
  # # │ u32 │
453
401
  # # ╞══════╡
454
402
  # # │ 1 │
455
- # # ├╌╌╌╌╌╌┤
456
403
  # # │ 5 │
457
- # # ├╌╌╌╌╌╌┤
458
404
  # # │ 9 │
459
405
  # # └──────┘
460
406
  def week
@@ -481,9 +427,7 @@ module Polars
481
427
  # # │ datetime[μs] │
482
428
  # # ╞═════════════════════╡
483
429
  # # │ 2001-01-01 00:00:00 │
484
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
485
430
  # # │ 2001-01-04 00:00:00 │
486
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
487
431
  # # │ 2001-01-07 00:00:00 │
488
432
  # # └─────────────────────┘
489
433
  #
@@ -503,9 +447,7 @@ module Polars
503
447
  # # │ u32 ┆ u32 ┆ u32 │
504
448
  # # ╞═════════╪══════════════╪═════════════╡
505
449
  # # │ 1 ┆ 1 ┆ 1 │
506
- # # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
507
450
  # # │ 4 ┆ 4 ┆ 4 │
508
- # # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
509
451
  # # │ 7 ┆ 7 ┆ 7 │
510
452
  # # └─────────┴──────────────┴─────────────┘
511
453
  def weekday
@@ -533,9 +475,7 @@ module Polars
533
475
  # # │ datetime[μs] │
534
476
  # # ╞═════════════════════╡
535
477
  # # │ 2001-01-01 00:00:00 │
536
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
537
478
  # # │ 2001-01-04 00:00:00 │
538
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
539
479
  # # │ 2001-01-07 00:00:00 │
540
480
  # # └─────────────────────┘
541
481
  #
@@ -555,9 +495,7 @@ module Polars
555
495
  # # │ u32 ┆ u32 ┆ u32 │
556
496
  # # ╞═════════╪══════════════╪═════════════╡
557
497
  # # │ 1 ┆ 1 ┆ 1 │
558
- # # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
559
498
  # # │ 4 ┆ 4 ┆ 4 │
560
- # # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
561
499
  # # │ 7 ┆ 7 ┆ 7 │
562
500
  # # └─────────┴──────────────┴─────────────┘
563
501
  def day
@@ -585,9 +523,7 @@ module Polars
585
523
  # # │ datetime[μs] │
586
524
  # # ╞═════════════════════╡
587
525
  # # │ 2001-01-01 00:00:00 │
588
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
589
526
  # # │ 2001-01-04 00:00:00 │
590
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
591
527
  # # │ 2001-01-07 00:00:00 │
592
528
  # # └─────────────────────┘
593
529
  #
@@ -607,9 +543,7 @@ module Polars
607
543
  # # │ u32 ┆ u32 ┆ u32 │
608
544
  # # ╞═════════╪══════════════╪═════════════╡
609
545
  # # │ 1 ┆ 1 ┆ 1 │
610
- # # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
611
546
  # # │ 4 ┆ 4 ┆ 4 │
612
- # # ├╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌┤
613
547
  # # │ 7 ┆ 7 ┆ 7 │
614
548
  # # └─────────┴──────────────┴─────────────┘
615
549
  def ordinal_day
@@ -636,9 +570,7 @@ module Polars
636
570
  # # │ datetime[μs] │
637
571
  # # ╞═════════════════════╡
638
572
  # # │ 2001-01-01 00:00:00 │
639
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
640
573
  # # │ 2001-01-01 12:00:00 │
641
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
642
574
  # # │ 2001-01-02 00:00:00 │
643
575
  # # └─────────────────────┘
644
576
  #
@@ -652,9 +584,7 @@ module Polars
652
584
  # # │ u32 │
653
585
  # # ╞══════╡
654
586
  # # │ 0 │
655
- # # ├╌╌╌╌╌╌┤
656
587
  # # │ 12 │
657
- # # ├╌╌╌╌╌╌┤
658
588
  # # │ 0 │
659
589
  # # └──────┘
660
590
  def hour
@@ -681,9 +611,7 @@ module Polars
681
611
  # # │ datetime[μs] │
682
612
  # # ╞═════════════════════╡
683
613
  # # │ 2001-01-01 00:00:00 │
684
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
685
614
  # # │ 2001-01-01 00:02:00 │
686
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
687
615
  # # │ 2001-01-01 00:04:00 │
688
616
  # # └─────────────────────┘
689
617
  #
@@ -697,9 +625,7 @@ module Polars
697
625
  # # │ u32 │
698
626
  # # ╞══════╡
699
627
  # # │ 0 │
700
- # # ├╌╌╌╌╌╌┤
701
628
  # # │ 2 │
702
- # # ├╌╌╌╌╌╌┤
703
629
  # # │ 4 │
704
630
  # # └──────┘
705
631
  def minute
@@ -734,9 +660,7 @@ module Polars
734
660
  # # │ datetime[μs] │
735
661
  # # ╞════════════════════════════╡
736
662
  # # │ 2001-01-01 00:00:00.456789 │
737
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
738
663
  # # │ 2001-01-01 00:00:03.111110 │
739
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
740
664
  # # │ 2001-01-01 00:00:05.765431 │
741
665
  # # └────────────────────────────┘
742
666
  #
@@ -750,9 +674,7 @@ module Polars
750
674
  # # │ u32 │
751
675
  # # ╞══════╡
752
676
  # # │ 0 │
753
- # # ├╌╌╌╌╌╌┤
754
677
  # # │ 3 │
755
- # # ├╌╌╌╌╌╌┤
756
678
  # # │ 5 │
757
679
  # # └──────┘
758
680
  #
@@ -765,9 +687,7 @@ module Polars
765
687
  # # │ f64 │
766
688
  # # ╞══════════╡
767
689
  # # │ 0.456789 │
768
- # # ├╌╌╌╌╌╌╌╌╌╌┤
769
690
  # # │ 3.11111 │
770
- # # ├╌╌╌╌╌╌╌╌╌╌┤
771
691
  # # │ 5.765431 │
772
692
  # # └──────────┘
773
693
  #
@@ -785,9 +705,7 @@ module Polars
785
705
  # # │ datetime[μs] │
786
706
  # # ╞═════════════════════╡
787
707
  # # │ 2001-01-01 00:00:00 │
788
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
789
708
  # # │ 2001-01-01 00:00:02 │
790
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
791
709
  # # │ 2001-01-01 00:00:04 │
792
710
  # # └─────────────────────┘
793
711
  #
@@ -801,9 +719,7 @@ module Polars
801
719
  # # │ u32 │
802
720
  # # ╞══════╡
803
721
  # # │ 0 │
804
- # # ├╌╌╌╌╌╌┤
805
722
  # # │ 2 │
806
- # # ├╌╌╌╌╌╌┤
807
723
  # # │ 4 │
808
724
  # # └──────┘
809
725
  def second(fractional: false)
@@ -868,9 +784,7 @@ module Polars
868
784
  # # │ datetime[μs] ┆ i64 ┆ i64 │
869
785
  # # ╞═════════════════════╪═════════════════╪═══════════╡
870
786
  # # │ 2001-01-01 00:00:00 ┆ 978307200000000 ┆ 978307200 │
871
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┤
872
787
  # # │ 2001-01-02 00:00:00 ┆ 978393600000000 ┆ 978393600 │
873
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┤
874
788
  # # │ 2001-01-03 00:00:00 ┆ 978480000000000 ┆ 978480000 │
875
789
  # # └─────────────────────┴─────────────────┴───────────┘
876
790
  def epoch(tu = "us")
@@ -911,9 +825,7 @@ module Polars
911
825
  # # │ datetime[μs] ┆ i64 ┆ i64 │
912
826
  # # ╞═════════════════════╪═════════════════╪══════════════╡
913
827
  # # │ 2001-01-01 00:00:00 ┆ 978307200000000 ┆ 978307200000 │
914
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
915
828
  # # │ 2001-01-02 00:00:00 ┆ 978393600000000 ┆ 978393600000 │
916
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
917
829
  # # │ 2001-01-03 00:00:00 ┆ 978480000000000 ┆ 978480000000 │
918
830
  # # └─────────────────────┴─────────────────┴──────────────┘
919
831
  def timestamp(tu = "us")
@@ -952,9 +864,7 @@ module Polars
952
864
  # # │ datetime[ns] ┆ datetime[μs] │
953
865
  # # ╞═════════════════════╪═══════════════════════╡
954
866
  # # │ 2001-01-01 00:00:00 ┆ +32971-04-28 00:00:00 │
955
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
956
867
  # # │ 2001-01-02 00:00:00 ┆ +32974-01-22 00:00:00 │
957
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
958
868
  # # │ 2001-01-03 00:00:00 ┆ +32976-10-18 00:00:00 │
959
869
  # # └─────────────────────┴───────────────────────┘
960
870
  def with_time_unit(tu)
@@ -991,9 +901,7 @@ module Polars
991
901
  # # │ datetime[μs] ┆ datetime[ms] ┆ datetime[ns] │
992
902
  # # ╞═════════════════════╪═════════════════════╪═════════════════════╡
993
903
  # # │ 2001-01-01 00:00:00 ┆ 2001-01-01 00:00:00 ┆ 2001-01-01 00:00:00 │
994
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
995
904
  # # │ 2001-01-02 00:00:00 ┆ 2001-01-02 00:00:00 ┆ 2001-01-02 00:00:00 │
996
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
997
905
  # # │ 2001-01-03 00:00:00 ┆ 2001-01-03 00:00:00 ┆ 2001-01-03 00:00:00 │
998
906
  # # └─────────────────────┴─────────────────────┴─────────────────────┘
999
907
  def cast_time_unit(tu)
@@ -1011,7 +919,10 @@ module Polars
1011
919
  # df = Polars::DataFrame.new(
1012
920
  # {
1013
921
  # "date" => Polars.date_range(
1014
- # DateTime.new(2020, 3, 1), DateTime.new(2020, 5, 1), "1mo"
922
+ # DateTime.new(2020, 3, 1),
923
+ # DateTime.new(2020, 5, 1),
924
+ # "1mo",
925
+ # time_zone: "UTC"
1015
926
  # )
1016
927
  # }
1017
928
  # )
@@ -1019,38 +930,36 @@ module Polars
1019
930
  # [
1020
931
  # Polars.col("date"),
1021
932
  # Polars.col("date")
1022
- # .dt.with_time_zone("Europe/London")
933
+ # .dt.convert_time_zone("Europe/London")
1023
934
  # .alias("London")
1024
935
  # ]
1025
936
  # )
1026
937
  # # =>
1027
938
  # # shape: (3, 2)
1028
- # # ┌─────────────────────┬─────────────────────────────┐
1029
- # # │ date ┆ London │
1030
- # # │ --- ┆ --- │
1031
- # # │ datetime[μs] ┆ datetime[μs, Europe/London] │
1032
- # # ╞═════════════════════╪═════════════════════════════╡
1033
- # # │ 2020-03-01 00:00:00 ┆ 2020-03-01 00:00:00 GMT │
1034
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1035
- # # │ 2020-04-01 00:00:00 ┆ 2020-04-01 01:00:00 BST │
1036
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1037
- # # │ 2020-05-01 00:00:00 ┆ 2020-05-01 01:00:00 BST │
1038
- # # └─────────────────────┴─────────────────────────────┘
1039
- def with_time_zone(tz)
1040
- Utils.wrap_expr(_rbexpr.dt_with_time_zone(tz))
939
+ # # ┌─────────────────────────┬─────────────────────────────┐
940
+ # # │ date ┆ London │
941
+ # # │ --- ┆ --- │
942
+ # # │ datetime[μs, UTC] ┆ datetime[μs, Europe/London] │
943
+ # # ╞═════════════════════════╪═════════════════════════════╡
944
+ # # │ 2020-03-01 00:00:00 UTC ┆ 2020-03-01 00:00:00 GMT │
945
+ # # │ 2020-04-01 00:00:00 UTC ┆ 2020-04-01 01:00:00 BST │
946
+ # # │ 2020-05-01 00:00:00 UTC ┆ 2020-05-01 01:00:00 BST │
947
+ # # └─────────────────────────┴─────────────────────────────┘
948
+ def convert_time_zone(tz)
949
+ Utils.wrap_expr(_rbexpr.dt_convert_time_zone(tz))
1041
950
  end
1042
951
 
1043
952
  # Cast time zone for a Series of type Datetime.
1044
953
  #
1045
- # Different from `with_time_zone`, this will also modify
954
+ # Different from `convert_time_zone`, this will also modify
1046
955
  # the underlying timestamp,
1047
956
  #
1048
957
  # @param tz [String]
1049
958
  # Time zone for the `Datetime` Series.
1050
959
  #
1051
960
  # @return [Expr]
1052
- def cast_time_zone(tz)
1053
- Utils.wrap_expr(_rbexpr.dt_cast_time_zone(tz))
961
+ def replace_time_zone(tz)
962
+ Utils.wrap_expr(_rbexpr.dt_replace_time_zone(tz))
1054
963
  end
1055
964
 
1056
965
  # Localize tz-naive Datetime Series to tz-aware Datetime Series.
@@ -1092,9 +1001,7 @@ module Polars
1092
1001
  # # │ datetime[μs] ┆ i64 │
1093
1002
  # # ╞═════════════════════╪═══════════╡
1094
1003
  # # │ 2020-03-01 00:00:00 ┆ null │
1095
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┤
1096
1004
  # # │ 2020-04-01 00:00:00 ┆ 31 │
1097
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┤
1098
1005
  # # │ 2020-05-01 00:00:00 ┆ 30 │
1099
1006
  # # └─────────────────────┴───────────┘
1100
1007
  def days
@@ -1127,11 +1034,8 @@ module Polars
1127
1034
  # # │ datetime[μs] ┆ i64 │
1128
1035
  # # ╞═════════════════════╪════════════╡
1129
1036
  # # │ 2020-01-01 00:00:00 ┆ null │
1130
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
1131
1037
  # # │ 2020-01-02 00:00:00 ┆ 24 │
1132
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
1133
1038
  # # │ 2020-01-03 00:00:00 ┆ 24 │
1134
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌┤
1135
1039
  # # │ 2020-01-04 00:00:00 ┆ 24 │
1136
1040
  # # └─────────────────────┴────────────┘
1137
1041
  def hours
@@ -1164,11 +1068,8 @@ module Polars
1164
1068
  # # │ datetime[μs] ┆ i64 │
1165
1069
  # # ╞═════════════════════╪══════════════╡
1166
1070
  # # │ 2020-01-01 00:00:00 ┆ null │
1167
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1168
1071
  # # │ 2020-01-02 00:00:00 ┆ 1440 │
1169
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1170
1072
  # # │ 2020-01-03 00:00:00 ┆ 1440 │
1171
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1172
1073
  # # │ 2020-01-04 00:00:00 ┆ 1440 │
1173
1074
  # # └─────────────────────┴──────────────┘
1174
1075
  def minutes
@@ -1201,13 +1102,9 @@ module Polars
1201
1102
  # # │ datetime[μs] ┆ i64 │
1202
1103
  # # ╞═════════════════════╪══════════════╡
1203
1104
  # # │ 2020-01-01 00:00:00 ┆ null │
1204
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1205
1105
  # # │ 2020-01-01 00:01:00 ┆ 60 │
1206
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1207
1106
  # # │ 2020-01-01 00:02:00 ┆ 60 │
1208
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1209
1107
  # # │ 2020-01-01 00:03:00 ┆ 60 │
1210
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1211
1108
  # # │ 2020-01-01 00:04:00 ┆ 60 │
1212
1109
  # # └─────────────────────┴──────────────┘
1213
1110
  def seconds
@@ -1240,21 +1137,13 @@ module Polars
1240
1137
  # # │ datetime[μs] ┆ i64 │
1241
1138
  # # ╞═════════════════════════╪═══════════════════╡
1242
1139
  # # │ 2020-01-01 00:00:00 ┆ null │
1243
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1244
1140
  # # │ 2020-01-01 00:00:00.001 ┆ 1 │
1245
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1246
1141
  # # │ 2020-01-01 00:00:00.002 ┆ 1 │
1247
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1248
1142
  # # │ 2020-01-01 00:00:00.003 ┆ 1 │
1249
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1250
1143
  # # │ ... ┆ ... │
1251
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1252
1144
  # # │ 2020-01-01 00:00:00.997 ┆ 1 │
1253
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1254
1145
  # # │ 2020-01-01 00:00:00.998 ┆ 1 │
1255
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1256
1146
  # # │ 2020-01-01 00:00:00.999 ┆ 1 │
1257
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1258
1147
  # # │ 2020-01-01 00:00:01 ┆ 1 │
1259
1148
  # # └─────────────────────────┴───────────────────┘
1260
1149
  def milliseconds
@@ -1287,21 +1176,13 @@ module Polars
1287
1176
  # # │ datetime[μs] ┆ i64 │
1288
1177
  # # ╞═════════════════════════╪═══════════════════╡
1289
1178
  # # │ 2020-01-01 00:00:00 ┆ null │
1290
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1291
1179
  # # │ 2020-01-01 00:00:00.001 ┆ 1000 │
1292
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1293
1180
  # # │ 2020-01-01 00:00:00.002 ┆ 1000 │
1294
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1295
1181
  # # │ 2020-01-01 00:00:00.003 ┆ 1000 │
1296
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1297
1182
  # # │ ... ┆ ... │
1298
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1299
1183
  # # │ 2020-01-01 00:00:00.997 ┆ 1000 │
1300
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1301
1184
  # # │ 2020-01-01 00:00:00.998 ┆ 1000 │
1302
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1303
1185
  # # │ 2020-01-01 00:00:00.999 ┆ 1000 │
1304
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1305
1186
  # # │ 2020-01-01 00:00:01 ┆ 1000 │
1306
1187
  # # └─────────────────────────┴───────────────────┘
1307
1188
  def microseconds
@@ -1334,21 +1215,13 @@ module Polars
1334
1215
  # # │ datetime[μs] ┆ i64 │
1335
1216
  # # ╞═════════════════════════╪══════════════════╡
1336
1217
  # # │ 2020-01-01 00:00:00 ┆ null │
1337
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1338
1218
  # # │ 2020-01-01 00:00:00.001 ┆ 1000000 │
1339
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1340
1219
  # # │ 2020-01-01 00:00:00.002 ┆ 1000000 │
1341
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1342
1220
  # # │ 2020-01-01 00:00:00.003 ┆ 1000000 │
1343
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1344
1221
  # # │ ... ┆ ... │
1345
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1346
1222
  # # │ 2020-01-01 00:00:00.997 ┆ 1000000 │
1347
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1348
1223
  # # │ 2020-01-01 00:00:00.998 ┆ 1000000 │
1349
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1350
1224
  # # │ 2020-01-01 00:00:00.999 ┆ 1000000 │
1351
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1352
1225
  # # │ 2020-01-01 00:00:01 ┆ 1000000 │
1353
1226
  # # └─────────────────────────┴──────────────────┘
1354
1227
  def nanoseconds
@@ -1400,15 +1273,10 @@ module Polars
1400
1273
  # # │ datetime[μs] ┆ datetime[μs] │
1401
1274
  # # ╞═════════════════════╪═════════════════════╡
1402
1275
  # # │ 2001-01-01 00:00:00 ┆ 1998-11-01 00:00:00 │
1403
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1404
1276
  # # │ 2002-01-01 00:00:00 ┆ 1999-11-01 00:00:00 │
1405
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1406
1277
  # # │ 2003-01-01 00:00:00 ┆ 2000-11-01 00:00:00 │
1407
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1408
1278
  # # │ 2004-01-01 00:00:00 ┆ 2001-11-01 00:00:00 │
1409
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1410
1279
  # # │ 2005-01-01 00:00:00 ┆ 2002-11-01 00:00:00 │
1411
- # # ├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
1412
1280
  # # │ 2006-01-01 00:00:00 ┆ 2003-11-01 00:00:00 │
1413
1281
  # # └─────────────────────┴─────────────────────┘
1414
1282
  def offset_by(by)
data/lib/polars/date_time_name_space.rb CHANGED
@@ -887,18 +887,18 @@ module Polars
887
887
  # @example
888
888
  # start = DateTime.new(2020, 3, 1)
889
889
  # stop = DateTime.new(2020, 5, 1)
890
- # date = Polars.date_range(start, stop, "1mo")
890
+ # date = Polars.date_range(start, stop, "1mo", time_zone: "UTC")
891
891
  # # =>
892
892
  # # shape: (3,)
893
- # # Series: '' [datetime[μs]]
893
+ # # Series: '' [datetime[μs, UTC]]
894
894
  # # [
895
- # # 2020-03-01 00:00:00
896
- # # 2020-04-01 00:00:00
897
- # # 2020-05-01 00:00:00
895
+ # # 2020-03-01 00:00:00 UTC
896
+ # # 2020-04-01 00:00:00 UTC
897
+ # # 2020-05-01 00:00:00 UTC
898
898
  # # ]
899
899
  #
900
900
  # @example
901
- # date.dt.with_time_zone("Europe/London").alias("London")
901
+ # date.dt.convert_time_zone("Europe/London").alias("London")
902
902
  # # =>
903
903
  # # shape: (3,)
904
904
  # # Series: 'London' [datetime[μs, Europe/London]]
@@ -907,7 +907,7 @@ module Polars
907
907
  # # 2020-04-01 01:00:00 BST
908
908
  # # 2020-05-01 01:00:00 BST
909
909
  # # ]
910
- def with_time_zone(tz)
910
+ def convert_time_zone(tz)
911
911
  super
912
912
  end
913
913
 
@@ -924,14 +924,14 @@ module Polars
924
924
  # @example
925
925
  # start = DateTime.new(2020, 3, 1)
926
926
  # stop = DateTime.new(2020, 5, 1)
927
- # date = Polars.date_range(start, stop, "1mo")
927
+ # date = Polars.date_range(start, stop, "1mo", time_zone: "UTC")
928
928
  # # =>
929
929
  # # shape: (3,)
930
- # # Series: '' [datetime[μs]]
930
+ # # Series: '' [datetime[μs, UTC]]
931
931
  # # [
932
- # # 2020-03-01 00:00:00
933
- # # 2020-04-01 00:00:00
934
- # # 2020-05-01 00:00:00
932
+ # # 2020-03-01 00:00:00 UTC
933
+ # # 2020-04-01 00:00:00 UTC
934
+ # # 2020-05-01 00:00:00 UTC
935
935
  # # ]
936
936
  #
937
937
  # @example
@@ -946,7 +946,7 @@ module Polars
946
946
  # # ]
947
947
  #
948
948
  # @example
949
- # date = date.dt.with_time_zone("Europe/London").alias("London")
949
+ # date = date.dt.convert_time_zone("Europe/London").alias("London")
950
950
  # # =>
951
951
  # # shape: (3,)
952
952
  # # Series: 'London' [datetime[μs, Europe/London]]
@@ -956,7 +956,7 @@ module Polars
956
956
  # # 2020-05-01 01:00:00 BST
957
957
  # # ]
958
958
  #
959
- # @example Timestamps have not changed after with_time_zone
959
+ # @example Timestamps have not changed after convert_time_zone
960
960
  # date.dt.epoch("s")
961
961
  # # =>
962
962
  # # shape: (3,)
@@ -968,7 +968,7 @@ module Polars
968
968
  # # ]
969
969
  #
970
970
  # @example
971
- # date = date.dt.cast_time_zone("America/New_York").alias("NYC")
971
+ # date = date.dt.replace_time_zone("America/New_York").alias("NYC")
972
972
  # # =>
973
973
  # # shape: (3,)
974
974
  # # Series: 'NYC' [datetime[μs, America/New_York]]
@@ -978,7 +978,7 @@ module Polars
978
978
  # # 2020-05-01 01:00:00 EDT
979
979
  # # ]
980
980
  #
981
- # @example Timestamps have changed after cast_time_zone
981
+ # @example Timestamps have changed after replace_time_zone
982
982
  # date.dt.epoch("s")
983
983
  # # =>
984
984
  # # shape: (3,)
@@ -988,7 +988,7 @@ module Polars
988
988
  # # 1585717200
989
989
  # # 1588309200
990
990
  # # ]
991
- def cast_time_zone(tz)
991
+ def replace_time_zone(tz)
992
992
  super
993
993
  end
994
994