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

• 03/14/2017
• Чтение занимает 2 мин
• • c
  • o
  • O

Применимо к:Applies to: SQL ServerSQL Server (все поддерживаемые версии) SQL ServerSQL Server (all supported versions) База данных SQL AzureAzure SQL DatabaseБаза данных SQL AzureAzure SQL Database Управляемый экземпляр SQL AzureAzure SQL Managed InstanceУправляемый экземпляр SQL AzureAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Параллельное хранилище данныхParallel Data WarehouseПараллельное хранилище данныхParallel Data WarehouseПрименимо к:Applies to: SQL ServerSQL Server (все поддерживаемые версии) SQL ServerSQL Server (all supported versions) База данных SQL AzureAzure SQL DatabaseБаза данных SQL AzureAzure SQL Database Управляемый экземпляр SQL AzureAzure SQL Managed InstanceУправляемый экземпляр SQL AzureAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Параллельное хранилище данныхParallel Data WarehouseПараллельное хранилище данных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-SQL Transact-SQL Syntax Conventions

СинтаксисSyntax

MONTH ( date )  

Аргументы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)