Skip to content

Latest commit

 

History

History
81 lines (61 loc) · 3.08 KB

File metadata and controls

81 lines (61 loc) · 3.08 KB
description YEAR (Transact-SQL)
title YEAR (Transact-SQL) | Microsoft Docs
ms.custom
ms.date 03/14/2017
ms.prod sql
ms.prod_service database-engine, sql-database, sql-data-warehouse, pdw
ms.reviewer
ms.technology t-sql
ms.topic reference
f1_keywords
YEAR
YEAR_TSQL
dev_langs
TSQL
helpviewer_keywords
dates [SQL Server], functions
dates [SQL Server], years
date and time [SQL Server], YEAR
functions [SQL Server], date and time
YEAR function [SQL Server]
dateparts [SQL Server], year
ms.assetid 74aa7ccc-8575-4018-80cf-14aeca379687
author julieMSFT
ms.author jrasnick
monikerRange >=aps-pdw-2016||=azuresqldb-current||=azure-sqldw-latest||>=sql-server-2016||>=sql-server-linux-2017||=azuresqldb-mi-current

YEAR (Transact-SQL)

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

Returns an integer that represents the year 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).

Topic link icon Transact-SQL Syntax Conventions

Syntax

YEAR ( 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 Types

int

Return Value

YEAR returns the same value as DATEPART (year, date).

If date only contains a time part, the return value is 1900, the base year.

Examples

The following statement returns 2010. This is the number of the year.

SELECT YEAR('2010-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: [!INCLUDEssSDWfull] and [!INCLUDEssPDW]

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

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

See Also

CAST and CONVERT (Transact-SQL)