MÊS (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsEndpoint de análise SQL no Microsoft FabricArmazém no Microsoft FabricBanco de dados SQL no Microsoft Fabric

Retorna um inteiro que representa o mês da date especificada.

Para ter uma visão geral de todas as funções e tipos de dados de data e hora do Transact-SQL, confira Funções e tipos de dados de data e hora (Transact-SQL).

Convenções de sintaxe de Transact-SQL

Sintaxe

MONTH ( date )  

Argumentos

date
É uma expressão que pode ser resolvida em um valor de time, date, smalldatetime, datetime, datetime2 ou datetimeoffset. O argumento date pode ser uma expressão, uma expressão de coluna, uma variável definida pelo usuário ou um literal de cadeia de caracteres.

Tipo de retorno

int

Valor retornado

MONTH retorna o mesmo valor que DATEPART (month, date).

Se date contiver apenas uma parte de hora, o valor retornado será 1, o mês base.

Exemplos

A instrução a seguir retorna 4. Este é o número do mês.

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

A instrução a seguir retorna 1900, 1, 1. O argumento para date é o número 0. SQL Server interpreta 0 como janeiro 1, 1900.

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

Exemplos: Azure Synapse Analytics

O exemplo a seguir retorna 4. Este é o número do mês.

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

O exemplo a seguir retorna 1900, 1, 1. O argumento para date é o número 0. SQL Server interpreta 0 como janeiro 1, 1900.

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

Conteúdo relacionado

• CAST e CONVERT (Transact-SQL)