By: Daniel Calbimonte | Last Updated: 2018-12-06 | Comments (7) | Dates
Problem
SQL Server 2008 and earlier versions used the CONVERT functions to handle date formatting. In this tip, Date and Time Conversions Using SQL Server, we have a list of the available examples on how to use the CONVERT function to handle different date formats.
As you may know, the CONVERT function is not very flexible and we have limited date formats. In SQL Server 2012 and later, a new function FORMAT has been introduced which is much easier to use to format dates. This article shows different examples of using this new function to format dates.
Solution
Starting with SQL Server 2012, a new function to handle formatting dates was introduced which is similar to Oracle's to_date function. Many Oracle DBAs complained about the SQL Server CONVERT function and its poor flexibility and now we have a new way to format dates in SQL Server.
With the SQL Server FORMAT function we do not need to know the format number to use to get the right date format we want, we can just specify the display format we want and we get that format.
How to format SQL Server dates with FORMAT function
- Use the FORMAT function to format the date and time
- To get DD/MM/YYYY use SELECT FORMAT (getdate(), 'dd/MM/yyyy ') as date
- To get MM-DD-YY use SELECT FORMAT (getdate(), 'MM-dd-yy') as date
- Check out more examples below
The syntax of the SQL Server FORMAT function is the following:
FORMAT (value,format[,culture]) GO
SQL Server FORMAT Examples for Formatting Dates
Let's start with an example:
SELECT FORMAT (getdate(), 'dd-MM-yy') as date GO
The format will be as follows:
- dd - day number from 01-31
- MM - month number from 01-12
- yy - two digit year number
If this was run for March 21, 2018 the output would be: 21-03-18.
Let's try another one:
SELECT FORMAT (getdate(), 'hh:mm:ss') as time GO
The format will be as follows:
- hh - hour of day from 01-12
- mm - minutes of hour from 00-59
- ss - seconds of minute from 00-59
The output will be: 02:48:42.
SQL Server FORMAT with Culture
Another option for the FORMAT function is culture. With the culture option you can obtain regional formatting. Here is a list of culture codes to use with FORMAT.
For example in the USA, the format would be like:
SELECT FORMAT (getdate(), 'd', 'en-us') as date GO
In the USA the format is month, day, year.
If this was run for March 21, 2018 the output would be: 3/21/2018
Another example where we will use the Spanish culture in Bolivia (es-bo):
SELECT FORMAT (getdate(), 'd', 'es-bo') as date GO
In Bolivia the format is day, month, year.
If this was run for March 21, 2018 the output would be: 21/03/2018.
SQL Server FORMAT output examples
Below is a list of formats and an example of the output. The date used for all of these examples is "2018-03-21 11:36:14.840".
| Query | Sample output |
|---|---|
| SELECT FORMAT (getdate(), 'dd/MM/yyyy ') as date | 21/03/2018 |
| SELECT FORMAT (getdate(), 'dd/MM/yyyy, hh:mm:ss ') as date | 21/03/2018, 11:36:14 |
| SELECT FORMAT (getdate(), 'dddd, MMMM, yyyy') as date | Wednesday, March, 2018 |
| SELECT FORMAT (getdate(), 'MMM dd yyyy') as date | Mar 21 2018 |
| SELECT FORMAT (getdate(), 'MM.dd.yy') as date | 03.21.18 |
| SELECT FORMAT (getdate(), 'MM-dd-yy') as date | 03-21-18 |
| SELECT FORMAT (getdate(), 'hh:mm:ss tt') as date | 11:36:14 AM |
| SELECT FORMAT (getdate(), 'd','us') as date | 03/21/2018 |
As you can see, we used a lot of options for the date and time formatting, which are listed below.
- dd - this is day of month from 01-31
- dddd - this is the day spelled out
- MM - this is the month number from 01-12
- MMM - month name abbreviated
- MMMM - this is the month spelled out
- yy - this is the year with two digits
- yyyy - this is the year with four digits
- hh - this is the hour from 01-12
- HH - this is the hour from 00-23
- mm - this is the minute from 00-59
- ss - this is the second from 00-59
- tt - this shows either AM or PM
- d - this is day of month from 1-31 (if this is used on its own it will display the entire date)
- us - this shows the date using the US culture which is MM/DD/YYYY
For all the different custom date and time format strings to use with the SQL Server FORMAT command, check out this list.
Next Steps
- You can now work with a more flexible and intuitive function to handle date formats.
- Here is more information on the FORMAT function
Last Updated: 2018-12-06
About the author
Daniel Calbimonte is a Microsoft SQL Server MVP, Microsoft Certified Trainer and Microsoft Certified IT Professional.
View all my tips
