Объекты этого серверного класса хранят продолжительность в виде даты и времени, начиная с 1 января 1970 года, 00:00:00.SimpleDuration(duration)
Используйте этот конструктор для создания нового экземпляра объекта SimpleDuration.
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
duration | Integer (секунды) | Нет | '' |
duration | String (длительность displayValueв формате 'ч:м:с') | Нет | '' |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | SimpleDuration() |
---|
linenumbers | true |
---|
|
const durationOne = new SimpleDuration(3600);
const durationTwo = new SimpleDuration('00:30:00'); |
add(duration)
Используйте этот метод, чтобы добавить к текущему значению значение другого объекта SimpleDuration. Значение текущего объекта меняется. Также метод возвращает результат суммы в виде нового объекта SimpleDuration.
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
duration | SimpleDuration object | Да | Нет |
Возвращаемое значение:
TypeТип | Описание |
---|
SimpleDuration object | Сумма Метод возвращает сумму двух объектов SimpleDuration. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | add() |
---|
linenumbers | true |
---|
|
const durationOne = new SimpleDuration(3600);
const durationTwo = new SimpleDuration('00:30:00');
const totalDuration = durationOne.add(durationTwo);
ss.info(totalDuration.getDurationValue());
// Информация: 01:30:00 |
Этот метод возвращает значение продолжительности в заданном формате.
Параметры:
NameTypeТип | Обязательный | Значение по умолчанию |
---|
format | String | Нет | ' |
Г Ч Возвращаемое значение:
TypeСтрока Метод возвращает значение продолжительности в заданном формате. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getByFormat() |
---|
linenumbers | true |
---|
|
const datetime = new SimpleDateTime('2019-11-12 15:34:13');
const duration = new SimpleDuration(datetime.getNumericValue());
ss.info(duration.getByFormat('j F Y (D) H:i:s'));
// Информация: 12 November 2019 (Tue) 15:34:13 |
getDayPart()
Используйте этот метод, чтобы получить значение длительности, выраженное в количестве целых дней. Например, при длительности события в 2 дня 23:59:59 метод вернет значение значение '2'.
Возвращаемое значение:
Тип | Описание |
---|
Integer | Количество Метод возвращает количество дней. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getDayPart() |
---|
linenumbers | true |
---|
|
const duration = new SimpleDuration('02 01:30:00');
ss.info(duration.getDayPart());
// Информация: 2 |
getDisplayValue()
Используйте этот метод, чтобы получить количество дней, часов, минут и секунд из объекта SimpleDuration.
Возвращаемое значение:
Количество Метод возвращает количество дней, часов и минут. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getDisplayValue() |
---|
linenumbers | true |
---|
|
const duration = new SimpleDuration(3605);
ss.info(duration.getDisplayValue());
// Информация: 1 hour 5 seconds |
getDurationSeconds()
Этот метод возвращает Используйте этот метод, чтобы получить значение продолжительности в секундах.
Возвращаемое значение:
TypeТип | Описание |
---|
Integer | Значение Метод возвращает значение продолжительности в секундах. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getDurationSeconds() |
---|
linenumbers | true |
---|
|
const duration = new SimpleDuration('10:00:00');
ss.info(duration.getDurationSeconds());
//Информация: 36000 |
getDurationValue()
Используйте этот метод, чтобы получить значение из объекта SimpleDuration в формате 'д Чч:м:с'.
Возвращаемое значение:
TypeЗначение Метод возвращает значение продолжительности. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getDurationValue() |
---|
linenumbers | true |
---|
|
const duration = new SimpleDuration(7200);
ss.info(duration.getDurationValue());
// Информация: 02:00:00 |
getRoundedDayPart()
Этот метод возвращает Используйте этот метод, чтобы получить количество дней с учетом количества часов в объекте SimpleDuration. Если количество часов меньше 12, значение округляется в меньшую сторону. В противном случае значение округляется в большую сторону.
Возвращаемое значение:
Тип | Описание |
---|
Integer | Округленное Метод возвращает округленное количество дней. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getRoundedDayPart() |
---|
linenumbers | true |
---|
|
const duration = new SimpleDuration('5 12:52:22');
ss.info(duration.getRoundedDayPart());
// Информация: 6 |
getValue()
Этот Используйте метод возвращает , чтобы получить значение даты и времени во внутреннем формате.
Объекты SimpleDuration хранят продолжительность в виде даты и времени, начиная с 1 января 1970 года, 00:00:00.
Возвращаемое значение:
TypeТип | Описание |
---|
String | Строка длительности Метод возвращает значение продолжительности во внутреннем формате объекта. |
Пример 1:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getValue() |
---|
linenumbers | true |
---|
|
const duration = new SimpleDuration('10 15:00:00');
ss.info(duration.getValue());
// Информация: 1970-01-11 15:00:00 |
Пример 2:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getValue() |
---|
linenumbers | true |
---|
|
const myUserId = ss.getUserId();
const timestamp = Number(myUserId.slice(0, 10)); // Пользователь создан в
const duration = new SimpleDuration(timestamp);
ss.info(duration.getValue());
// Информация: 2019-05-31 14:02:39 |
setDisplayValue(duration)
Используйте этот метод, чтобы установить значение в формате 'д Чч:м:с'.
Параметр:
Название | Тип | Обязательный | Значение по умолчанию |
---|
duration | String | Да | Нет |
Возвращаемое значение:
TypeТип | Описание |
---|
Void | Этот метод Метод не возвращает значение. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | setDisplayValue() |
---|
linenumbers | true |
---|
|
const duration = new SimpleDuration();
duration.setDisplayValue('2 10:00:00');
ss.info(duration.getDisplayValue());
//Информация: 2 days 10 hours |
setValue(dateTime)
Используйте этот метод, чтобы установить значение в формате 'ГГГГГ-ММ-ДД ччч:ммм:ссс'.
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
dateTime | String | Да | Нет |
dateTime | SimpleDateTime object | Да | Нет |
Возвращаемое значение:
Тип | Описание |
---|
Void | Этот метод Метод не возвращает значение. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | setValue() |
---|
linenumbers | true |
---|
|
const durationOne = new SimpleDuration();
durationOne.setValue('2019-08-01 09:00:00');
ss.info(durationOne.getByFormat());
const durationTwo = new SimpleDuration();
durationTwo.setValue(new SimpleDateTime('2019-09-05 12:00:00'));
ss.info(durationTwo.getByFormat());
// Информация: 2019-08-01 09:00:00
// Информация: 2019-09-05 12:00:00 |
subtract(duration)
Этот метод вычитает Используйте этот метод, чтобы вычесть из текущего объекта SimpleDuration значения значение другого объекта SimpleDuration. Значение текущего объекта меняется. Также метод возвращает результат вычитания в виде нового объекта объекта SimpleDuration.
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
duration | SimpleDuration object | Да | Нет |
Возвращаемое значение:
Тип | Описание |
---|
SimpleDuration object | Объект Метод возвращает объект с результатом вычитания. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | subtract() |
---|
linenumbers | true |
---|
|
const durationOne = new SimpleDuration();
durationOne.setValue('2019-11-08 20:01:58');
const durationTwo = new SimpleDuration(3600);
const datetime = durationOne.subtract(durationTwo);
ss.info(datetime.getByFormat());
// Информация: 2019-11-08 19:01:58 |