class_docstr: Namespace for datetime related expressions.
docstr: Extract microseconds from underlying DateTime representation.
  
  Applies to Datetime columns.
  
  Returns
  -------
  Expr
      Expression of data type :class:`Int32`.
  
  Examples
  --------
  >>> from datetime import datetime
  >>> df = pl.DataFrame(
  ...     {
  ...         "date": pl.datetime_range(
  ...             datetime(2020, 1, 1),
  ...             datetime(2020, 1, 1, 0, 0, 1, 0),
  ...             "1ms",
  ...             eager=True,
  ...         ),
  ...     }
  ... )
  >>> df.select(
  ...     [
  ...         pl.col("date"),
  ...         pl.col("date").dt.microsecond().alias("microsecond"),
  ...     ]
  ... )
  shape: (1_001, 2)
  ┌─────────────────────────┬─────────────┐
  │ date                    ┆ microsecond │
  │ ---                     ┆ ---         │
  │ datetime[μs]            ┆ i32         │
  ╞═════════════════════════╪═════════════╡
  │ 2020-01-01 00:00:00     ┆ 0           │
  │ 2020-01-01 00:00:00.001 ┆ 1000        │
  │ 2020-01-01 00:00:00.002 ┆ 2000        │
  │ 2020-01-01 00:00:00.003 ┆ 3000        │
  │ …                       ┆ …           │
  │ 2020-01-01 00:00:00.997 ┆ 997000      │
  │ 2020-01-01 00:00:00.998 ┆ 998000      │
  │ 2020-01-01 00:00:00.999 ┆ 999000      │
  │ 2020-01-01 00:00:01     ┆ 0           │
  └─────────────────────────┴─────────────┘
docstr_tok: ["Extract","microseconds","from","underlying","DateTime","representation",".","Applies","to","Datetime","columns",".","Returns","--","--","--","-","Expr","Expression","of","data","type",":","class",":","`","Int32","`",".","Examples","--","--","--","--",">",">",">","from","datetime","import","datetime",">",">",">","df","=","pl.DataFrame","(","...","{","...","``","date","''",":","pl.datetime_range","(","...","datetime","(","2020",",","1",",","1",")",",","...","datetime","(","2020",",","1",",","1",",","0",",","0",",","1",",","0",")",",","...","``","1ms","''",",","...","eager=True",",","...",")",",","...","}","...",")",">",">",">","df.select","(","...","[","...","pl.col","(","``","date","''",")",",","...","pl.col","(","``","date","''",")",".dt.microsecond","(",")",".alias","(","``","microsecond","''",")",",","...","]","...",")","shape",":","(","1_001",",","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\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510","\u2502","date","\u2506","microsecond","\u2502","\u2502","--","-","\u2506","--","-","\u2502","\u2502","datetime","[","\u03bcs","]","\u2506","i32","\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\u256a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2561","\u2502","2020-01-01","00:00:00","\u2506","0","\u2502","\u2502","2020-01-01","00:00:00.001","\u2506","1000","\u2502","\u2502","2020-01-01","00:00:00.002","\u2506","2000","\u2502","\u2502","2020-01-01","00:00:00.003","\u2506","3000","\u2502","\u2502","\u2026","\u2506","\u2026","\u2502","\u2502","2020-01-01","00:00:00.997","\u2506","997000","\u2502","\u2502","2020-01-01","00:00:00.998","\u2506","998000","\u2502","\u2502","2020-01-01","00:00:00.999","\u2506","999000","\u2502","\u2502","2020-01-01","00:00:01","\u2506","0","\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\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"]
code: def microsecond(self) -> Expr:
      """
      Extract microseconds from underlying DateTime representation.
  
      Applies to Datetime columns.
  
      Returns
      -------
      Expr
          Expression of data type :class:`Int32`.
  
      Examples
      --------
      >>> from datetime import datetime
      >>> df = pl.DataFrame(
      ...     {
      ...         "date": pl.datetime_range(
      ...             datetime(2020, 1, 1),
      ...             datetime(2020, 1, 1, 0, 0, 1, 0),
      ...             "1ms",
      ...             eager=True,
      ...         ),
      ...     }
      ... )
      >>> df.select(
      ...     [
      ...         pl.col("date"),
      ...         pl.col("date").dt.microsecond().alias("microsecond"),
      ...     ]
      ... )
      shape: (1_001, 2)
      ┌─────────────────────────┬─────────────┐
      │ date                    ┆ microsecond │
      │ ---                     ┆ ---         │
      │ datetime[μs]            ┆ i32         │
      ╞═════════════════════════╪═════════════╡
      │ 2020-01-01 00:00:00     ┆ 0           │
      │ 2020-01-01 00:00:00.001 ┆ 1000        │
      │ 2020-01-01 00:00:00.002 ┆ 2000        │
      │ 2020-01-01 00:00:00.003 ┆ 3000        │
      │ …                       ┆ …           │
      │ 2020-01-01 00:00:00.997 ┆ 997000      │
      │ 2020-01-01 00:00:00.998 ┆ 998000      │
      │ 2020-01-01 00:00:00.999 ┆ 999000      │
      │ 2020-01-01 00:00:01     ┆ 0           │
      └─────────────────────────┴─────────────┘
  
      """
      return wrap_expr(self._pyexpr.dt_microsecond())
  
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 23 for calling the ExprDateTimeNameSpace obj's underlying member method code with example usage: obj.microsecond() and returns: wrap_expr