Udostępnij za pośrednictwem

  • Artykuł

DATENAME (Transact-SQL)

Zwraca znak ciąg , który reprezentuje określony datepart z określonym date

Przegląd wszystkich Transact-SQL data i czas typów danych i funkcji, zobacz Funkcje daty i godziny (Transact-SQL).Informacje i przykłady, które są wspólne dla data i czas typów danych i funkcji, zobacz Data i czas danych.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

DATENAME ( datepart , date )

Argumenty

  • datepart
    Jest to część date do zwrotu.W poniższej tabela wymieniono wszystkie prawidłowe datepart argumentów.Odpowiedniki zmienne zdefiniowane przez użytkownika nie są prawidłowe.

    datepart

    Skróty

    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
    To wyrażenie , które może być przetłumaczona na time, date, smalldatetime, datetime, datetime2, lub datetimeoffset wartości.datemoże być wyrażenie,wyrażenie kolumna, zmienna zdefiniowane przez użytkownika lub ciąg literału.

    Aby uniknąć niejednoznaczności, za pomocą czterech cyfr.Aby uzyskać informacje o dwóch cyfr, zobacz Opcja dwie cyfry roku odcięcia.

Zwracany typ

nvarchar

Wartość zwracana

  • Każdy datepart i jego skróty zwraca te same wartości.

Zwracana wartość zależy od środowiska język zestaw za pomocą Ustaw język oraz język domyślny logowania.Wartość zwracana jest uzależniona od USTAWIĆ format daty Jeśli date ciąg literału niektórych formatów.Ustaw format daty nie narusza zwracanej wartości data jestwyrażenie kolumnatypu danych data lub czas .

W wersjach SQL Server później niż SQL Server 2000, gdy date parametr ma date argumentu typ danych zwracanej wartości zależy od ustawień określonych przy użyciu USTAWIĆ DATEFIRST.

Datepart TZoffset argumentu

Jeśli datepart argument jest TZoffset ()tz) i date argument nie ma żadnych przesunięcie strefy czas , 0 jest zwracana.

smalldatetime data argumentu

Gdy date jest smalldatetime, sekund są zwracane jako 00.

Zwrócona domyślne dla datepart jest nie w polu data argumentu

Jeśli typ danych date argument nie ma określonego datepart, domyślną dla tej datepart zostaną zwrócone.

Na przykład domyślna rok miesiąc dzień dla każdego date Typ danych jest 1900-01-01.Poniższa instrukcja zawiera argumenty część data dla datepart, argument czas dla datei zwraca 1900, January, 1, 1, Monday.

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');

Domyślna godzina minuty sekundy dla time Typ danych to 00: 00:00.Poniższa instrukcja zawiera argumenty część czas dla datepart, argument data dla datei zwraca 0, 0, 0.

SELECT DATENAME(hour, '2007-06-01')
    ,DATENAME(minute, '2007-06-01')
    ,DATENAME(second, '2007-06-01');

Uwagi

DATENAME mogą być używane w liście, w przypadku gdy występują, Grupuj według, a ORDER BY klauzule.W SQL Server 2008, posługując się miarką DATENAME niejawnie kątową literały ciągów ciąg jako datetime2 typów.Podczas korzystania z DATENAME z DATEADD uniknąć niejawna poświaty literały ciągów ciąg .Aby uzyskać więcej informacji, zobacz DATEADD (Transact-SQL).

Przykłady

Poniższy przykład zwraca części data dla podanej data.

SELECT DATENAME(datepart,'2007-10-30 12:15:32.1234567 +05:10')

Oto zestaw wyników.

datepart

Zwracanie wartości

year, yyyy, yy

2007

quarter, qq, q

4

month, mm, m

Października

dayofyear, dy, y

303

day, dd, d

30

week, wk, ww

44

weekday, dw

Wtorek

hour, hh

12

minute, n

15

second, ss, s

32

millisecond, ms

123

microsecond, mcs

123456

nanosecond, ns

123456700

TZoffset, tz

310

Zobacz także

Odwołanie

CAST i CONVERT (Transact-SQL)