dateDiff

Определяет целое количество единиц datepart, на которое дата1 меньше даты2.

dateDiff(datepart, date1, date2) → returns numeric

Синтаксис функции-члена

date2.diff(datepart, date1)

Справочник аргументов

datepart string
Обязательный

yyyy: Год q: Квартал m: Месяц y: День года d: День w: Неделя (день недели, cf2018+) ww: Неделя h: Час n: Минута s: Секунда

Значения:

yyyy
q
m
y
d
w
ww
h
n
s

date1 date
Обязательный

Меньшая дата для вычисления разницы. Может быть строкой или объектом даты; функция-член принимает только объект даты.

date2 date
Обязательный

Большая дата для вычисления разницы. Может быть строкой или объектом даты; функция-член принимает только объект даты.

Совместимость

ColdFusion:

Функция-член доступна в CF11 и более поздних версиях.

Lucee:

Функция-член доступна в Lucee 4.5 и более поздних версиях. Функция-член Lucee вычисляет разницу между датами в направлении, противоположном (+/-) функции-члену Adobe CF. См. пример ниже. Это поведение изменено в Lucee 6.0.0.130, чтобы соответствовать ACF.

Примеры
Пример кода с вызовом функции dateDiff

Пример dateDiff

Найдите разницу между двумя датами.

dateDiff("d", "2013-01-15", "2013-01-25")

Ожидаемый результат: 10

Сколько им лет?

Вычисляет возраст человека на основе переменной birthDate, содержащей дату. Для получения текущей даты используется функция now.

birthDate = createDate( 1972, 5, 20 );
age = dateDiff('yyyy', birthDate, now());
writeoutput( age );

Функция-член dateDiff

Обратите внимание на различия в поведении ColdFusion и Lucee.

testDate = now();
diffDate = dateAdd('d', 1, testDate);
writeOutput(testDate.diff('d', diffDate)); // this returns 1 on Lucee, and -1 on ColdFusion

© 2012–present Foundeo, Inc. and the CFDocs contributors.
Licensed under the MIT License.
ColdFusion is a trademark of Adobe Systems Incorporated.
https://cfdocs.org/datediff