You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@datafusion.apache.org by gi...@apache.org on 2026/09/27 04:37:57 UTC
(datafusion) branch asf-site updated: Publish built docs triggered by b7ccbbd6f41c012a599610c1ac386380ddab49b6
This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/datafusion.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 716618f6d3 Publish built docs triggered by b7ccbbd6f41c012a599610c1ac386380ddab49b6
716618f6d3 is described below
commit 716618f6d3614165fe8378ce2d42a5d467bc7e6c
Author: github-actions[bot] <gi...@users.noreply.github.com>
AuthorDate: Sun Sep 27 04:37:51 2026 +0000
Publish built docs triggered by b7ccbbd6f41c012a599610c1ac386380ddab49b6
---
_sources/library-user-guide/upgrading/56.0.0.md.txt | 16 ++++++++++++++++
library-user-guide/upgrading/56.0.0.html | 16 ++++++++++++++++
searchindex.js | 2 +-
3 files changed, 33 insertions(+), 1 deletion(-)
diff --git a/_sources/library-user-guide/upgrading/56.0.0.md.txt b/_sources/library-user-guide/upgrading/56.0.0.md.txt
index fc5e9d2f03..d3b2d51e85 100644
--- a/_sources/library-user-guide/upgrading/56.0.0.md.txt
+++ b/_sources/library-user-guide/upgrading/56.0.0.md.txt
@@ -122,6 +122,22 @@ Rewriting affected files with a current DataFusion version, for example using
restores optimizations that depend on them. Preserve the required data ordering
and ordering metadata when rewriting sorted files.
+### `Timestamp(u, Some(tz)) - Timestamp(u, None)` reads the naive operand in `tz`
+
+Subtracting a timezone-naive timestamp from a timezone-aware one _at the same
+time unit_ did not coerce at all in `55.0.0`: the naive operand was read as UTC,
+which differed both from `=` on the same pair of values and from every other
+pairing of time units. It now coerces like the rest, so the naive operand is
+read in the aware operand's time zone:
+
+```sql
+-- ts_tz is 2024-11-01T00:00:00-04:00 (America/New_York), ts is the naive
+-- 2024-11-01T00:00:00; ts_tz = ts is true in both versions
+-- 55.0.0: 0 days 4 hours 0 mins 0.000000000 secs
+-- 56.0.0: 0 days 0 hours 0 mins 0.000000000 secs
+SELECT ts_tz - ts FROM timestamps;
+```
+
### `ForeignSession::create_physical_plan` is unsupported
`ForeignSession::create_physical_plan` no longer forwards to the library that
diff --git a/library-user-guide/upgrading/56.0.0.html b/library-user-guide/upgrading/56.0.0.html
index 794e113c95..e2448e079e 100644
--- a/library-user-guide/upgrading/56.0.0.html
+++ b/library-user-guide/upgrading/56.0.0.html
@@ -538,6 +538,21 @@ DataFusion CLI:</p>
restores optimizations that depend on them. Preserve the required data ordering
and ordering metadata when rewriting sorted files.</p>
</section>
+<section id="timestamp-u-some-tz-timestamp-u-none-reads-the-naive-operand-in-tz">
+<h3><code class="docutils literal notranslate"><span class="pre">Timestamp(u,</span> <span class="pre">Some(tz))</span> <span class="pre">-</span> <span class="pre">Timestamp(u,</span> <span class="pre">None)</span></code> reads the naive operand in <code class="docutils literal notranslate"><span class="pre">tz</span></code><a class="headerlink" href="#timestamp-u-some-tz-timestamp-u-none-reads-the-naive-operand-in-tz" title="Link to this heading">#</a></h3>
+<p>Subtracting a timezone-naive timestamp from a timezone-aware one <em>at the same
+time unit</em> did not coerce at all in <code class="docutils literal notranslate"><span class="pre">55.0.0</span></code>: the naive operand was read as UTC,
+which differed both from <code class="docutils literal notranslate"><span class="pre">=</span></code> on the same pair of values and from every other
+pairing of time units. It now coerces like the rest, so the naive operand is
+read in the aware operand’s time zone:</p>
+<div class="highlight-sql notranslate"><div class="highlight"><pre><span></span><span class="c1">-- ts_tz is 2024-11-01T00:00:00-04:00 (America/New_York), ts is the naive</span>
+<span class="c1">-- 2024-11-01T00:00:00; ts_tz = ts is true in both versions</span>
+<span class="c1">-- 55.0.0: 0 days 4 hours 0 mins 0.000000000 secs</span>
+<span class="c1">-- 56.0.0: 0 days 0 hours 0 mins 0.000000000 secs</span>
+<span class="k">SELECT</span><span class="w"> </span><span class="n">ts_tz</span><span class="w"> </span><span class="o">-</span><span class="w"> </span><span class="n">ts</span><span class="w"> </span><span class="k">FROM</span><span class="w"> </span><span class="n">timestamps</span><span class="p">;</span>
+</pre></div>
+</div>
+</section>
<section id="foreignsession-create-physical-plan-is-unsupported">
<h3><code class="docutils literal notranslate"><span class="pre">ForeignSession::create_physical_plan</span></code> is unsupported<a class="headerlink" href="#foreignsession-create-physical-plan-is-unsupported" title="Link to this heading">#</a></h3>
<p><code class="docutils literal notranslate"><span class="pre">ForeignSession::create_physical_plan</span></code> no longer forwards to the library that
@@ -1017,6 +1032,7 @@ expressions, which can cause resolution failure or incorrect rebinding.</p></li>
</li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#parquetaccessplan-into-overall-row-selection-is-deprecated"><code class="docutils literal notranslate"><span class="pre">ParquetAccessPlan::into_overall_row_selection</span></code> is deprecated</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#missing-parquet-null-counts-are-treated-as-unknown">Missing Parquet null counts are treated as unknown</a></li>
+<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#timestamp-u-some-tz-timestamp-u-none-reads-the-naive-operand-in-tz"><code class="docutils literal notranslate"><span class="pre">Timestamp(u,</span> <span class="pre">Some(tz))</span> <span class="pre">-</span> <span class="pre">Timestamp(u,</span> <span class="pre">None)</span></code> reads the naive operand in <code class="docutils literal notranslate"><span class="pre">tz</span></code></a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#foreignsession-create-physical-plan-is-unsupported"><code class="docutils literal notranslate"><span class="pre">ForeignSession::create_physical_plan</span></code> is unsupported</a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#groupcolumn-now-requires-values-preserving"><code class="docutils literal notranslate"><span class="pre">GroupColumn</span></code> now requires <code class="docutils literal notranslate"><span class="pre">values_preserving</span></code></a></li>
<li class="toc-h3 nav-item toc-entry"><a class="reference internal nav-link" href="#datafusion-proto-common-option-and-constraint-conversions-are-fallible"><code class="docutils literal notranslate"><span class="pre">datafusion-proto</span></code>: common option and constraint conversions are fallible</a></li>
diff --git a/searchindex.js b/searchindex.js
index cb62a4e445..4b49c11ad5 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"!=":[[77,"op-neq"]],"!~":[[77,"op-re-not-match"]],"!~*":[[77,"op-re-not-match-i"]],"!~~":[[77,"id19"]],"!~~*":[[77,"id20"]],"#":[[77,"op-bit-xor"]],"%":[[77,"op-modulo"]],"&":[[77,"op-bit-and"]],"(relation, name) tuples in logical fields and logical columns are unique":[[16,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[77,"op-multiply"]],"+":[[77,"op-plus"]],"-":[[77,"op-minus"]],"/":[[77,"op-divide"]],"1. Array Literal Con [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"!=":[[77,"op-neq"]],"!~":[[77,"op-re-not-match"]],"!~*":[[77,"op-re-not-match-i"]],"!~~":[[77,"id19"]],"!~~*":[[77,"id20"]],"#":[[77,"op-bit-xor"]],"%":[[77,"op-modulo"]],"&":[[77,"op-bit-and"]],"(relation, name) tuples in logical fields and logical columns are unique":[[16,"relation-name-tuples-in-logical-fields-and-logical-columns-are-unique"]],"*":[[77,"op-multiply"]],"+":[[77,"op-plus"]],"-":[[77,"op-minus"]],"/":[[77,"op-divide"]],"1. Array Literal Con [...]
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@datafusion.apache.org
For additional commands, e-mail: commits-help@datafusion.apache.org