通过

DATETIME2FROMPARTS (Transact-SQL)

  • 项目

对指定的日期和时间返回 datetime2 值（具有指定精度）。

主题链接图标 Transact-SQL 语法约定

语法

DATETIME2FROMPARTS ( year, month, day, hour, minute, seconds, fractions, precision )

参数

  • year
    用于指定年度的整数表达式。

  • month
    用于指定月份的整数表达式。

  • day
    用于指定日期的整数表达式。

  • hour
    用于指定小时的整数表达式。

  • minute
    用于指定分钟的整数表达式。

  • seconds
    用于指定秒的整数表达式。

  • fractions
    用于指定小数部分的整数表达式。

  • precision
    整数文字，用于指定要返回的 datetime2 值的精度。

返回类型

datetime2 ( precision )

注释

DATETIME2FROMPARTS 返回完全初始化的 datetime2 值。 如果参数无效，则引发错误。 如果所需的参数为 null，则返回 null。 但是，如果 precision 参数为 Null，则会引发错误。

fractions 参数取决于 precision 参数。 例如，如果 precision 为 7，则每个分数表示 100 毫微秒；如果 precision 为 3，则每个分数表示 1 毫秒。 如果 precision 的值为零，则 fractions 的值也必须为零；否则将引发错误。

此函数可以在 SQL Server 2012 服务器以及更高版本上远程执行。 但在 SQL Server 2012 之下的服务器版本中无法远程执行。

示例

A.不包含秒的小数部分的简单示例

SELECT DATETIME2FROMPARTS ( 2010, 12, 31, 23, 59, 59, 0, 0 ) AS Result;

下面是结果集：

Result
---------------------------
2010-12-31 23:59:59.0000000

(1 row(s) affected)

B.包含秒的小数部分的示例

以下示例演示了 fractions 和 precision 参数的用法：

  1. 如果 fractions 的值为 5、precision 的值为 1，则 fractions 的值表示 5/10 秒。

  2. 如果 fractions 的值为 50、precision 的值为 2，则 fractions 的值表示 50/100 秒。

  3. 如果 fractions 的值为 500、precision 的值为 3，则 fractions 的值表示 500/1000 秒。

SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 5, 1 );
SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 50, 2 );
SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 500, 3 );
GO

下面是结果集：

----------------------
2011-08-15 14:23:44.5

(1 row(s) affected)


----------------------
2011-08-15 14:23:44.50

(1 row(s) affected)


----------------------
2011-08-15 14:23:44.500

(1 row(s) affected)

请参阅

参考

datetime2 (Transact-SQL)