datename (Transact-sql)
Belirtilen temsil eden bir karakter dizesi döndüren datepartbelirtilendate
Tüm genel bakış için Transact-SQLbkz: Tarih ve Saat veri türleri ve işlevler, Tarih ve Saat veri türleri ve işlevler (Transact-sql).
Transact-SQL Sözdizim Kuralları
Sözdizimi
DATENAME ( datepart , date )
Bağımsız değişkenler
datepart
Bir parçası datedönmek. Aşağıdaki tablo listeleri tüm geçerli datepartargümanları. Kullanıcı tanımlı değişken karşılıkları geçerli değildir.datepart
Kısaltmalar
year
yy, yyyy
quarter
qq, q
month
mm, m
dayofyear
dy, y
day
dd, d
week
wk, ww
weekday
dw
hour
hh
minute
mi, n
second
ss, s
millisecond
ms
microsecond
mcs
nanosecond
ns
TZoffset
tz
date
Bir time, date, smalldatetime, datetime, datetime2 veya datetimeoffset değerine çözülebilen bir ifadedir. datebir ifade, sütun ifadesi, kullanıcı tanımlı bir değişken veya dize değişmezi olabilir.Belirsizlikten kaçınmak için dört rakamlı yıllar kullanın. Hakkında bilgi için bkz: iki basamaklı yılları, Yapılandırma iki basamaklı yıl kesme sunucu yapılandırma seçeneği.
Dönüş Türü
nvarchar
Dönüş Değeri
- Her datepartve kendi kısaltmaları aynı değeri dönmek.
Dönüş değeri kullanarak dil ortamına bağlıdır Dil ve Varsayılan dil sunucu yapılandırma seçeneği yapılandırmakaçma. Dönüş değeri üzerinde bağlıdır set dateformat , datebir dize hazır bazı biçimleri. Tarih, tarih ve saat veri türünde bir sütun ifadesiyse, SET DATEFORMAT döndürülen değeri etkilemez.
Ne zaman dateparametre bir dateveri türü değişkeni, dönüş değeri kullanarak belirtilen ayarına bağlıdır set DATEFIRST.
TZoffset datepart Argument
Eğer datepartbağımsız değişkeni TZoffset(tz) ve datebağımsız değişkeni vardır hiçbir Saat dilimi uzaklığı, 0 döner.
smalldatetime date Değişkeni
Ne zaman dateolan smalldatetime, saniye 00 döndürülür.
Bir datepart That Is Not Argument tarih varsayılan iade
Eğer veri türü datebağımsız değişkeni belirtilen yok datepart, bu varsayılan datepartiade edilecektir.
Örneğin, herhangi bir date veri türünün yıl-ay-gün varsayılan değeri 1900-01-01'dir. Aşağıdaki deyimin datepart için tarih kısmı değişkenleri, date için bir saat değişkeni vardır ve 1900, January, 1, 1, Monday döndürür.
SELECT DATENAME(year, '12:10:30.123')
,DATENAME(month, '12:10:30.123')
,DATENAME(day, '12:10:30.123')
,DATENAME(dayofyear, '12:10:30.123')
,DATENAME(weekday, '12:10:30.123');
SELECT DATENAME(year, '12:10:30.123')
,DATENAME(month, '12:10:30.123')
,DATENAME(day, '12:10:30.123')
,DATENAME(dayofyear, '12:10:30.123')
,DATENAME(weekday, '12:10:30.123');
time veri türü için varsayılan saat-dakika-saniye 00:00:00'dır. Saat bölümü bağımsız değişkenleri aşağıdaki deyimi olan datepart, bir tarih bağımsız değişkeni için dateve 0, 0, 0.
SELECT DATENAME(hour, '2007-06-01')
,DATENAME(minute, '2007-06-01')
,DATENAME(second, '2007-06-01');
SELECT DATENAME(hour, '2007-06-01')
,DATENAME(minute, '2007-06-01')
,DATENAME(second, '2007-06-01');
Açıklamalar
datename seçme listesinde kullanılan nerede, sahip, by ve order by yan tümceleri.
De SQL Server 2012, datename örtülü atmalarını dize hazır bilgi olarak bir datetime2türü. Bu tarihi bir dizge olarak iletildiğinde datename ydm biçimi desteklemiyor demektir. Açıkça dize döküm gerekir bir datetimeya smalldatetimeydm biçimi türü.
Örnekler
Aşağıdaki örnek, belirtilen tarih için Tarih bölümleri verir.
SELECT DATENAME(datepart,'2007-10-30 12:15:32.1234567 +05:10')
Sonuç kümesi buradadır.
datepart |
Dönüş değeri |
---|---|
year, yyyy, yy |
2007 |
quarter, qq, q |
4 |
month, mm, m |
Ekim |
dayofyear, dy, y |
303 |
day, dd, d |
30 |
week, wk, ww |
44 |
weekday, dw |
Salı |
hour, hh |
12 |
minute, n |
15 |
second, ss, s |
32 |
millisecond, ms |
123 |
microsecond, mcs |
123456 |
nanosecond, ns |
123456700 |
TZoffset, tz |
310 |