elastic · ivancea · Oct 17, 2025 · Oct 17, 2025 · Oct 17, 2025 · Oct 17, 2025
diff --git a/docs/changelog/138316.yaml b/docs/changelog/138316.yaml
@@ -0,0 +1,5 @@
+pr: 138316
+summary: '`DateDiff` timezone support'
+area: ES|QL
+type: feature
+issues: []
diff --git a/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date.csv-spec b/x-pack/plugin/esql/qa/testFixtures/src/main/resources/date.csv-spec
@@ -380,6 +380,28 @@ ROW end_23 = TO_DATETIME("2023-12-31T23:59:59.999Z"),
 // end::evalDateDiffYearForDocs-result[]
 ;
 
+dateDiffOffsetTimezone
+required_capability: date_diff_timezone_support
+
+set time_zone="+03:00"\;
+ROW diff = DATE_DIFF("months", "2010-10-07T00:00:00-03:00"::date, "2010-11-06T23:01:00-04:00"::date)
+;
+
+diff:integer
+1
+;
+
+dateDiffDstTimezone
+required_capability: date_diff_timezone_support
+
+set time_zone="America/Goose_Bay"\;
+ROW diff = DATE_DIFF("months", "2010-10-07T00:00:00-03:00"::date, "2010-11-06T23:01:00-04:00"::date)
+;
+
+diff:integer
+0
+;
+
 evalDateParseWithSimpleDate
 row a = "2023-02-01" | eval b = date_parse("yyyy-MM-dd", a) | keep b;
 

diff --git a/...ticsearch/xpack/esql/expression/function/scalar/date/DateDiffConstantMillisEvaluator.java b/...ticsearch/xpack/esql/expression/function/scalar/date/DateDiffConstantMillisEvaluator.java
diff --git a/...arch/xpack/esql/expression/function/scalar/date/DateDiffConstantMillisNanosEvaluator.java b/...arch/xpack/esql/expression/function/scalar/date/DateDiffConstantMillisNanosEvaluator.java
diff --git a/...sticsearch/xpack/esql/expression/function/scalar/date/DateDiffConstantNanosEvaluator.java b/...sticsearch/xpack/esql/expression/function/scalar/date/DateDiffConstantNanosEvaluator.java
diff --git a/...arch/xpack/esql/expression/function/scalar/date/DateDiffConstantNanosMillisEvaluator.java b/...arch/xpack/esql/expression/function/scalar/date/DateDiffConstantNanosMillisEvaluator.java