Additional translations for SQL Server DateTimeOffset

Closes #26781
Closes #38074
Closes #34756

Author: roji

.gitignore

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

src/EFCore.SqlServer/EFCore.SqlServer.baseline.json

@@ -845,6 +845,30 @@
         {
           "Member": "static System.DateTimeOffset Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DateTimeOffsetFromParts(this Microsoft.EntityFrameworkCore.DbFunctions _, int year, int month, int day, int hour, int minute, int second, int fractions, int hourOffset, int minuteOffset, int precision);"
         },
+        {
+          "Member": "static System.DateTime Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DateTrunc(this Microsoft.EntityFrameworkCore.DbFunctions _, string datepart, System.DateTime date);"
+        },
+        {
+          "Member": "static System.DateTime? Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DateTrunc(this Microsoft.EntityFrameworkCore.DbFunctions _, string datepart, System.DateTime? date);"
+        },
+        {
+          "Member": "static System.DateTimeOffset Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DateTrunc(this Microsoft.EntityFrameworkCore.DbFunctions _, string datepart, System.DateTimeOffset dateTimeOffset);"
+        },
+        {
+          "Member": "static System.DateTimeOffset? Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DateTrunc(this Microsoft.EntityFrameworkCore.DbFunctions _, string datepart, System.DateTimeOffset? dateTimeOffset);"
+        },
+        {
+          "Member": "static System.DateOnly Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DateTrunc(this Microsoft.EntityFrameworkCore.DbFunctions _, string datepart, System.DateOnly date);"
+        },
+        {
+          "Member": "static System.DateOnly? Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DateTrunc(this Microsoft.EntityFrameworkCore.DbFunctions _, string datepart, System.DateOnly? date);"
+        },
+        {
+          "Member": "static System.TimeOnly Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DateTrunc(this Microsoft.EntityFrameworkCore.DbFunctions _, string datepart, System.TimeOnly time);"
+        },
+        {
+          "Member": "static System.TimeOnly? Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.DateTrunc(this Microsoft.EntityFrameworkCore.DbFunctions _, string datepart, System.TimeOnly? time);"
+        },
         {
           "Member": "static bool Microsoft.EntityFrameworkCore.SqlServerDbFunctionsExtensions.FreeText(this Microsoft.EntityFrameworkCore.DbFunctions _, object propertyReference, string freeText, int languageTerm);"
         },
@@ -2630,7 +2654,7 @@
           "Member": "static System.Linq.IQueryable<Microsoft.EntityFrameworkCore.Query.FullTextSearchResult<TKey>> Microsoft.EntityFrameworkCore.SqlServerQueryableExtensions.FreeTextTable<T, TKey>(this Microsoft.EntityFrameworkCore.DbSet<T> source, string freeText, System.Linq.Expressions.Expression<System.Func<T, object>>? columnSelector = null, string? languageTerm = null, int? topN = null);"
         },
         {
-          "Member": "static System.Linq.IQueryable<Microsoft.EntityFrameworkCore.VectorSearchResult<T>> Microsoft.EntityFrameworkCore.SqlServerQueryableExtensions.VectorSearch<T, TVector>(this Microsoft.EntityFrameworkCore.DbSet<T> source, System.Linq.Expressions.Expression<System.Func<T, TVector>> vectorPropertySelector, TVector similarTo, string metric, int topN);",
+          "Member": "static System.Linq.IQueryable<Microsoft.EntityFrameworkCore.VectorSearchResult<T>> Microsoft.EntityFrameworkCore.SqlServerQueryableExtensions.VectorSearch<T, TVector>(this Microsoft.EntityFrameworkCore.DbSet<T> source, System.Linq.Expressions.Expression<System.Func<T, TVector>> vectorPropertySelector, TVector similarTo, string metric);",
           "Stage": "Experimental"
         }
       ]

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.