MONTH (Transact-SQL)

  • Статья

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)

Возвращает целое число, представляющее месяц указанной даты date.

Обзор всех типов данных и функций даты и времени в языке Transact-SQL см. в статье Типы данных и функции даты и времени (Transact-SQL).

Соглашения о синтаксисе Transact-SQL

Синтаксис

MONTH ( date )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

date
Выражение, которое можно привести к значению типа time, date, smalldatetime, datetime, datetime2 или datetimeoffset. Аргумент date может быть выражением, выражением столбца, определяемой пользователем переменной или строковым литералом.

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

int

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

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

Если дата date содержит только компонент времени, возвращаемое значение равно 1, базовому месяцу.

Примеры

Следующая инструкция возвращает значение 4. Порядковый номер месяца.

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

Следующая инструкция возвращает значение 1900, 1, 1. В качестве значения аргумента date задается число 0. SQL Server интерпретируется 0 как 1 января 1900 г.

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

Примеры: Azure Synapse Analytics и система платформы аналитики (PDW)

В приведенном ниже примере возвращается 4. Порядковый номер месяца.

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

В приведенном ниже примере возвращается 1900, 1, 1. В качестве значения аргумента date задается число 0. SQL Server интерпретируется 0 как 1 января 1900 г.

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

См. также

CAST и CONVERT (Transact-SQL)