class_docstr: Namespace for datetime related expressions.
docstr: Base offset from UTC.
  
  This is usually constant for all datetimes in a given time zone, but
  may vary in the rare case that a country switches time zone, like
  Samoa (Apia) did at the end of 2011.
  
  Returns
  -------
  Expr
      Expression of data type :class:`Duration`.
  
  See Also
  --------
  Expr.dt.dst_offset : Daylight savings offset from UTC.
  
  Examples
  --------
  >>> from datetime import datetime
  >>> df = pl.DataFrame(
  ...     {
  ...         "ts": [datetime(2011, 12, 29), datetime(2012, 1, 1)],
  ...     }
  ... )
  >>> df = df.with_columns(pl.col("ts").dt.replace_time_zone("Pacific/Apia"))
  >>> df.with_columns(pl.col("ts").dt.base_utc_offset().alias("base_utc_offset"))
  shape: (2, 2)
  ┌────────────────────────────┬─────────────────┐
  │ ts                         ┆ base_utc_offset │
  │ ---                        ┆ ---             │
  │ datetime[μs, Pacific/Apia] ┆ duration[ms]    │
  ╞════════════════════════════╪═════════════════╡
  │ 2011-12-29 00:00:00 -10    ┆ -11h            │
  │ 2012-01-01 00:00:00 +14    ┆ 13h             │
  └────────────────────────────┴─────────────────┘
docstr_tok: ["Base","offset","from","UTC",".","This","is","usually","constant","for","all","datetimes","in","a","given","time","zone",",","but","may","vary","in","the","rare","case","that","a","country","switches","time","zone",",","like","Samoa","(","Apia",")","did","at","the","end","of","2011",".","Returns","--","--","--","-","Expr","Expression","of","data","type",":","class",":","`","Duration","`",".","See","Also","--","--","--","--","Expr.dt.dst_offset",":","Daylight","savings","offset","from","UTC",".","Examples","--","--","--","--",">",">",">","from","datetime","import","datetime",">",">",">","df","=","pl.DataFrame","(","...","{","...","``","ts","''",":","[","datetime","(","2011",",","12",",","29",")",",","datetime","(","2012",",","1",",","1",")","]",",","...","}","...",")",">",">",">","df","=","df.with_columns","(","pl.col","(","``","ts","''",")",".dt.replace_time_zone","(","``","Pacific\/Apia","''",")",")",">",">",">","df.with_columns","(","pl.col","(","``","ts","''",")",".dt.base_utc_offset","(",")",".alias","(","``","base_utc_offset","''",")",")","shape",":","(","2",",","2",")","\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510","\u2502","ts","\u2506","base_utc_offset","\u2502","\u2502","--","-","\u2506","--","-","\u2502","\u2502","datetime","[","\u03bcs",",","Pacific\/Apia","]","\u2506","duration","[","ms","]","\u2502","\u255e\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2561","\u2502","2011-12-29","00:00:00","-10","\u2506","-11h","\u2502","\u2502","2012-01-01","00:00:00","+14","\u2506","13h","\u2502","\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"]
code: def base_utc_offset(self) -> Expr:
      """
      Base offset from UTC.
  
      This is usually constant for all datetimes in a given time zone, but
      may vary in the rare case that a country switches time zone, like
      Samoa (Apia) did at the end of 2011.
  
      Returns
      -------
      Expr
          Expression of data type :class:`Duration`.
  
      See Also
      --------
      Expr.dt.dst_offset : Daylight savings offset from UTC.
  
      Examples
      --------
      >>> from datetime import datetime
      >>> df = pl.DataFrame(
      ...     {
      ...         "ts": [datetime(2011, 12, 29), datetime(2012, 1, 1)],
      ...     }
      ... )
      >>> df = df.with_columns(pl.col("ts").dt.replace_time_zone("Pacific/Apia"))
      >>> df.with_columns(pl.col("ts").dt.base_utc_offset().alias("base_utc_offset"))
      shape: (2, 2)
      ┌────────────────────────────┬─────────────────┐
      │ ts                         ┆ base_utc_offset │
      │ ---                        ┆ ---             │
      │ datetime[μs, Pacific/Apia] ┆ duration[ms]    │
      ╞════════════════════════════╪═════════════════╡
      │ 2011-12-29 00:00:00 -10    ┆ -11h            │
      │ 2012-01-01 00:00:00 +14    ┆ 13h             │
      └────────────────────────────┴─────────────────┘
      """
      return wrap_expr(self._pyexpr.dt_base_utc_offset())
  
imports: from __future__ import annotations
  import datetime
  from typing import TYPE_CHECKING
  import polars._reexport
  from polars import functions
  from polars.datatypes import DTYPE_TEMPORAL_UNITS, Date, Int32
  from polars.utils._parse_expr_input import parse_as_expression
  from polars.utils._wrap import wrap_expr
  from polars.utils.convert import _timedelta_to_pl_duration
  from polars.utils.deprecation import deprecate_renamed_function, deprecate_saturating, issue_deprecation_warning, rename_use_earliest_to_ambiguous
label_desc: Use image node_id 41 for calling the ExprDateTimeNameSpace obj's underlying member method code with example usage: obj.base_utc_offset() and returns: wrap_expr