MONTH (Transact-SQL)MONTH (Transact-SQL)

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL Database ДаУправляемый экземпляр SQL AzureAzure SQL Managed InstanceYesУправляемый экземпляр SQL AzureAzure SQL Managed Instance даAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics даПараллельное хранилище данныхParallel Data WarehouseyesПараллельное хранилище данныхParallel Data WarehouseПрименимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) ДаБаза данных SQL AzureAzure SQL DatabaseYesБаза данных SQL AzureAzure SQL Database ДаУправляемый экземпляр SQL AzureAzure SQL Managed InstanceYesУправляемый экземпляр SQL AzureAzure SQL Managed Instance даAzure Synapse AnalyticsAzure Synapse AnalyticsyesAzure Synapse AnalyticsAzure Synapse Analytics даПараллельное хранилище данныхParallel Data WarehouseyesПараллельное хранилище данныхParallel Data Warehouse

Возвращает целое число, представляющее месяц указанной даты date.Returns an integer that represents the month of the specified date.

Обзор всех типов данных и функций даты и времени в языке Transact-SQLTransact-SQL см. в статье Типы данных и функции даты и времени (Transact-SQL).For an overview of all Transact-SQLTransact-SQL date and time data types and functions, seeDate and Time Data Types and Functions (Transact-SQL).

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

MONTH ( date )  

Примечание

Ссылки на описание синтаксиса Transact-SQL для SQL Server 2014 и более ранних версий, см. в статье Документация по предыдущим версиям.To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

АргументыArguments

datedate
Выражение, которое можно привести к значению типа time, date, smalldatetime, datetime, datetime2 или datetimeoffset.Is an expression that can be resolved to a time, date, smalldatetime, datetime, datetime2, or datetimeoffset value. Аргумент date может быть выражением, выражением столбца, определяемой пользователем переменной или строковым литералом.The date argument can be an expression, column expression, user-defined variable, or string literal.

Тип возвращаемых данныхReturn Type

intint

Возвращаемое значениеReturn Value

Функция MONTH возвращает то же значение, что и функция DATEPART (month, date).MONTH returns the same value as DATEPART (month, date).

Если дата date содержит только компонент времени, возвращаемое значение равно 1, базовому месяцу.If date contains only a time part, the return value is 1, the base month.

ПримерыExamples

Следующая инструкция возвращает значение 4.The following statement returns 4. Порядковый номер месяца.This is the number of the month.

SELECT MONTH('2007-04-30T01:01:01.1234567 -07:00');  

Следующая инструкция возвращает значение 1900, 1, 1.The following statement returns 1900, 1, 1. В качестве значения аргумента date задается число 0.The argument for date is the number 0. SQL ServerSQL Server интерпретирует 0 как 1 января 1900 г.interprets 0 as January 1, 1900.

SELECT YEAR(0), MONTH(0), DAY(0);  

Примеры: Azure Synapse AnalyticsAzure Synapse Analytics и Параллельное хранилище данныхParallel Data WarehouseExamples: Azure Synapse AnalyticsAzure Synapse Analytics and Параллельное хранилище данныхParallel Data Warehouse

В приведенном ниже примере возвращается 4.The following example returns 4. Порядковый номер месяца.This is the number of the month.

-- Uses AdventureWorks  
  
SELECT TOP 1 MONTH('2007-04-30T01:01:01.1234')   
FROM dbo.DimCustomer;  

В приведенном ниже примере возвращается 1900, 1, 1.The following example returns 1900, 1, 1. В качестве значения аргумента date задается число 0.The argument for date is the number 0. SQL ServerSQL Server интерпретирует 0 как 1 января 1900 г.interprets 0 as January 1, 1900.

-- Uses AdventureWorks  
  
SELECT TOP 1 YEAR(0), MONTH(0), DAY(0) FROM dbo.DimCustomer;  

См. также:See Also

Функции CAST и CONVERT (Transact-SQL)CAST and CONVERT (Transact-SQL)