Skip to content

Latest commit

 

History

History
90 lines (66 loc) · 3.26 KB

month-transact-sql.md

File metadata and controls

90 lines (66 loc) · 3.26 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic f1_keywords helpviewer_keywords dev_langs monikerRange
MONTH (Transact-SQL)
MONTH (Transact-SQL)
markingmyname
maghan
03/14/2017
sql
t-sql
reference
MONTH_TSQL
MONTH
values [SQL Server], date and time
dates [SQL Server], functions
month of year [SQL Server]
date and time [SQL Server], MONTH
dateparts [SQL Server], month
functions [SQL Server], date and time
dates [SQL Server], MONTH
MONTH function [SQL Server]
TSQL
>= aps-pdw-2016 || = azuresqldb-current || = azure-sqldw-latest || >= sql-server-2016 || >= sql-server-linux-2017 || = azuresqldb-mi-current

MONTH (Transact-SQL)

[!INCLUDE sql-asdb-asdbmi-asa-pdw]

Returns an integer that represents the month of the specified date.

For an overview of all [!INCLUDEtsql] date and time data types and functions, see Date and Time Data Types and Functions (Transact-SQL).

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

MONTH ( date )  

[!INCLUDEsql-server-tsql-previous-offline-documentation]

Arguments

date
Is an expression that can be resolved to a time, date, smalldatetime, datetime, datetime2, or datetimeoffset value. The date argument can be an expression, column expression, user-defined variable, or string literal.

Return Type

int

Return Value

MONTH returns the same value as DATEPART (month, date).

If date contains only a time part, the return value is 1, the base month.

Examples

The following statement returns 4. This is the number of the month.

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

The following statement returns 1900, 1, 1. The argument for date is the number 0. [!INCLUDEssNoVersion] interprets 0 as January 1, 1900.

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

Examples: [!INCLUDEssazuresynapse-md] and [!INCLUDEssPDW]

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;  

The following example returns 1900, 1, 1. The argument for date is the number 0. [!INCLUDEssNoVersion] interprets 0 as January 1, 1900.

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

See Also

CAST and CONVERT (Transact-SQL)