This is an automated email from the ASF dual-hosted git repository.

github-bot pushed a commit to branch asf-staging
in repository https://gitbox.apache.org/repos/asf/datafusion-python.git


The following commit(s) were added to refs/heads/asf-staging by this push:
     new fb8869f4 Publish built docs triggered by 
f01f30c6332e40208e9f943a163a66e3d2781d08
fb8869f4 is described below

commit fb8869f41ab16f56c8e96f2140896c27859e2b17
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Wed Mar 18 06:14:20 2026 +0000

    Publish built docs triggered by f01f30c6332e40208e9f943a163a66e3d2781d08
---
 .../autoapi/datafusion/functions/index.rst.txt     | 168 +++++++++++++++++++++
 autoapi/datafusion/functions/index.html            | 168 +++++++++++++++++++++
 searchindex.js                                     |   2 +-
 user-guide/common-operations/aggregations.html     |  30 ++--
 user-guide/common-operations/basic-info.html       |  46 +++---
 user-guide/common-operations/functions.html        |  20 +--
 6 files changed, 385 insertions(+), 49 deletions(-)

diff --git a/_sources/autoapi/datafusion/functions/index.rst.txt 
b/_sources/autoapi/datafusion/functions/index.rst.txt
index 0b25cf15..73ef69ef 100644
--- a/_sources/autoapi/datafusion/functions/index.rst.txt
+++ b/_sources/autoapi/datafusion/functions/index.rst.txt
@@ -1213,26 +1213,89 @@ Module Contents
 
    Returns current UTC date as a Date32 value.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": [1]})
+   >>> result = df.select(
+   ...     dfn.functions.current_date().alias("d")
+   ... )
+   >>> result.collect_column("d")[0].as_py() is not None
+   True
+
 
 .. py:function:: current_time() -> datafusion.expr.Expr
 
    Returns current UTC time as a Time64 value.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": [1]})
+   >>> result = df.select(
+   ...     dfn.functions.current_time().alias("t")
+   ... )
+
+   Use .value instead of .as_py() because nanosecond timestamps
+   require pandas to convert to Python datetime objects.
+
+   >>> result.collect_column("t")[0].value > 0
+   True
+
 
 .. py:function:: date_bin(stride: datafusion.expr.Expr, source: 
datafusion.expr.Expr, origin: datafusion.expr.Expr) -> datafusion.expr.Expr
 
    Coerces an arbitrary timestamp to the start of the nearest specified 
interval.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"timestamp": ['2021-07-15 12:34:56', 
'2021-01-01']})
+   >>> result = df.select(
+   ...     dfn.functions.date_bin(
+   ...         dfn.string_literal("15 minutes"),
+   ...         dfn.col("timestamp"),
+   ...         dfn.string_literal("2001-01-01 00:00:00")
+   ...     ).alias("b")
+   ... )
+   >>> str(result.collect_column("b")[0].as_py())
+   '2021-07-15 12:30:00'
+   >>> str(result.collect_column("b")[1].as_py())
+   '2021-01-01 00:00:00'
+
 
 .. py:function:: date_part(part: datafusion.expr.Expr, date: 
datafusion.expr.Expr) -> datafusion.expr.Expr
 
    Extracts a subfield from the date.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": ["2021-07-15T00:00:00"]})
+   >>> df = df.select(dfn.functions.to_timestamp(dfn.col("a")).alias("a"))
+   >>> result = df.select(
+   ...     dfn.functions.date_part(dfn.lit("year"), dfn.col("a")).alias("y"))
+   >>> result.collect_column("y")[0].as_py()
+   2021
+
 
 .. py:function:: date_trunc(part: datafusion.expr.Expr, date: 
datafusion.expr.Expr) -> datafusion.expr.Expr
 
    Truncates the date to a specified level of precision.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": ["2021-07-15T12:34:56"]})
+   >>> df = df.select(dfn.functions.to_timestamp(dfn.col("a")).alias("a"))
+   >>> result = df.select(
+   ...     dfn.functions.date_trunc(
+   ...         dfn.lit("month"), dfn.col("a")
+   ...     ).alias("t")
+   ... )
+   >>> str(result.collect_column("t")[0].as_py())
+   '2021-07-01 00:00:00'
+
 
 .. py:function:: datepart(part: datafusion.expr.Expr, date: 
datafusion.expr.Expr) -> datafusion.expr.Expr
 
@@ -1430,6 +1493,18 @@ Module Contents
 
    Converts an integer to RFC3339 timestamp format string.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": [0]})
+   >>> result = df.select(
+   ...     dfn.functions.from_unixtime(
+   ...         dfn.col("a")
+   ...     ).alias("ts")
+   ... )
+   >>> str(result.collect_column("ts")[0].as_py())
+   '1970-01-01 00:00:00'
+
 
 .. py:function:: gcd(x: datafusion.expr.Expr, y: datafusion.expr.Expr) -> 
datafusion.expr.Expr
 
@@ -1914,6 +1989,17 @@ Module Contents
 
    Make a date from year, month and day component parts.
 
+   .. rubric:: Examples
+
+   >>> from datetime import date
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"y": [2024], "m": [1], "d": [15]})
+   >>> result = df.select(
+   ...     dfn.functions.make_date(dfn.col("y"), dfn.col("m"),
+   ...     dfn.col("d")).alias("dt"))
+   >>> result.collect_column("dt")[0].as_py()
+   datetime.date(2024, 1, 15)
+
 
 .. py:function:: make_list(*args: datafusion.expr.Expr) -> datafusion.expr.Expr
 
@@ -2050,6 +2136,20 @@ Module Contents
 
    This will use the same value for all instances of now() in same statement.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": [1]})
+   >>> result = df.select(
+   ...     dfn.functions.now().alias("now")
+   ... )
+
+   Use .value instead of .as_py() because nanosecond timestamps
+   require pandas to convert to Python datetime objects.
+
+   >>> result.collect_column("now")[0].value > 0
+   True
+
 
 .. py:function:: nth_value(expression: datafusion.expr.Expr, n: int, filter: 
datafusion.expr.Expr | None = None, order_by: list[datafusion.expr.SortKey] | 
datafusion.expr.SortKey | None = None, null_treatment: 
datafusion.common.NullTreatment = NullTreatment.RESPECT_NULLS) -> 
datafusion.expr.Expr
 
@@ -2944,6 +3044,18 @@ Module Contents
 
    [Documentation 
here.](https://docs.rs/chrono/latest/chrono/format/strftime/index.html)
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": ["2021-01-01T00:00:00"]})
+   >>> result = df.select(
+   ...     dfn.functions.to_timestamp(
+   ...         dfn.col("a")
+   ...     ).alias("ts")
+   ... )
+   >>> str(result.collect_column("ts")[0].as_py())
+   '2021-01-01 00:00:00'
+
 
 .. py:function:: to_timestamp_micros(arg: datafusion.expr.Expr, *formatters: 
datafusion.expr.Expr) -> datafusion.expr.Expr
 
@@ -2951,6 +3063,18 @@ Module Contents
 
    See :py:func:`to_timestamp` for a description on how to use formatters.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": ["2021-01-01T00:00:00"]})
+   >>> result = df.select(
+   ...     dfn.functions.to_timestamp_micros(
+   ...         dfn.col("a")
+   ...     ).alias("ts")
+   ... )
+   >>> str(result.collect_column("ts")[0].as_py())
+   '2021-01-01 00:00:00'
+
 
 .. py:function:: to_timestamp_millis(arg: datafusion.expr.Expr, *formatters: 
datafusion.expr.Expr) -> datafusion.expr.Expr
 
@@ -2958,6 +3082,18 @@ Module Contents
 
    See :py:func:`to_timestamp` for a description on how to use formatters.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": ["2021-01-01T00:00:00"]})
+   >>> result = df.select(
+   ...     dfn.functions.to_timestamp_millis(
+   ...         dfn.col("a")
+   ...     ).alias("ts")
+   ... )
+   >>> str(result.collect_column("ts")[0].as_py())
+   '2021-01-01 00:00:00'
+
 
 .. py:function:: to_timestamp_nanos(arg: datafusion.expr.Expr, *formatters: 
datafusion.expr.Expr) -> datafusion.expr.Expr
 
@@ -2965,6 +3101,18 @@ Module Contents
 
    See :py:func:`to_timestamp` for a description on how to use formatters.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": ["2021-01-01T00:00:00"]})
+   >>> result = df.select(
+   ...     dfn.functions.to_timestamp_nanos(
+   ...         dfn.col("a")
+   ...     ).alias("ts")
+   ... )
+   >>> str(result.collect_column("ts")[0].as_py())
+   '2021-01-01 00:00:00'
+
 
 .. py:function:: to_timestamp_seconds(arg: datafusion.expr.Expr, *formatters: 
datafusion.expr.Expr) -> datafusion.expr.Expr
 
@@ -2972,11 +3120,31 @@ Module Contents
 
    See :py:func:`to_timestamp` for a description on how to use formatters.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": ["2021-01-01T00:00:00"]})
+   >>> result = df.select(
+   ...     dfn.functions.to_timestamp_seconds(
+   ...         dfn.col("a")
+   ...     ).alias("ts")
+   ... )
+   >>> str(result.collect_column("ts")[0].as_py())
+   '2021-01-01 00:00:00'
+
 
 .. py:function:: to_unixtime(string: datafusion.expr.Expr, *format_arguments: 
datafusion.expr.Expr) -> datafusion.expr.Expr
 
    Converts a string and optional formats to a Unixtime.
 
+   .. rubric:: Examples
+
+   >>> ctx = dfn.SessionContext()
+   >>> df = ctx.from_pydict({"a": ["1970-01-01T00:00:00"]})
+   >>> result = df.select(dfn.functions.to_unixtime(dfn.col("a")).alias("u"))
+   >>> result.collect_column("u")[0].as_py()
+   0
+
 
 .. py:function:: translate(string: datafusion.expr.Expr, from_val: 
datafusion.expr.Expr, to_val: datafusion.expr.Expr) -> datafusion.expr.Expr
 
diff --git a/autoapi/datafusion/functions/index.html 
b/autoapi/datafusion/functions/index.html
index 14bae86d..de7a15a8 100644
--- a/autoapi/datafusion/functions/index.html
+++ b/autoapi/datafusion/functions/index.html
@@ -4530,30 +4530,93 @@ column names or expressions.</p></li>
 <dt class="sig sig-object py" id="datafusion.functions.current_date">
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">current_date</span></span><span 
class="sig-paren">(</span><span class="sig-paren">)</span> <span 
class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span 
class="sig-return-typehint"><a class="reference internal" 
href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pre">datafusion.expr.Expr</span></ 
[...]
 <dd><p>Returns current UTC date as a Date32 value.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="mi">1</span><span class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">current_date</span><span class="p">()</span><span 
class="o">.</span><span class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;d&quot;</span><span class="p">)</span>
+<span class="gp">... </span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span><span 
class="o">.</span><span class="n">collect_column</span><span 
class="p">(</span><span class="s2">&quot;d&quot;</span><span 
class="p">)[</span><span class="mi">0</span><span class="p">]</span><span 
class="o">.</span><span class="n">as_py</span><span class="p">()</span> <span 
class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+<span class="go">True</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
 <dt class="sig sig-object py" id="datafusion.functions.current_time">
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">current_time</span></span><span 
class="sig-paren">(</span><span class="sig-paren">)</span> <span 
class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span 
class="sig-return-typehint"><a class="reference internal" 
href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pre">datafusion.expr.Expr</span></ 
[...]
 <dd><p>Returns current UTC time as a Time64 value.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="mi">1</span><span class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">current_time</span><span class="p">()</span><span 
class="o">.</span><span class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;t&quot;</span><span class="p">)</span>
+<span class="gp">... </span><span class="p">)</span>
+</pre></div>
+</div>
+<p>Use .value instead of .as_py() because nanosecond timestamps
+require pandas to convert to Python datetime objects.</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">result</span><span class="o">.</span><span 
class="n">collect_column</span><span class="p">(</span><span 
class="s2">&quot;t&quot;</span><span class="p">)[</span><span 
class="mi">0</span><span class="p">]</span><span class="o">.</span><span 
class="n">value</span> <span class="o">&gt;</span> <span class="mi">0</span>
+<span class="go">True</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
 <dt class="sig sig-object py" id="datafusion.functions.date_bin">
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">date_bin</span></span><span 
class="sig-paren">(</span><em class="sig-param"><span class="n"><span 
class="pre">stride</span></span><span class="p"><span 
class="pre">:</span></span><span class="w"> </span><span class="n"><a 
class="reference internal" href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pre">datafu [...]
 <dd><p>Coerces an arbitrary timestamp to the start of the nearest specified 
interval.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;timestamp&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="s1">&#39;2021-07-15 12:34:56&#39;</span><span 
class="p">,</span> <span class="s1">&#39;2021-01-01&#39;</span><span 
class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">date_bin</span><span class="p">(</span>
+<span class="gp">... </span>        <span class="n">dfn</span><span 
class="o">.</span><span class="n">string_literal</span><span 
class="p">(</span><span class="s2">&quot;15 minutes&quot;</span><span 
class="p">),</span>
+<span class="gp">... </span>        <span class="n">dfn</span><span 
class="o">.</span><span class="n">col</span><span class="p">(</span><span 
class="s2">&quot;timestamp&quot;</span><span class="p">),</span>
+<span class="gp">... </span>        <span class="n">dfn</span><span 
class="o">.</span><span class="n">string_literal</span><span 
class="p">(</span><span class="s2">&quot;2001-01-01 00:00:00&quot;</span><span 
class="p">)</span>
+<span class="gp">... </span>    <span class="p">)</span><span 
class="o">.</span><span class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;b&quot;</span><span class="p">)</span>
+<span class="gp">... </span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="nb">str</span><span 
class="p">(</span><span class="n">result</span><span class="o">.</span><span 
class="n">collect_column</span><span class="p">(</span><span 
class="s2">&quot;b&quot;</span><span class="p">)[</span><span 
class="mi">0</span><span class="p">]</span><span class="o">.</span><span 
class="n">as_py</span><span class="p">())</span>
+<span class="go">&#39;2021-07-15 12:30:00&#39;</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="nb">str</span><span 
class="p">(</span><span class="n">result</span><span class="o">.</span><span 
class="n">collect_column</span><span class="p">(</span><span 
class="s2">&quot;b&quot;</span><span class="p">)[</span><span 
class="mi">1</span><span class="p">]</span><span class="o">.</span><span 
class="n">as_py</span><span class="p">())</span>
+<span class="go">&#39;2021-01-01 00:00:00&#39;</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
 <dt class="sig sig-object py" id="datafusion.functions.date_part">
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">date_part</span></span><span 
class="sig-paren">(</span><em class="sig-param"><span class="n"><span 
class="pre">part</span></span><span class="p"><span 
class="pre">:</span></span><span class="w"> </span><span class="n"><a 
class="reference internal" href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pre">datafus [...]
 <dd><p>Extracts a subfield from the date.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="s2">&quot;2021-07-15T00:00:00&quot;</span><span 
class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span><span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">to_timestamp</span><span class="p">(</span><span 
class="n">dfn</span><span class="o">.</span><span class="n">col</span><span 
class="p">(</span><span class="s2">&quot;a&quot;</span> [...]
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">date_part</span><span class="p">(</span><span 
class="n">dfn</span><span class="o">.</span><span class="n">lit</span><span 
class="p">(</span><span class="s2">&quot;year&quot;</span><span 
class="p">),</span> <span class="n">dfn</span><span class="o">.</span><span 
class="n">col</span><span class="p">(</span><span class="s2">&quot;a&quot;</ 
[...]
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span><span 
class="o">.</span><span class="n">collect_column</span><span 
class="p">(</span><span class="s2">&quot;y&quot;</span><span 
class="p">)[</span><span class="mi">0</span><span class="p">]</span><span 
class="o">.</span><span class="n">as_py</span><span class="p">()</span>
+<span class="go">2021</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
 <dt class="sig sig-object py" id="datafusion.functions.date_trunc">
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">date_trunc</span></span><span 
class="sig-paren">(</span><em class="sig-param"><span class="n"><span 
class="pre">part</span></span><span class="p"><span 
class="pre">:</span></span><span class="w"> </span><span class="n"><a 
class="reference internal" href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pre">datafu [...]
 <dd><p>Truncates the date to a specified level of precision.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="s2">&quot;2021-07-15T12:34:56&quot;</span><span 
class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span><span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">to_timestamp</span><span class="p">(</span><span 
class="n">dfn</span><span class="o">.</span><span class="n">col</span><span 
class="p">(</span><span class="s2">&quot;a&quot;</span> [...]
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">date_trunc</span><span class="p">(</span>
+<span class="gp">... </span>        <span class="n">dfn</span><span 
class="o">.</span><span class="n">lit</span><span class="p">(</span><span 
class="s2">&quot;month&quot;</span><span class="p">),</span> <span 
class="n">dfn</span><span class="o">.</span><span class="n">col</span><span 
class="p">(</span><span class="s2">&quot;a&quot;</span><span class="p">)</span>
+<span class="gp">... </span>    <span class="p">)</span><span 
class="o">.</span><span class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;t&quot;</span><span class="p">)</span>
+<span class="gp">... </span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="nb">str</span><span 
class="p">(</span><span class="n">result</span><span class="o">.</span><span 
class="n">collect_column</span><span class="p">(</span><span 
class="s2">&quot;t&quot;</span><span class="p">)[</span><span 
class="mi">0</span><span class="p">]</span><span class="o">.</span><span 
class="n">as_py</span><span class="p">())</span>
+<span class="go">&#39;2021-07-01 00:00:00&#39;</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
@@ -4770,6 +4833,18 @@ column names or expressions.</p></li>
 <dt class="sig sig-object py" id="datafusion.functions.from_unixtime">
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">from_unixtime</span></span><span 
class="sig-paren">(</span><em class="sig-param"><span class="n"><span 
class="pre">arg</span></span><span class="p"><span 
class="pre">:</span></span><span class="w"> </span><span class="n"><a 
class="reference internal" href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pre">data [...]
 <dd><p>Converts an integer to RFC3339 timestamp format string.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="mi">0</span><span class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">from_unixtime</span><span class="p">(</span>
+<span class="gp">... </span>        <span class="n">dfn</span><span 
class="o">.</span><span class="n">col</span><span class="p">(</span><span 
class="s2">&quot;a&quot;</span><span class="p">)</span>
+<span class="gp">... </span>    <span class="p">)</span><span 
class="o">.</span><span class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)</span>
+<span class="gp">... </span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="nb">str</span><span 
class="p">(</span><span class="n">result</span><span class="o">.</span><span 
class="n">collect_column</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)[</span><span 
class="mi">0</span><span class="p">]</span><span class="o">.</span><span 
class="n">as_py</span><span class="p">())</span>
+<span class="go">&#39;1970-01-01 00:00:00&#39;</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
@@ -5287,6 +5362,17 @@ truncated (on the right).</p>
 <dt class="sig sig-object py" id="datafusion.functions.make_date">
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">make_date</span></span><span 
class="sig-paren">(</span><em class="sig-param"><span class="n"><span 
class="pre">year</span></span><span class="p"><span 
class="pre">:</span></span><span class="w"> </span><span class="n"><a 
class="reference internal" href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pre">datafus [...]
 <dd><p>Make a date from year, month and day component parts.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="kn">from</span><span class="w"> </span><span 
class="nn">datetime</span><span class="w"> </span><span 
class="kn">import</span> <span class="n">date</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">ctx</span> <span 
class="o">=</span> <span class="n">dfn</span><span class="o">.</span><span 
class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;y&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="mi">2024</span><span class="p">],</span> <span 
class="s2">&quot;m&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="mi">1</span><span class="p">],</span> <span 
class="s2">& [...]
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">make_date</span><span class="p">(</span><span 
class="n">dfn</span><span class="o">.</span><span class="n">col</span><span 
class="p">(</span><span class="s2">&quot;y&quot;</span><span 
class="p">),</span> <span class="n">dfn</span><span class="o">.</span><span 
class="n">col</span><span class="p">(</span><span class="s2">&quot;m&quot;</spa 
[...]
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">col</span><span class="p">(</span><span 
class="s2">&quot;d&quot;</span><span class="p">))</span><span 
class="o">.</span><span class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;dt&quot;</span><span class="p">))</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span><span 
class="o">.</span><span class="n">collect_column</span><span 
class="p">(</span><span class="s2">&quot;dt&quot;</span><span 
class="p">)[</span><span class="mi">0</span><span class="p">]</span><span 
class="o">.</span><span class="n">as_py</span><span class="p">()</span>
+<span class="go">datetime.date(2024, 1, 15)</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
@@ -5448,6 +5534,20 @@ the options <code class="docutils literal 
notranslate"><span class="pre">order_b
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">now</span></span><span 
class="sig-paren">(</span><span class="sig-paren">)</span> <span 
class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span 
class="sig-return-typehint"><a class="reference internal" 
href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span 
class="pre">datafusion.expr.Expr</span></a></span> [...]
 <dd><p>Returns the current timestamp in nanoseconds.</p>
 <p>This will use the same value for all instances of now() in same 
statement.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="mi">1</span><span class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">now</span><span class="p">()</span><span class="o">.</span><span 
class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;now&quot;</span><span class="p">)</span>
+<span class="gp">... </span><span class="p">)</span>
+</pre></div>
+</div>
+<p>Use .value instead of .as_py() because nanosecond timestamps
+require pandas to convert to Python datetime objects.</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">result</span><span class="o">.</span><span 
class="n">collect_column</span><span class="p">(</span><span 
class="s2">&quot;now&quot;</span><span class="p">)[</span><span 
class="mi">0</span><span class="p">]</span><span class="o">.</span><span 
class="n">value</span> <span class="o">&gt;</span> <span class="mi">0</span>
+<span class="go">True</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
@@ -6454,6 +6554,18 @@ HH:MM:SS.nnnnnnnnn;</p>
 <dd><p>Converts a string and optional formats to a <code class="docutils 
literal notranslate"><span class="pre">Timestamp</span></code> in 
nanoseconds.</p>
 <p>For usage of <code class="docutils literal notranslate"><span 
class="pre">formatters</span></code> see the rust chrono package <code 
class="docutils literal notranslate"><span class="pre">strftime</span></code> 
package.</p>
 <p>[Documentation here.](<a class="reference external" 
href="https://docs.rs/chrono/latest/chrono/format/strftime/index.html";>https://docs.rs/chrono/latest/chrono/format/strftime/index.html</a>)</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="s2">&quot;2021-01-01T00:00:00&quot;</span><span 
class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">to_timestamp</span><span class="p">(</span>
+<span class="gp">... </span>        <span class="n">dfn</span><span 
class="o">.</span><span class="n">col</span><span class="p">(</span><span 
class="s2">&quot;a&quot;</span><span class="p">)</span>
+<span class="gp">... </span>    <span class="p">)</span><span 
class="o">.</span><span class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)</span>
+<span class="gp">... </span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="nb">str</span><span 
class="p">(</span><span class="n">result</span><span class="o">.</span><span 
class="n">collect_column</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)[</span><span 
class="mi">0</span><span class="p">]</span><span class="o">.</span><span 
class="n">as_py</span><span class="p">())</span>
+<span class="go">&#39;2021-01-01 00:00:00&#39;</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
@@ -6461,6 +6573,18 @@ HH:MM:SS.nnnnnnnnn;</p>
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">to_timestamp_micros</span></span><span 
class="sig-paren">(</span><em class="sig-param"><span class="n"><span 
class="pre">arg</span></span><span class="p"><span 
class="pre">:</span></span><span class="w"> </span><span class="n"><a 
class="reference internal" href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pre [...]
 <dd><p>Converts a string and optional formats to a <code class="docutils 
literal notranslate"><span class="pre">Timestamp</span></code> in 
microseconds.</p>
 <p>See <a class="reference internal" href="#datafusion.functions.to_timestamp" 
title="datafusion.functions.to_timestamp"><code class="xref py py-func docutils 
literal notranslate"><span class="pre">to_timestamp()</span></code></a> for a 
description on how to use formatters.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="s2">&quot;2021-01-01T00:00:00&quot;</span><span 
class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">to_timestamp_micros</span><span class="p">(</span>
+<span class="gp">... </span>        <span class="n">dfn</span><span 
class="o">.</span><span class="n">col</span><span class="p">(</span><span 
class="s2">&quot;a&quot;</span><span class="p">)</span>
+<span class="gp">... </span>    <span class="p">)</span><span 
class="o">.</span><span class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)</span>
+<span class="gp">... </span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="nb">str</span><span 
class="p">(</span><span class="n">result</span><span class="o">.</span><span 
class="n">collect_column</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)[</span><span 
class="mi">0</span><span class="p">]</span><span class="o">.</span><span 
class="n">as_py</span><span class="p">())</span>
+<span class="go">&#39;2021-01-01 00:00:00&#39;</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
@@ -6468,6 +6592,18 @@ HH:MM:SS.nnnnnnnnn;</p>
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">to_timestamp_millis</span></span><span 
class="sig-paren">(</span><em class="sig-param"><span class="n"><span 
class="pre">arg</span></span><span class="p"><span 
class="pre">:</span></span><span class="w"> </span><span class="n"><a 
class="reference internal" href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pre [...]
 <dd><p>Converts a string and optional formats to a <code class="docutils 
literal notranslate"><span class="pre">Timestamp</span></code> in 
milliseconds.</p>
 <p>See <a class="reference internal" href="#datafusion.functions.to_timestamp" 
title="datafusion.functions.to_timestamp"><code class="xref py py-func docutils 
literal notranslate"><span class="pre">to_timestamp()</span></code></a> for a 
description on how to use formatters.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="s2">&quot;2021-01-01T00:00:00&quot;</span><span 
class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">to_timestamp_millis</span><span class="p">(</span>
+<span class="gp">... </span>        <span class="n">dfn</span><span 
class="o">.</span><span class="n">col</span><span class="p">(</span><span 
class="s2">&quot;a&quot;</span><span class="p">)</span>
+<span class="gp">... </span>    <span class="p">)</span><span 
class="o">.</span><span class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)</span>
+<span class="gp">... </span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="nb">str</span><span 
class="p">(</span><span class="n">result</span><span class="o">.</span><span 
class="n">collect_column</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)[</span><span 
class="mi">0</span><span class="p">]</span><span class="o">.</span><span 
class="n">as_py</span><span class="p">())</span>
+<span class="go">&#39;2021-01-01 00:00:00&#39;</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
@@ -6475,6 +6611,18 @@ HH:MM:SS.nnnnnnnnn;</p>
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">to_timestamp_nanos</span></span><span 
class="sig-paren">(</span><em class="sig-param"><span class="n"><span 
class="pre">arg</span></span><span class="p"><span 
class="pre">:</span></span><span class="w"> </span><span class="n"><a 
class="reference internal" href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pre" [...]
 <dd><p>Converts a string and optional formats to a <code class="docutils 
literal notranslate"><span class="pre">Timestamp</span></code> in 
nanoseconds.</p>
 <p>See <a class="reference internal" href="#datafusion.functions.to_timestamp" 
title="datafusion.functions.to_timestamp"><code class="xref py py-func docutils 
literal notranslate"><span class="pre">to_timestamp()</span></code></a> for a 
description on how to use formatters.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="s2">&quot;2021-01-01T00:00:00&quot;</span><span 
class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">to_timestamp_nanos</span><span class="p">(</span>
+<span class="gp">... </span>        <span class="n">dfn</span><span 
class="o">.</span><span class="n">col</span><span class="p">(</span><span 
class="s2">&quot;a&quot;</span><span class="p">)</span>
+<span class="gp">... </span>    <span class="p">)</span><span 
class="o">.</span><span class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)</span>
+<span class="gp">... </span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="nb">str</span><span 
class="p">(</span><span class="n">result</span><span class="o">.</span><span 
class="n">collect_column</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)[</span><span 
class="mi">0</span><span class="p">]</span><span class="o">.</span><span 
class="n">as_py</span><span class="p">())</span>
+<span class="go">&#39;2021-01-01 00:00:00&#39;</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
@@ -6482,12 +6630,32 @@ HH:MM:SS.nnnnnnnnn;</p>
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">to_timestamp_seconds</span></span><span 
class="sig-paren">(</span><em class="sig-param"><span class="n"><span 
class="pre">arg</span></span><span class="p"><span 
class="pre">:</span></span><span class="w"> </span><span class="n"><a 
class="reference internal" href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pr [...]
 <dd><p>Converts a string and optional formats to a <code class="docutils 
literal notranslate"><span class="pre">Timestamp</span></code> in seconds.</p>
 <p>See <a class="reference internal" href="#datafusion.functions.to_timestamp" 
title="datafusion.functions.to_timestamp"><code class="xref py py-func docutils 
literal notranslate"><span class="pre">to_timestamp()</span></code></a> for a 
description on how to use formatters.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="s2">&quot;2021-01-01T00:00:00&quot;</span><span 
class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span>
+<span class="gp">... </span>    <span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">to_timestamp_seconds</span><span class="p">(</span>
+<span class="gp">... </span>        <span class="n">dfn</span><span 
class="o">.</span><span class="n">col</span><span class="p">(</span><span 
class="s2">&quot;a&quot;</span><span class="p">)</span>
+<span class="gp">... </span>    <span class="p">)</span><span 
class="o">.</span><span class="n">alias</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)</span>
+<span class="gp">... </span><span class="p">)</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="nb">str</span><span 
class="p">(</span><span class="n">result</span><span class="o">.</span><span 
class="n">collect_column</span><span class="p">(</span><span 
class="s2">&quot;ts&quot;</span><span class="p">)[</span><span 
class="mi">0</span><span class="p">]</span><span class="o">.</span><span 
class="n">as_py</span><span class="p">())</span>
+<span class="go">&#39;2021-01-01 00:00:00&#39;</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
 <dt class="sig sig-object py" id="datafusion.functions.to_unixtime">
 <span class="sig-prename descclassname"><span 
class="pre">datafusion.functions.</span></span><span class="sig-name 
descname"><span class="pre">to_unixtime</span></span><span 
class="sig-paren">(</span><em class="sig-param"><span class="n"><span 
class="pre">string</span></span><span class="p"><span 
class="pre">:</span></span><span class="w"> </span><span class="n"><a 
class="reference internal" href="../expr/index.html#datafusion.expr.Expr" 
title="datafusion.expr.Expr"><span class="pre">dat [...]
 <dd><p>Converts a string and optional formats to a Unixtime.</p>
+<p class="rubric">Examples</p>
+<div class="doctest highlight-default notranslate"><div 
class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span 
class="n">ctx</span> <span class="o">=</span> <span class="n">dfn</span><span 
class="o">.</span><span class="n">SessionContext</span><span class="p">()</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">df</span> <span 
class="o">=</span> <span class="n">ctx</span><span class="o">.</span><span 
class="n">from_pydict</span><span class="p">({</span><span 
class="s2">&quot;a&quot;</span><span class="p">:</span> <span 
class="p">[</span><span class="s2">&quot;1970-01-01T00:00:00&quot;</span><span 
class="p">]})</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span> <span 
class="o">=</span> <span class="n">df</span><span class="o">.</span><span 
class="n">select</span><span class="p">(</span><span class="n">dfn</span><span 
class="o">.</span><span class="n">functions</span><span class="o">.</span><span 
class="n">to_unixtime</span><span class="p">(</span><span 
class="n">dfn</span><span class="o">.</span><span class="n">col</span><span 
class="p">(</span><span class="s2">&quot;a&quot;</sp [...]
+<span class="gp">&gt;&gt;&gt; </span><span class="n">result</span><span 
class="o">.</span><span class="n">collect_column</span><span 
class="p">(</span><span class="s2">&quot;u&quot;</span><span 
class="p">)[</span><span class="mi">0</span><span class="p">]</span><span 
class="o">.</span><span class="n">as_py</span><span class="p">()</span>
+<span class="go">0</span>
+</pre></div>
+</div>
 </dd></dl>
 
 <dl class="py function">
diff --git a/searchindex.js b/searchindex.js
index 98e1906b..6371e196 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles": {"API Reference": [[19, null]], "Additional 
Resources": [[37, "additional-resources"]], "Aggregate Functions": [[24, 
"aggregate-functions"], [31, "aggregate-functions"], [33, 
"aggregate-functions"]], "Aggregation": [[24, null]], "Alternative Approach": 
[[20, "alternative-approach"]], "Apache Iceberg": [[35, "apache-iceberg"]], 
"Arrays": [[26, "arrays"]], "Arrow": [[39, null]], "Attributes": [[4, 
"attributes"], [5, "attributes"], [7, "attributes"], [12, "attr [...]
\ No newline at end of file
+Search.setIndex({"alltitles": {"API Reference": [[19, null]], "Additional 
Resources": [[37, "additional-resources"]], "Aggregate Functions": [[24, 
"aggregate-functions"], [31, "aggregate-functions"], [33, 
"aggregate-functions"]], "Aggregation": [[24, null]], "Alternative Approach": 
[[20, "alternative-approach"]], "Apache Iceberg": [[35, "apache-iceberg"]], 
"Arrays": [[26, "arrays"]], "Arrow": [[39, null]], "Attributes": [[4, 
"attributes"], [5, "attributes"], [7, "attributes"], [12, "attr [...]
\ No newline at end of file
diff --git a/user-guide/common-operations/aggregations.html 
b/user-guide/common-operations/aggregations.html
index 78e30ac3..a32867b0 100644
--- a/user-guide/common-operations/aggregations.html
+++ b/user-guide/common-operations/aggregations.html
@@ -620,15 +620,15 @@ Pokemon set. Since there will be many entries of <code 
class="docutils literal n
 <span 
class="o">+----------+--------------------------------------------------+</span>
 <span class="o">|</span> <span class="n">Type</span> <span class="mi">1</span> 
  <span class="o">|</span> <span class="n">Type</span> <span 
class="mi">2</span> <span class="n">List</span>                                 
     <span class="o">|</span>
 <span 
class="o">+----------+--------------------------------------------------+</span>
-<span class="o">|</span> <span class="n">Bug</span>      <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Grass</span><span class="p">,</span> <span 
class="n">Poison</span><span class="p">,</span> <span class="p">]</span>        
                <span class="o">|</span>
-<span class="o">|</span> <span class="n">Poison</span>   <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="p">,</span> <span class="n">Ground</span><span 
class="p">]</span>                               <span class="o">|</span>
-<span class="o">|</span> <span class="n">Electric</span> <span 
class="o">|</span> <span class="p">[</span><span class="n">Steel</span><span 
class="p">,</span> <span class="n">Flying</span><span class="p">,</span> <span 
class="p">]</span>                                <span class="o">|</span>
+<span class="o">|</span> <span class="n">Bug</span>      <span 
class="o">|</span> <span class="p">[</span><span class="n">Grass</span><span 
class="p">,</span> <span class="n">Poison</span><span class="p">,</span> <span 
class="p">,</span> <span class="n">Flying</span><span class="p">]</span>        
                <span class="o">|</span>
+<span class="o">|</span> <span class="n">Poison</span>   <span 
class="o">|</span> <span class="p">[</span><span class="n">Ground</span><span 
class="p">,</span> <span class="n">Flying</span><span class="p">,</span> <span 
class="p">]</span>                               <span class="o">|</span>
+<span class="o">|</span> <span class="n">Electric</span> <span 
class="o">|</span> <span class="p">[,</span> <span class="n">Flying</span><span 
class="p">,</span> <span class="n">Steel</span><span class="p">]</span>         
                       <span class="o">|</span>
 <span class="o">|</span> <span class="n">Fairy</span>    <span 
class="o">|</span> <span class="p">[]</span>                                    
           <span class="o">|</span>
-<span class="o">|</span> <span class="n">Normal</span>   <span 
class="o">|</span> <span class="p">[</span><span class="n">Fairy</span><span 
class="p">,</span> <span class="p">,</span> <span class="n">Flying</span><span 
class="p">]</span>                                <span class="o">|</span>
+<span class="o">|</span> <span class="n">Normal</span>   <span 
class="o">|</span> <span class="p">[</span><span class="n">Fairy</span><span 
class="p">,</span> <span class="n">Flying</span><span class="p">,</span> <span 
class="p">]</span>                                <span class="o">|</span>
 <span class="o">|</span> <span class="n">Ice</span>      <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Psychic</span><span class="p">]</span>       
                         <span class="o">|</span>
-<span class="o">|</span> <span class="n">Grass</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Psychic</span><span 
class="p">,</span> <span class="p">,</span> <span class="n">Poison</span><span 
class="p">]</span>                              <span class="o">|</span>
+<span class="o">|</span> <span class="n">Grass</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Poison</span><span 
class="p">,</span> <span class="n">Psychic</span><span class="p">,</span> <span 
class="p">]</span>                              <span class="o">|</span>
 <span class="o">|</span> <span class="n">Fire</span>     <span 
class="o">|</span> <span class="p">[,</span> <span class="n">Dragon</span><span 
class="p">,</span> <span class="n">Flying</span><span class="p">]</span>        
                       <span class="o">|</span>
-<span class="o">|</span> <span class="n">Water</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Fighting</span><span 
class="p">,</span> <span class="n">Ice</span><span class="p">,</span> <span 
class="p">,</span> <span class="n">Dark</span><span class="p">,</span> <span 
class="n">Flying</span><span class="p">,</span> <span 
class="n">Psychic</span><span class="p">,</span> <span 
class="n">Poison</span><span class="p">]</span> <span class="o">|</span>
+<span class="o">|</span> <span class="n">Water</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Psychic</span><span 
class="p">,</span> <span class="n">Ice</span><span class="p">,</span> <span 
class="n">Fighting</span><span class="p">,</span> <span 
class="n">Poison</span><span class="p">,</span> <span class="p">,</span> <span 
class="n">Dark</span><span class="p">,</span> <span 
class="n">Flying</span><span class="p">]</span> <span class="o">|</span>
 <span class="o">|</span> <span class="n">Ground</span>   <span 
class="o">|</span> <span class="p">[,</span> <span class="n">Rock</span><span 
class="p">]</span>                                         <span 
class="o">|</span>
 <span 
class="o">+----------+--------------------------------------------------+</span>
 <span class="n">Data</span> <span class="n">truncated</span><span 
class="o">.</span>
@@ -644,14 +644,14 @@ entries entirely removed. The second is we can use the 
<code class="docutils lit
 <span 
class="o">+----------+------------------------------------------------+</span>
 <span class="o">|</span> <span class="n">Type</span> <span class="mi">1</span> 
  <span class="o">|</span> <span class="n">Type</span> <span 
class="mi">2</span> <span class="n">List</span>                                 
   <span class="o">|</span>
 <span 
class="o">+----------+------------------------------------------------+</span>
-<span class="o">|</span> <span class="n">Bug</span>      <span 
class="o">|</span> <span class="p">[</span><span class="n">Poison</span><span 
class="p">,</span> <span class="n">Grass</span><span class="p">,</span> <span 
class="n">Flying</span><span class="p">]</span>                        <span 
class="o">|</span>
-<span class="o">|</span> <span class="n">Poison</span>   <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Ground</span><span class="p">]</span>        
                       <span class="o">|</span>
+<span class="o">|</span> <span class="n">Bug</span>      <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Grass</span><span class="p">,</span> <span 
class="n">Poison</span><span class="p">]</span>                        <span 
class="o">|</span>
+<span class="o">|</span> <span class="n">Poison</span>   <span 
class="o">|</span> <span class="p">[</span><span class="n">Ground</span><span 
class="p">,</span> <span class="n">Flying</span><span class="p">]</span>        
                       <span class="o">|</span>
 <span class="o">|</span> <span class="n">Electric</span> <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Steel</span><span class="p">]</span>         
                       <span class="o">|</span>
-<span class="o">|</span> <span class="n">Normal</span>   <span 
class="o">|</span> <span class="p">[</span><span class="n">Fairy</span><span 
class="p">,</span> <span class="n">Flying</span><span class="p">]</span>        
                        <span class="o">|</span>
-<span class="o">|</span> <span class="n">Ice</span>      <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Psychic</span><span class="p">]</span>       
                       <span class="o">|</span>
-<span class="o">|</span> <span class="n">Grass</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Psychic</span><span 
class="p">,</span> <span class="n">Poison</span><span class="p">]</span>        
                      <span class="o">|</span>
-<span class="o">|</span> <span class="n">Fire</span>     <span 
class="o">|</span> <span class="p">[</span><span class="n">Dragon</span><span 
class="p">,</span> <span class="n">Flying</span><span class="p">]</span>        
                       <span class="o">|</span>
-<span class="o">|</span> <span class="n">Water</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Fighting</span><span 
class="p">,</span> <span class="n">Ice</span><span class="p">,</span> <span 
class="n">Flying</span><span class="p">,</span> <span 
class="n">Dark</span><span class="p">,</span> <span 
class="n">Poison</span><span class="p">,</span> <span 
class="n">Psychic</span><span class="p">]</span> <span class="o">|</span>
+<span class="o">|</span> <span class="n">Normal</span>   <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Fairy</span><span class="p">]</span>         
                       <span class="o">|</span>
+<span class="o">|</span> <span class="n">Ice</span>      <span 
class="o">|</span> <span class="p">[</span><span class="n">Psychic</span><span 
class="p">,</span> <span class="n">Flying</span><span class="p">]</span>        
                      <span class="o">|</span>
+<span class="o">|</span> <span class="n">Grass</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Poison</span><span 
class="p">,</span> <span class="n">Psychic</span><span class="p">]</span>       
                       <span class="o">|</span>
+<span class="o">|</span> <span class="n">Fire</span>     <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Dragon</span><span class="p">]</span>        
                       <span class="o">|</span>
+<span class="o">|</span> <span class="n">Water</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Psychic</span><span class="p">,</span> <span 
class="n">Dark</span><span class="p">,</span> <span class="n">Ice</span><span 
class="p">,</span> <span class="n">Poison</span><span class="p">,</span> <span 
class="n">Fighting</span><span class="p">]</span> <span class="o">|</span>
 <span class="o">|</span> <span class="n">Rock</span>     <span 
class="o">|</span> <span class="p">[</span><span class="n">Water</span><span 
class="p">,</span> <span class="n">Ground</span><span class="p">,</span> <span 
class="n">Flying</span><span class="p">]</span>                        <span 
class="o">|</span>
 <span class="o">|</span> <span class="n">Ghost</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Poison</span><span 
class="p">]</span>                                       <span 
class="o">|</span>
 <span 
class="o">+----------+------------------------------------------------+</span>
@@ -668,10 +668,10 @@ entries entirely removed. The second is we can use the 
<code class="docutils lit
 <span class="o">|</span> <span class="n">Electric</span> <span 
class="o">|</span> <span class="p">[</span><span class="n">Steel</span><span 
class="p">,</span> <span class="n">Flying</span><span class="p">]</span>        
                        <span class="o">|</span>
 <span class="o">|</span> <span class="n">Fairy</span>    <span 
class="o">|</span>                                                <span 
class="o">|</span>
 <span class="o">|</span> <span class="n">Normal</span>   <span 
class="o">|</span> <span class="p">[</span><span class="n">Fairy</span><span 
class="p">,</span> <span class="n">Flying</span><span class="p">]</span>        
                        <span class="o">|</span>
-<span class="o">|</span> <span class="n">Ice</span>      <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Psychic</span><span class="p">]</span>       
                       <span class="o">|</span>
+<span class="o">|</span> <span class="n">Ice</span>      <span 
class="o">|</span> <span class="p">[</span><span class="n">Psychic</span><span 
class="p">,</span> <span class="n">Flying</span><span class="p">]</span>        
                      <span class="o">|</span>
 <span class="o">|</span> <span class="n">Grass</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Poison</span><span 
class="p">,</span> <span class="n">Psychic</span><span class="p">]</span>       
                       <span class="o">|</span>
 <span class="o">|</span> <span class="n">Fire</span>     <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Dragon</span><span class="p">]</span>        
                       <span class="o">|</span>
-<span class="o">|</span> <span class="n">Water</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Flying</span><span 
class="p">,</span> <span class="n">Dark</span><span class="p">,</span> <span 
class="n">Ice</span><span class="p">,</span> <span 
class="n">Psychic</span><span class="p">,</span> <span 
class="n">Fighting</span><span class="p">,</span> <span 
class="n">Poison</span><span class="p">]</span> <span class="o">|</span>
+<span class="o">|</span> <span class="n">Water</span>    <span 
class="o">|</span> <span class="p">[</span><span class="n">Fighting</span><span 
class="p">,</span> <span class="n">Psychic</span><span class="p">,</span> <span 
class="n">Dark</span><span class="p">,</span> <span 
class="n">Flying</span><span class="p">,</span> <span 
class="n">Poison</span><span class="p">,</span> <span class="n">Ice</span><span 
class="p">]</span> <span class="o">|</span>
 <span class="o">|</span> <span class="n">Ground</span>   <span 
class="o">|</span> <span class="p">[</span><span class="n">Rock</span><span 
class="p">]</span>                                         <span 
class="o">|</span>
 <span 
class="o">+----------+------------------------------------------------+</span>
 <span class="n">Data</span> <span class="n">truncated</span><span 
class="o">.</span>
diff --git a/user-guide/common-operations/basic-info.html 
b/user-guide/common-operations/basic-info.html
index 8300b0b2..3240ac20 100644
--- a/user-guide/common-operations/basic-info.html
+++ b/user-guide/common-operations/basic-info.html
@@ -456,11 +456,11 @@
 <span class="o">+-----+---------+--------+--------+</span>
 <span class="o">|</span> <span class="n">nrs</span> <span class="o">|</span> 
<span class="n">names</span>   <span class="o">|</span> <span 
class="n">random</span> <span class="o">|</span> <span class="n">groups</span> 
<span class="o">|</span>
 <span class="o">+-----+---------+--------+--------+</span>
-<span class="o">|</span> <span class="mi">1</span>   <span class="o">|</span> 
<span class="n">python</span>  <span class="o">|</span> <span 
class="mi">438</span>    <span class="o">|</span> <span class="n">A</span>      
<span class="o">|</span>
-<span class="o">|</span> <span class="mi">2</span>   <span class="o">|</span> 
<span class="n">ruby</span>    <span class="o">|</span> <span 
class="mi">76</span>     <span class="o">|</span> <span class="n">A</span>      
<span class="o">|</span>
-<span class="o">|</span> <span class="mi">3</span>   <span class="o">|</span> 
<span class="n">java</span>    <span class="o">|</span> <span 
class="mi">896</span>    <span class="o">|</span> <span class="n">B</span>      
<span class="o">|</span>
-<span class="o">|</span> <span class="mi">4</span>   <span class="o">|</span> 
<span class="n">haskell</span> <span class="o">|</span> <span 
class="mi">151</span>    <span class="o">|</span> <span class="n">C</span>      
<span class="o">|</span>
-<span class="o">|</span> <span class="mi">5</span>   <span class="o">|</span> 
<span class="n">go</span>      <span class="o">|</span> <span 
class="mi">571</span>    <span class="o">|</span> <span class="n">B</span>      
<span class="o">|</span>
+<span class="o">|</span> <span class="mi">1</span>   <span class="o">|</span> 
<span class="n">python</span>  <span class="o">|</span> <span 
class="mi">773</span>    <span class="o">|</span> <span class="n">A</span>      
<span class="o">|</span>
+<span class="o">|</span> <span class="mi">2</span>   <span class="o">|</span> 
<span class="n">ruby</span>    <span class="o">|</span> <span 
class="mi">333</span>    <span class="o">|</span> <span class="n">A</span>      
<span class="o">|</span>
+<span class="o">|</span> <span class="mi">3</span>   <span class="o">|</span> 
<span class="n">java</span>    <span class="o">|</span> <span 
class="mi">117</span>    <span class="o">|</span> <span class="n">B</span>      
<span class="o">|</span>
+<span class="o">|</span> <span class="mi">4</span>   <span class="o">|</span> 
<span class="n">haskell</span> <span class="o">|</span> <span 
class="mi">943</span>    <span class="o">|</span> <span class="n">C</span>      
<span class="o">|</span>
+<span class="o">|</span> <span class="mi">5</span>   <span class="o">|</span> 
<span class="n">go</span>      <span class="o">|</span> <span 
class="mi">226</span>    <span class="o">|</span> <span class="n">B</span>      
<span class="o">|</span>
 <span class="o">+-----+---------+--------+--------+</span>
 </pre></div>
 </div>
@@ -471,8 +471,8 @@
 <span class="o">+-----+--------+--------+--------+</span>
 <span class="o">|</span> <span class="n">nrs</span> <span class="o">|</span> 
<span class="n">names</span>  <span class="o">|</span> <span 
class="n">random</span> <span class="o">|</span> <span class="n">groups</span> 
<span class="o">|</span>
 <span class="o">+-----+--------+--------+--------+</span>
-<span class="o">|</span> <span class="mi">1</span>   <span class="o">|</span> 
<span class="n">python</span> <span class="o">|</span> <span 
class="mi">438</span>    <span class="o">|</span> <span class="n">A</span>      
<span class="o">|</span>
-<span class="o">|</span> <span class="mi">2</span>   <span class="o">|</span> 
<span class="n">ruby</span>   <span class="o">|</span> <span 
class="mi">76</span>     <span class="o">|</span> <span class="n">A</span>      
<span class="o">|</span>
+<span class="o">|</span> <span class="mi">1</span>   <span class="o">|</span> 
<span class="n">python</span> <span class="o">|</span> <span 
class="mi">773</span>    <span class="o">|</span> <span class="n">A</span>      
<span class="o">|</span>
+<span class="o">|</span> <span class="mi">2</span>   <span class="o">|</span> 
<span class="n">ruby</span>   <span class="o">|</span> <span 
class="mi">333</span>    <span class="o">|</span> <span class="n">A</span>      
<span class="o">|</span>
 <span class="o">+-----+--------+--------+--------+</span>
 </pre></div>
 </div>
@@ -490,28 +490,28 @@ passing them to an Arrow table, and then converting them 
to a pandas DataFrame.<
 <div class="highlight-ipython notranslate"><div 
class="highlight"><pre><span></span><span class="n">In</span> <span 
class="p">[</span><span class="mi">8</span><span class="p">]:</span> <span 
class="n">df</span><span class="o">.</span><span 
class="n">to_pandas</span><span class="p">()</span>
 <span class="n">Out</span><span class="p">[</span><span 
class="mi">8</span><span class="p">]:</span> 
    <span class="n">nrs</span>    <span class="n">names</span>  <span 
class="n">random</span> <span class="n">groups</span>
-<span class="mi">0</span>    <span class="mi">1</span>   <span 
class="n">python</span>     <span class="mi">438</span>      <span 
class="n">A</span>
-<span class="mi">1</span>    <span class="mi">2</span>     <span 
class="n">ruby</span>      <span class="mi">76</span>      <span 
class="n">A</span>
-<span class="mi">2</span>    <span class="mi">3</span>     <span 
class="n">java</span>     <span class="mi">896</span>      <span 
class="n">B</span>
-<span class="mi">3</span>    <span class="mi">4</span>  <span 
class="n">haskell</span>     <span class="mi">151</span>      <span 
class="n">C</span>
-<span class="mi">4</span>    <span class="mi">5</span>       <span 
class="n">go</span>     <span class="mi">571</span>      <span 
class="n">B</span>
+<span class="mi">0</span>    <span class="mi">1</span>   <span 
class="n">python</span>     <span class="mi">773</span>      <span 
class="n">A</span>
+<span class="mi">1</span>    <span class="mi">2</span>     <span 
class="n">ruby</span>     <span class="mi">333</span>      <span 
class="n">A</span>
+<span class="mi">2</span>    <span class="mi">3</span>     <span 
class="n">java</span>     <span class="mi">117</span>      <span 
class="n">B</span>
+<span class="mi">3</span>    <span class="mi">4</span>  <span 
class="n">haskell</span>     <span class="mi">943</span>      <span 
class="n">C</span>
+<span class="mi">4</span>    <span class="mi">5</span>       <span 
class="n">go</span>     <span class="mi">226</span>      <span 
class="n">B</span>
 </pre></div>
 </div>
 <p><a class="reference internal" 
href="../../autoapi/datafusion/dataframe/index.html#datafusion.dataframe.DataFrame.describe"
 title="datafusion.dataframe.DataFrame.describe"><code class="xref py py-func 
docutils literal notranslate"><span class="pre">describe()</span></code></a> 
shows a quick statistic summary of your data:</p>
 <div class="highlight-ipython notranslate"><div 
class="highlight"><pre><span></span><span class="n">In</span> <span 
class="p">[</span><span class="mi">9</span><span class="p">]:</span> <span 
class="n">df</span><span class="o">.</span><span class="n">describe</span><span 
class="p">()</span>
 <span class="n">Out</span><span class="p">[</span><span 
class="mi">9</span><span class="p">]:</span> 
 <span class="n">DataFrame</span><span class="p">()</span>
-<span 
class="o">+------------+--------------------+-------+--------------------+--------+</span>
-<span class="o">|</span> <span class="n">describe</span>   <span 
class="o">|</span> <span class="n">nrs</span>                <span 
class="o">|</span> <span class="n">names</span> <span class="o">|</span> <span 
class="n">random</span>             <span class="o">|</span> <span 
class="n">groups</span> <span class="o">|</span>
-<span 
class="o">+------------+--------------------+-------+--------------------+--------+</span>
-<span class="o">|</span> <span class="n">count</span>      <span 
class="o">|</span> <span class="mf">5.0</span>                <span 
class="o">|</span> <span class="mi">5</span>     <span class="o">|</span> <span 
class="mf">5.0</span>                <span class="o">|</span> <span 
class="mi">5</span>      <span class="o">|</span>
-<span class="o">|</span> <span class="n">null_count</span> <span 
class="o">|</span> <span class="mf">0.0</span>                <span 
class="o">|</span> <span class="mi">0</span>     <span class="o">|</span> <span 
class="mf">0.0</span>                <span class="o">|</span> <span 
class="mi">0</span>      <span class="o">|</span>
-<span class="o">|</span> <span class="n">mean</span>       <span 
class="o">|</span> <span class="mf">3.0</span>                <span 
class="o">|</span> <span class="n">null</span>  <span class="o">|</span> <span 
class="mf">426.4</span>              <span class="o">|</span> <span 
class="n">null</span>   <span class="o">|</span>
-<span class="o">|</span> <span class="n">std</span>        <span 
class="o">|</span> <span class="mf">1.5811388300841898</span> <span 
class="o">|</span> <span class="n">null</span>  <span class="o">|</span> <span 
class="mf">331.73528603390986</span> <span class="o">|</span> <span 
class="n">null</span>   <span class="o">|</span>
-<span class="o">|</span> <span class="nb">min</span>        <span 
class="o">|</span> <span class="mf">1.0</span>                <span 
class="o">|</span> <span class="n">go</span>    <span class="o">|</span> <span 
class="mf">76.0</span>               <span class="o">|</span> <span 
class="n">A</span>      <span class="o">|</span>
-<span class="o">|</span> <span class="nb">max</span>        <span 
class="o">|</span> <span class="mf">5.0</span>                <span 
class="o">|</span> <span class="n">ruby</span>  <span class="o">|</span> <span 
class="mf">896.0</span>              <span class="o">|</span> <span 
class="n">C</span>      <span class="o">|</span>
-<span class="o">|</span> <span class="n">median</span>     <span 
class="o">|</span> <span class="mf">3.0</span>                <span 
class="o">|</span> <span class="n">null</span>  <span class="o">|</span> <span 
class="mf">438.0</span>              <span class="o">|</span> <span 
class="n">null</span>   <span class="o">|</span>
-<span 
class="o">+------------+--------------------+-------+--------------------+--------+</span>
+<span 
class="o">+------------+--------------------+-------+-------------------+--------+</span>
+<span class="o">|</span> <span class="n">describe</span>   <span 
class="o">|</span> <span class="n">nrs</span>                <span 
class="o">|</span> <span class="n">names</span> <span class="o">|</span> <span 
class="n">random</span>            <span class="o">|</span> <span 
class="n">groups</span> <span class="o">|</span>
+<span 
class="o">+------------+--------------------+-------+-------------------+--------+</span>
+<span class="o">|</span> <span class="n">count</span>      <span 
class="o">|</span> <span class="mf">5.0</span>                <span 
class="o">|</span> <span class="mi">5</span>     <span class="o">|</span> <span 
class="mf">5.0</span>               <span class="o">|</span> <span 
class="mi">5</span>      <span class="o">|</span>
+<span class="o">|</span> <span class="n">null_count</span> <span 
class="o">|</span> <span class="mf">0.0</span>                <span 
class="o">|</span> <span class="mi">0</span>     <span class="o">|</span> <span 
class="mf">0.0</span>               <span class="o">|</span> <span 
class="mi">0</span>      <span class="o">|</span>
+<span class="o">|</span> <span class="n">mean</span>       <span 
class="o">|</span> <span class="mf">3.0</span>                <span 
class="o">|</span> <span class="n">null</span>  <span class="o">|</span> <span 
class="mf">478.4</span>             <span class="o">|</span> <span 
class="n">null</span>   <span class="o">|</span>
+<span class="o">|</span> <span class="n">std</span>        <span 
class="o">|</span> <span class="mf">1.5811388300841898</span> <span 
class="o">|</span> <span class="n">null</span>  <span class="o">|</span> <span 
class="mf">359.8955404002667</span> <span class="o">|</span> <span 
class="n">null</span>   <span class="o">|</span>
+<span class="o">|</span> <span class="nb">min</span>        <span 
class="o">|</span> <span class="mf">1.0</span>                <span 
class="o">|</span> <span class="n">go</span>    <span class="o">|</span> <span 
class="mf">117.0</span>             <span class="o">|</span> <span 
class="n">A</span>      <span class="o">|</span>
+<span class="o">|</span> <span class="nb">max</span>        <span 
class="o">|</span> <span class="mf">5.0</span>                <span 
class="o">|</span> <span class="n">ruby</span>  <span class="o">|</span> <span 
class="mf">943.0</span>             <span class="o">|</span> <span 
class="n">C</span>      <span class="o">|</span>
+<span class="o">|</span> <span class="n">median</span>     <span 
class="o">|</span> <span class="mf">3.0</span>                <span 
class="o">|</span> <span class="n">null</span>  <span class="o">|</span> <span 
class="mf">333.0</span>             <span class="o">|</span> <span 
class="n">null</span>   <span class="o">|</span>
+<span 
class="o">+------------+--------------------+-------+-------------------+--------+</span>
 </pre></div>
 </div>
 </section>
diff --git a/user-guide/common-operations/functions.html 
b/user-guide/common-operations/functions.html
index 4b7d990f..26dd3284 100644
--- a/user-guide/common-operations/functions.html
+++ b/user-guide/common-operations/functions.html
@@ -566,16 +566,16 @@ In here we will cover some of the more popular use cases. 
If you want to view al
 <span class="o">+-------------------------------+</span>
 <span class="o">|</span> <span class="n">now</span><span class="p">()</span>   
                      <span class="o">|</span>
 <span class="o">+-------------------------------+</span>
-<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">17</span><span class="n">T20</span><span class="p">:</span><span 
class="mi">39</span><span class="p">:</span><span 
class="mf">01.807246853</span> <span class="o">|</span>
-<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">17</span><span class="n">T20</span><span class="p">:</span><span 
class="mi">39</span><span class="p">:</span><span 
class="mf">01.807246853</span> <span class="o">|</span>
-<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">17</span><span class="n">T20</span><span class="p">:</span><span 
class="mi">39</span><span class="p">:</span><span 
class="mf">01.807246853</span> <span class="o">|</span>
-<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">17</span><span class="n">T20</span><span class="p">:</span><span 
class="mi">39</span><span class="p">:</span><span 
class="mf">01.807246853</span> <span class="o">|</span>
-<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">17</span><span class="n">T20</span><span class="p">:</span><span 
class="mi">39</span><span class="p">:</span><span 
class="mf">01.807246853</span> <span class="o">|</span>
-<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">17</span><span class="n">T20</span><span class="p">:</span><span 
class="mi">39</span><span class="p">:</span><span 
class="mf">01.807246853</span> <span class="o">|</span>
-<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">17</span><span class="n">T20</span><span class="p">:</span><span 
class="mi">39</span><span class="p">:</span><span 
class="mf">01.807246853</span> <span class="o">|</span>
-<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">17</span><span class="n">T20</span><span class="p">:</span><span 
class="mi">39</span><span class="p">:</span><span 
class="mf">01.807246853</span> <span class="o">|</span>
-<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">17</span><span class="n">T20</span><span class="p">:</span><span 
class="mi">39</span><span class="p">:</span><span 
class="mf">01.807246853</span> <span class="o">|</span>
-<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">17</span><span class="n">T20</span><span class="p">:</span><span 
class="mi">39</span><span class="p">:</span><span 
class="mf">01.807246853</span> <span class="o">|</span>
+<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">18</span><span class="n">T06</span><span class="p">:</span><span 
class="mi">14</span><span class="p">:</span><span 
class="mf">08.563777484</span> <span class="o">|</span>
+<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">18</span><span class="n">T06</span><span class="p">:</span><span 
class="mi">14</span><span class="p">:</span><span 
class="mf">08.563777484</span> <span class="o">|</span>
+<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">18</span><span class="n">T06</span><span class="p">:</span><span 
class="mi">14</span><span class="p">:</span><span 
class="mf">08.563777484</span> <span class="o">|</span>
+<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">18</span><span class="n">T06</span><span class="p">:</span><span 
class="mi">14</span><span class="p">:</span><span 
class="mf">08.563777484</span> <span class="o">|</span>
+<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">18</span><span class="n">T06</span><span class="p">:</span><span 
class="mi">14</span><span class="p">:</span><span 
class="mf">08.563777484</span> <span class="o">|</span>
+<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">18</span><span class="n">T06</span><span class="p">:</span><span 
class="mi">14</span><span class="p">:</span><span 
class="mf">08.563777484</span> <span class="o">|</span>
+<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">18</span><span class="n">T06</span><span class="p">:</span><span 
class="mi">14</span><span class="p">:</span><span 
class="mf">08.563777484</span> <span class="o">|</span>
+<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">18</span><span class="n">T06</span><span class="p">:</span><span 
class="mi">14</span><span class="p">:</span><span 
class="mf">08.563777484</span> <span class="o">|</span>
+<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">18</span><span class="n">T06</span><span class="p">:</span><span 
class="mi">14</span><span class="p">:</span><span 
class="mf">08.563777484</span> <span class="o">|</span>
+<span class="o">|</span> <span class="mi">2026</span><span 
class="o">-</span><span class="mi">03</span><span class="o">-</span><span 
class="mi">18</span><span class="n">T06</span><span class="p">:</span><span 
class="mi">14</span><span class="p">:</span><span 
class="mf">08.563777484</span> <span class="o">|</span>
 <span class="o">+-------------------------------+</span>
 <span class="n">Data</span> <span class="n">truncated</span><span 
class="o">.</span>
 </pre></div>


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to