differenceInCalendarUnits

differenceInCalendarUnits( timeUnit, time1, time2 )

Описание

Возвращает разницу (time2 - time1) между двумя модельными датами, выраженную в указанных единицах измерения времени. Модельные даты соответствуют переданным в функцию значениям модельного времени. 

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

Параметры

Имя

Тип значения

Описание

timeUnit

Допустимые значения:

MILLISECOND

SECOND

MINUTE

HOUR

DAY

WEEK

MONTH

YEAR

Задает константы для единиц измерения времени.

time1

double

Первое значение модельного времени.

time2

double

Второе значение модельного времени.

Результат

Тип

Описание

double

Разница (time2 - time1), выраженная в указанных единицах измерения времени.


differenceInCalendarUnits(timeUnit, date1, date2)

Описание

Returns the difference (date2 - date1) between two given model dates in the given time units. Result is the number of time units that should be added to the model date date1 to obtain date2. The result may be negative and may have fractional part depending on the given dates.

Parameter

Name

Type of value

Description

timeUnit

One of the following

constants:

MILLISECOND

SECOND

MINUTE

HOUR

DAY

WEEK

MONTH

YEAR

Defines the time units.

date1

double

The first model date.

date2

double

The second model date.

Result

Type

Description

double

The difference (time2 - time1) in the given time units.