Поделиться через

  • Статья

DATEPART (службы SSIS)

Возвращает целое число, обозначающее раздел даты.

Синтаксис

DATEPART(datepart, date)

Аргументы

  • datepart
    Параметр, который указывает, для какой части даты вернуть новое значение.

  • date
    Выражение, возвращающее допустимую дату или строку в формате даты.

Типы результата

DT_I4

Замечания

DATEPART возвращает NULL при аргументе NULL.

Литерал даты должен быть точно приведен к одному типу данных дат. Дополнительные сведения см. в разделе Типы данных служб Integration Services.

ПримечаниеПримечание

Выражению не удается выполнить проверку, когда литерал даты должен быть точно приведен к одному типу данных дат: DT_DBTIMESTAMPOFFSET, DT_DBTIMESTAMP2 и DT_DBTIME2.

В следующей таблице перечислены части дат и сокращения, распознаваемые средством оценки выражений. Имена разделов даты обрабатываются без учета регистра.

Часть даты

Сокращения

Год

yy, yyyy

Квартал

qq, q

Месяц

mm, m

День года

dy, y

День

dd, d

Неделя

wk, ww

День недели

dw, w

Час

Hh

Минута

mi, n

Секунда

ss, s

Миллисекунда

Ms

Примеры

Этот пример возвращает целое число, которое представляет год текущей даты. Если формат даты «мм/дд/гггг», то этот пример возвращает 11.

DATEPART("month", (DT_DBTIMESTAMP)"11/04/2002")

Этот пример возвращает целое число, представляющее день в столбце ModifiedDate.

DATEPART("dd", ModifiedDate)

Этот пример возвращает целое число, представляющее год в текущей дате.

DATEPART("yy",GETDATE())