DATEDIFF (выражение служб SSIS)

Статья
01/02/2025

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure

Возвращает числовое значение границ дат или времени между двумя указанными датами. Параметр datepart указывает границы даты и времени, которые необходимо сравнить.

Синтаксис

  
DATEDIFF(datepart, startdate, endate)

Аргументы

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

startdate
Начальная дата периода.

endate
Конечная дата периода.

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

DT_I4

Замечания

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

часть_даты	Abbreviations
Год	yy, yyyy
Квартальная	qq, q
месяц	mm, m
День года	dy, y
день	dd, d
неделя	wk, ww
Weekday	dw, w
Часы	Hh
Minute	mi, n
Second	ss, s
Миллисекунда	Ms

DATEDIFF возвращает NULL, если хотя бы один аргумент имеет значение NULL.

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

Произойдет ошибка при передаче недопустимой даты, а также в случае, если единица времени или даты не является строкой или если дата начала либо конца не является датой.

Если конечная дата является более ранней, чем начальная, то функция возвращает отрицательное число. Если начальные и конечные даты равны друг другу или находятся в одном интервале, то функция возвращает ноль.

Примеры выражений служб SSIS

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

DATEDIFF("dd", (DT_DBTIMESTAMP)"8/1/2003", (DT_DBTIMESTAMP)"8/8/2003")

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

DATEDIFF("mm", (DT_DBTIMESTAMP)"8/1/2003",GETDATE())

Этот пример возвращает количество недель между датой в столбце ModifiedDate и переменной YearEndDate . Если YearEndDate имеет тип данных date , то явного приведения не требуется.

DATEDIFF("Week", ModifiedDate,@YearEndDate)

См. также

DATEADD (выражение служб SSIS)
DATEPART (выражение служб SSIS)
DAY (выражение служб SSIS)
MONTH (выражение служб SSIS)
YEAR (выражение служб SSIS)
Функции (выражение служб SSIS)

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