Additional translations for SQL Server DateTimeOffset

Closes #26781
Closes #38074
Closes #34756

Author: roji

.gitignore

@@ -342,3 +342,7 @@ ASALocalRun/
 # Local History for Visual Studio
 .localhistory/
 full.targets.txt
+
+
+# Language Server cache
+*.lscache

src/EFCore.Relational/Query/Internal/RelationalProjectionBindingExpressionVisitor.cs

@@ -98,7 +98,12 @@ public virtual Expression Translate(SelectExpression selectExpression, Expressio
     {
         switch (expression)
         {
-            case NewExpression or MemberInitExpression or StructuralTypeShaperExpression or IncludeExpression:
+            // In index-based binding mode, NewExpression falls through to the TranslateProjection path below,
+            // which allows provider-specific VisitNew overrides to translate constructors to SQL functions
+            // (e.g. new DateTimeOffset(DateTime, TimeSpan) → TODATETIMEOFFSET). If translation fails,
+            // the fallback base.Visit(expression) call routes to VisitNew for client-side DTO construction.
+            case NewExpression when !_indexBasedBinding:
+            case MemberInitExpression or StructuralTypeShaperExpression or IncludeExpression:
                 return base.Visit(expression);
 
             case null:

src/EFCore.SqlServer/Extensions/SqlServerDbFunctionsExtensions.cs

@@ -2167,6 +2167,202 @@ public static DateTimeOffset AtTimeZone(
         string timeZone)
         => throw new InvalidOperationException(CoreStrings.FunctionOnClient(nameof(AtTimeZone)));
 
+    #region DateTrunc
+
+    /// <summary>
+    ///     Truncates the <paramref name="date" /> to the specified <paramref name="datepart" /> precision.
+    ///     Corresponds to SQL Server's <c>DATETRUNC(datepart, date)</c>.
+    /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-database-functions">Database functions</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-sqlserver">Accessing SQL Server and Azure SQL databases with EF Core</see>
+    ///     for more information and examples.
+    /// </remarks>
+    /// <param name="_">The <see cref="DbFunctions" /> instance.</param>
+    /// <param name="datepart">
+    ///     The datepart to truncate to. Can be one of: <c>year</c>, <c>quarter</c>, <c>month</c>, <c>dayofyear</c>,
+    ///     <c>day</c>, <c>week</c>, <c>iso_week</c>, <c>hour</c>, <c>minute</c>, <c>second</c>, <c>millisecond</c>,
+    ///     <c>microsecond</c>.
+    /// </param>
+    /// <param name="date">The value to truncate.</param>
+    /// <returns>The truncated <see cref="DateTime" /> value.</returns>
+    /// <seealso href="https://learn.microsoft.com/sql/t-sql/functions/datetrunc-transact-sql">SQL Server documentation for <c>DATETRUNC</c>.</seealso>
+    public static DateTime DateTrunc(
+        this DbFunctions _,
+        [NotParameterized] string datepart,
+        DateTime date)
+        => throw new InvalidOperationException(CoreStrings.FunctionOnClient(nameof(DateTrunc)));
+
+    /// <summary>
+    ///     Truncates the <paramref name="date" /> to the specified <paramref name="datepart" /> precision.
+    ///     Corresponds to SQL Server's <c>DATETRUNC(datepart, date)</c>.
+    /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-database-functions">Database functions</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-sqlserver">Accessing SQL Server and Azure SQL databases with EF Core</see>
+    ///     for more information and examples.
+    /// </remarks>
+    /// <param name="_">The <see cref="DbFunctions" /> instance.</param>
+    /// <param name="datepart">
+    ///     The datepart to truncate to. Can be one of: <c>year</c>, <c>quarter</c>, <c>month</c>, <c>dayofyear</c>,
+    ///     <c>day</c>, <c>week</c>, <c>iso_week</c>, <c>hour</c>, <c>minute</c>, <c>second</c>, <c>millisecond</c>,
+    ///     <c>microsecond</c>.
+    /// </param>
+    /// <param name="date">The value to truncate.</param>
+    /// <returns>The truncated <see cref="DateTime" /> value.</returns>
+    /// <seealso href="https://learn.microsoft.com/sql/t-sql/functions/datetrunc-transact-sql">SQL Server documentation for <c>DATETRUNC</c>.</seealso>
+    public static DateTime? DateTrunc(
+        this DbFunctions _,
+        [NotParameterized] string datepart,
+        DateTime? date)
+        => throw new InvalidOperationException(CoreStrings.FunctionOnClient(nameof(DateTrunc)));
+
+    /// <summary>
+    ///     Truncates the <paramref name="dateTimeOffset" /> to the specified <paramref name="datepart" /> precision.
+    ///     Corresponds to SQL Server's <c>DATETRUNC(datepart, date)</c>.
+    /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-database-functions">Database functions</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-sqlserver">Accessing SQL Server and Azure SQL databases with EF Core</see>
+    ///     for more information and examples.
+    /// </remarks>
+    /// <param name="_">The <see cref="DbFunctions" /> instance.</param>
+    /// <param name="datepart">
+    ///     The datepart to truncate to. Can be one of: <c>year</c>, <c>quarter</c>, <c>month</c>, <c>dayofyear</c>,
+    ///     <c>day</c>, <c>week</c>, <c>iso_week</c>, <c>hour</c>, <c>minute</c>, <c>second</c>, <c>millisecond</c>,
+    ///     <c>microsecond</c>.
+    /// </param>
+    /// <param name="dateTimeOffset">The value to truncate.</param>
+    /// <returns>The truncated <see cref="DateTimeOffset" /> value.</returns>
+    /// <seealso href="https://learn.microsoft.com/sql/t-sql/functions/datetrunc-transact-sql">SQL Server documentation for <c>DATETRUNC</c>.</seealso>
+    public static DateTimeOffset DateTrunc(
+        this DbFunctions _,
+        [NotParameterized] string datepart,
+        DateTimeOffset dateTimeOffset)
+        => throw new InvalidOperationException(CoreStrings.FunctionOnClient(nameof(DateTrunc)));
+
+    /// <summary>
+    ///     Truncates the <paramref name="dateTimeOffset" /> to the specified <paramref name="datepart" /> precision.
+    ///     Corresponds to SQL Server's <c>DATETRUNC(datepart, date)</c>.
+    /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-database-functions">Database functions</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-sqlserver">Accessing SQL Server and Azure SQL databases with EF Core</see>
+    ///     for more information and examples.
+    /// </remarks>
+    /// <param name="_">The <see cref="DbFunctions" /> instance.</param>
+    /// <param name="datepart">
+    ///     The datepart to truncate to. Can be one of: <c>year</c>, <c>quarter</c>, <c>month</c>, <c>dayofyear</c>,
+    ///     <c>day</c>, <c>week</c>, <c>iso_week</c>, <c>hour</c>, <c>minute</c>, <c>second</c>, <c>millisecond</c>,
+    ///     <c>microsecond</c>.
+    /// </param>
+    /// <param name="dateTimeOffset">The value to truncate.</param>
+    /// <returns>The truncated <see cref="DateTimeOffset" /> value.</returns>
+    /// <seealso href="https://learn.microsoft.com/sql/t-sql/functions/datetrunc-transact-sql">SQL Server documentation for <c>DATETRUNC</c>.</seealso>
+    public static DateTimeOffset? DateTrunc(
+        this DbFunctions _,
+        [NotParameterized] string datepart,
+        DateTimeOffset? dateTimeOffset)
+        => throw new InvalidOperationException(CoreStrings.FunctionOnClient(nameof(DateTrunc)));
+
+    /// <summary>
+    ///     Truncates the <paramref name="date" /> to the specified <paramref name="datepart" /> precision.
+    ///     Corresponds to SQL Server's <c>DATETRUNC(datepart, date)</c>.
+    /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-database-functions">Database functions</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-sqlserver">Accessing SQL Server and Azure SQL databases with EF Core</see>
+    ///     for more information and examples.
+    /// </remarks>
+    /// <param name="_">The <see cref="DbFunctions" /> instance.</param>
+    /// <param name="datepart">
+    ///     The datepart to truncate to. Can be one of: <c>year</c>, <c>quarter</c>, <c>month</c>, <c>dayofyear</c>,
+    ///     <c>day</c>, <c>week</c>, <c>iso_week</c>, <c>hour</c>, <c>minute</c>, <c>second</c>, <c>millisecond</c>,
+    ///     <c>microsecond</c>.
+    /// </param>
+    /// <param name="date">The value to truncate.</param>
+    /// <returns>The truncated <see cref="DateOnly" /> value.</returns>
+    /// <seealso href="https://learn.microsoft.com/sql/t-sql/functions/datetrunc-transact-sql">SQL Server documentation for <c>DATETRUNC</c>.</seealso>
+    public static DateOnly DateTrunc(
+        this DbFunctions _,
+        [NotParameterized] string datepart,
+        DateOnly date)
+        => throw new InvalidOperationException(CoreStrings.FunctionOnClient(nameof(DateTrunc)));
+
+    /// <summary>
+    ///     Truncates the <paramref name="date" /> to the specified <paramref name="datepart" /> precision.
+    ///     Corresponds to SQL Server's <c>DATETRUNC(datepart, date)</c>.
+    /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-database-functions">Database functions</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-sqlserver">Accessing SQL Server and Azure SQL databases with EF Core</see>
+    ///     for more information and examples.
+    /// </remarks>
+    /// <param name="_">The <see cref="DbFunctions" /> instance.</param>
+    /// <param name="datepart">
+    ///     The datepart to truncate to. Can be one of: <c>year</c>, <c>quarter</c>, <c>month</c>, <c>dayofyear</c>,
+    ///     <c>day</c>, <c>week</c>, <c>iso_week</c>, <c>hour</c>, <c>minute</c>, <c>second</c>, <c>millisecond</c>,
+    ///     <c>microsecond</c>.
+    /// </param>
+    /// <param name="date">The value to truncate.</param>
+    /// <returns>The truncated <see cref="DateOnly" /> value.</returns>
+    /// <seealso href="https://learn.microsoft.com/sql/t-sql/functions/datetrunc-transact-sql">SQL Server documentation for <c>DATETRUNC</c>.</seealso>
+    public static DateOnly? DateTrunc(
+        this DbFunctions _,
+        [NotParameterized] string datepart,
+        DateOnly? date)
+        => throw new InvalidOperationException(CoreStrings.FunctionOnClient(nameof(DateTrunc)));
+
+    /// <summary>
+    ///     Truncates the <paramref name="time" /> to the specified <paramref name="datepart" /> precision.
+    ///     Corresponds to SQL Server's <c>DATETRUNC(datepart, date)</c>.
+    /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-database-functions">Database functions</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-sqlserver">Accessing SQL Server and Azure SQL databases with EF Core</see>
+    ///     for more information and examples.
+    /// </remarks>
+    /// <param name="_">The <see cref="DbFunctions" /> instance.</param>
+    /// <param name="datepart">
+    ///     The datepart to truncate to. Can be one of: <c>year</c>, <c>quarter</c>, <c>month</c>, <c>dayofyear</c>,
+    ///     <c>day</c>, <c>week</c>, <c>iso_week</c>, <c>hour</c>, <c>minute</c>, <c>second</c>, <c>millisecond</c>,
+    ///     <c>microsecond</c>.
+    /// </param>
+    /// <param name="time">The value to truncate.</param>
+    /// <returns>The truncated <see cref="TimeOnly" /> value.</returns>
+    /// <seealso href="https://learn.microsoft.com/sql/t-sql/functions/datetrunc-transact-sql">SQL Server documentation for <c>DATETRUNC</c>.</seealso>
+    public static TimeOnly DateTrunc(
+        this DbFunctions _,
+        [NotParameterized] string datepart,
+        TimeOnly time)
+        => throw new InvalidOperationException(CoreStrings.FunctionOnClient(nameof(DateTrunc)));
+
+    /// <summary>
+    ///     Truncates the <paramref name="time" /> to the specified <paramref name="datepart" /> precision.
+    ///     Corresponds to SQL Server's <c>DATETRUNC(datepart, date)</c>.
+    /// </summary>
+    /// <remarks>
+    ///     See <see href="https://aka.ms/efcore-docs-database-functions">Database functions</see>, and
+    ///     <see href="https://aka.ms/efcore-docs-sqlserver">Accessing SQL Server and Azure SQL databases with EF Core</see>
+    ///     for more information and examples.
+    /// </remarks>
+    /// <param name="_">The <see cref="DbFunctions" /> instance.</param>
+    /// <param name="datepart">
+    ///     The datepart to truncate to. Can be one of: <c>year</c>, <c>quarter</c>, <c>month</c>, <c>dayofyear</c>,
+    ///     <c>day</c>, <c>week</c>, <c>iso_week</c>, <c>hour</c>, <c>minute</c>, <c>second</c>, <c>millisecond</c>,
+    ///     <c>microsecond</c>.
+    /// </param>
+    /// <param name="time">The value to truncate.</param>
+    /// <returns>The truncated <see cref="TimeOnly" /> value.</returns>
+    /// <seealso href="https://learn.microsoft.com/sql/t-sql/functions/datetrunc-transact-sql">SQL Server documentation for <c>DATETRUNC</c>.</seealso>
+    public static TimeOnly? DateTrunc(
+        this DbFunctions _,
+        [NotParameterized] string datepart,
+        TimeOnly? time)
+        => throw new InvalidOperationException(CoreStrings.FunctionOnClient(nameof(DateTrunc)));
+
+    #endregion DateTrunc
+
     /// <summary>
     ///     Returns the starting position of the first occurrence of a pattern in a specified expression, or zero if the pattern is not found, on
     ///     all valid text and character data types.