SimpleDateTime

Используйте этот класс для выполнения операций с объектами SimpleDateTime, например для создания экземпляров объектов, а также для расчета, изменения форматов даты и времени или преобразования между форматами.

SimpleDateTime(dateTime)

Используйте этот конструктор для создания экземпляра нового объекта SimpleDateTime с текущими или переданными значениями дата/время. Объект хранит данные о дате и времени в UTC, поэтому перед передачей этих параметров убедитесь, что они в этом часовом поясе, чтобы избежать ошибки.

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
dateTime	String	Нет	''

Пример:

SimpleDateTime

const nowDateTime = new SimpleDateTime();
//
const registrationDateTime = new SimpleDateTime(record.registration_datetime);
//
const yearStartDateTime = new SimpleDateTime('2019-01-01 00:00:00');

Вы также можете использовать значения дат в относительном формате для конструктора SimpleDateTime. Все форматы доступны в статье Относительные форматы.

SimpleDateTime

const yesterdayDatetime = new SimpleDateTime('yesterday');
ss.info(yesterdayDatetime.getValue());
// Info: 2022-02-28 00:00:00  

const tomorrowDatetime = new SimpleDateTime('tomorrow');
ss.info(tomorrowDatetime.getValue());
// Info: 2022-03-02 00:00:00

const yesterdayWorkdayDayStart = new SimpleDateTime('yesterday 06:30');
ss.info(yesterdayWorkdayDayStart.getValue());
// Info: 2022-02-28 06:30:00

const fistDayOfNextMonthStart = new SimpleDateTime('first day of next month 00:00');
ss.info(fistDayOfNextMonthStart.getValue());
// Info: 2022-04-01 00:00:00

const rangeStartDatetime = new SimpleDateTime(`first day of ${monthName}`);
ss.info(rangeStartDatetime .getValue());
// Info: 2022-02-01 00:00:00

const YEAR = 2022;
const MONTH = 2;
const monthDatetime = new SimpleDateTime(`${YEAR}-${String(MONTH).padStart(2, '0')}-02 00:00:00`);
const monthName = monthDatetime.getMonthUTC();
ss.info(monthName);
// Info: February

addDays(days)

Этот метод используется для изменения числа в объекте SimpleDateTime относительно его текущей даты и времени. Положительное значение параметра добавляет дни к текущей дате, отрицательное значение параметра позволяет использовать дату с более ранним числом.

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
days	integer	Да	Нет

Возвращаемое значение:

Тип	Описание
Void	Данный метод не возвращает знаение.

Пример:

addDays

const registrationDateTime = new SimpleDateTime('2019-01-01 08:12:10');
registrationDateTime.addDays(3);
ss.info(registrationDateTime.getValue());
//Инфо: 2019-01-04 08:12:10

addMonths(months)

Используйте этот метод, чтобы изменить месяц в текущем объекте SimpleDateTime относительно его текущей даты и времени. Положительное значение параметра меняет месяц на более поздний, отрицательное значение – на более ранний.

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
months	Integer	Да	Нет

Возвращаемое значение:

Тип	Описание
Void	Данный метод не возвращает значение.

Пример:

addMonths

const registrationDateTime = new SimpleDateTime('2019-01-01 08:12:10');
registrationDateTime.addMonths(-1);
ss.info(registrationDateTime.getValue());
//Инфо: 2018-12-01 08:12:10

addSeconds(seconds)

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

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
seconds	Integer	Да	Нет

Возвращаемое значение:

Тип	Описание
Void	Данный метод не возвращает значение.

Пример:

addSeconds

const registrationDateTime = new SimpleDateTime('2019-01-01 08:12:10');
registrationDateTime.addSeconds(3600);
ss.info(registrationDateTime.getValue());
//Инфо: 2019-01-01 09:12:10

addWeeks(weeks)

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

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
weeks	Integer	Да	Нет

Возвращаемое значение:

Тип	Описание
Void	Данный метод не возвращает значение.

Пример:

addWeeks

const registrationDateTime = new SimpleDateTime('2019-01-01 08:12:10');
registrationDateTime.addWeeks(1);
ss.info(registrationDateTime.getValue());
//Инфо: 2019-01-08 08:12:10

addYears(years)

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

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
years	Integer	Да	Нет

Возвращаемое значение:

Тип	Описание
Void	Данный метод не возвращает значение.

Пример:

addYears

const contractStartDateTime = new SimpleDateTime('2019-01-01 00:00:00');
contractStartDateTime.addYears(1);
ss.info(contractStartDateTime.getValue());
//Инфо: 2020-01-01 00:00:00

after(dateTime)

Используйте этот метод, чтобы определить, следует ли текущая дата после даты, указанной в dateTime.

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
dateTime	SimpleDateTime object	Да	Нет

Возвращаемое значение:

Тип	Описание
Boolean	Метод возвращает true, если текущая дата позднее заданной в параметре или равна ей. Если текущая дата раньше указанной в параметре, метод возвращает false.

Пример:

after

const startDateTime = new SimpleDateTime('2018-01-01 07:58:35');
const endDateTime = new SimpleDateTime('2019-01-01 08:00:00');
const isStartAfterThanEnd = startDateTime.after(endDateTime);
ss.info(isStartAfterThanEnd);
//Инфо: false

before(dateTime)

Данный метод позволяет определить, предшествует ли текущая дата указанной дате в dateTime.

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
dateTime	SimpleDateTime object	Да	Нет

Возвращаемое значение:

Тип	Описание
Boolean	Метод возвращает true, если текущая дата предшествует заданной в параметре или равна ей. Если текущая дата позже указанной в параметре, метод возвращает false.

Пример:

before

const startDateTime = new SimpleDateTime('2018-01-01 07:58:35');
const endDateTime = new SimpleDateTime('2019-01-01 08:00:00');
const isStartBeforeEnd = startDateTime.before(endDateTime);
ss.info(isStartBeforeEnd);
//Инфо: true

compareTo(dateTime)

Этот метод сравнивает два объекта даты и времени, чтобы определить, равны ли они. Если нет, метод определяет их порядок.

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
dateTime	SimpleDateTime object	Да	Нет

Возвращаемое значение:

Тип	Описание
0	Даты совпадают
1	Дата объекта идет после даты, указанной в параметре.
-1	Дата объекта предшествует дате, указанной в параметре.

Пример:

compareTo

const begin = new SimpleDateTime('2019-04-01 08:15:00');
const end = new SimpleDateTime('2019-05-01 01:00:00');

ss.info(begin.compareTo(end));   // -1
ss.info(end.compareTo(begin));   // 1
ss.info(begin.compareTo(begin)); // 0

equals(dateTime)

Используйте этот метод, чтобы сравнить значение dateTime с текущей датой объекта, чтобы определить, совпадают ли они.

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
dateTime	SimpleDateTime object.	Да	Нет

Возвращаемое значение:

Тип	Описание
Boolean	Метод возвращает true, если даты совпадают; если даты различаются, метод возвращает значение false.

Пример:

equals

const firstDateTime = new SimpleDateTime('2018-01-01 08:00:00');
const secondDateTime = new SimpleDateTime('2018-01-01 08:15:00');
const thirdDateTime = new SimpleDateTime('2018-01-01 08:00:00');

ss.info(firstDateTime.equals(secondDateTime));
ss.info(thirdDateTime.equals(firstDateTime));
//Инфо: false
//Инфо: true

getDate()

Этот метод возвращает дату, сохраненную в объекте SimpleDateTime в часовом поясе UTC.

Возвращаемое значение:

Тип	Описание
String	Дата в часовом поясе UTC

Пример:

getDate

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
ss.info(startDateTime.getDate());
//Инфо: 2019-01-01

getDayOfMonthLocalTime()

Этот метод возвращает день месяца, сохраненный объектом SimpleDateTime в часовом поясе текущего пользователя.

Возвращаемое значение:

Тип	Описание
Integer	День месяца

Пример:

getDaysofMonthsLocalTime

const holidayDateTime = new SimpleDateTime('2019-01-07 08:00:00');
ss.info(holidayDateTime.getDayOfMonthLocalTime());
//Инфо: 7

getDayOfMonthUTC()

Этот метод возвращает день месяца, сохраненный объектом SimpleDateTime в часовом поясе UTC.

Возвращаемое значение:

Тип	Описание
Integer	День месяца

Пример:

getDayOfMonthUTC

const holidayDateTime = new SimpleDateTime('2019-01-07 08:00:00');
ss.info(holidayDateTime.getDayOfMonthUTC());
//Инфо: 7

getDayOfWeekLocalTime()

Данный метод возвращает день недели, сохраненный объектом SimpleDateTime, в часовом поясе текущего пользователя.

Возвращаемое значение:

Тип	Описание
String	Значение дня недели. Возможные значения: 'Пнд', 'Вт', 'Ср', 'Чт', 'Пт', 'Сб', 'Вск'.

Пример:

getDayOfWeekLocalTime

const holidayDateTime = new SimpleDateTime('2019-01-07 08:00:00');
ss.info(holidayDateTime.getDayOfWeekLocalTime()); // Пнд

getDayOfWeekUTC()

Данный метод возвращает день недели, сохраненный объектом SimpleDateTime в часовом поясе UTC.

Возвращаемое значение:

Тип	Описание
String	Значение дня недели. Возможные значения: 'Пнд', 'Вт', 'Ср', 'Чт', 'Пт', 'Сб', 'Вск'.

Пример:

getDayOfWeekUTC

const holidayDateTime = new SimpleDateTime('2019-01-07 08:00:00');
ss.info(holidayDateTime.getDayOfWeekUTC());
//Инфо: Пнд

getDaysInMonthLocalTime()

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

Возвращаемое значение:

Тип	Описание
Integer	Количество дней в месяце

Пример:

getDaysInMonthLocalTime

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
ss.info(startDateTime.getDaysInMonthLocalTime());
//Инфо: 31

getDaysInMonthUTC()

Данный метод возвращает количество дней в месяце, сохраненном объектом SimpleDateTime в часовом поясе UTC.

Возвращаемое значение:

Тип	Описание
Integer	Количество дней в месяце

Пример:

getDaysInMonthUTC

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
ss.info(startDateTime.getDaysInMonthUTC());
//Инфо: 31

getDisplayValue()

Данный метод возвращает значения даты и времени в часовом поясе и отображаемом формате текущего пользователя.

Возвращаемое значение:

Тип	Описание
String	Значение даты и времени

Пример:

getDisplayValue

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
ss.info(startDateTime.getDisplayValue()); // Часовой пояс текущего пользователя Europe/Moscow
//Инфо: 2019-01-01 11:00:00

getErrorMsg()

Данный метод возвращает сообщение об обшибке, если объект SimpleDateTime был некорректным.

Возвращаемое значение:

Тип	Описание
String	Сообщение об ошибке

Пример:

getErrorMsg

const startDateTime = new SimpleDateTime('2019-zz-01 08:00:00');
ss.error(startDateTime.getErrorMsg());
//Ошибка: Анализ даты и времени выявил ошибку!

getLocalDate()

Метод возвращает дату, сохраненную объектом SimpleDateTime, в часовом поясе текущего пользователя.

Возвращаемое значение:

Тип	Описание
String	Дата в часовом поясе пользователя

Пример:

getLocalDate

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
ss.info(startDateTime.getLocalDate());
//Инфо: 2019-01-01

getLocalTime()

Данный метод возвращает время, сохраненное объектом SimpleDateTime, в часовом поясе текущего пользователя.

Возвращаемое значение:

Тип	Описание
SimpleTime	Время в часовом поясе пользователя

Пример:

getLocalTime

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
const time = startDateTime.getLocalTime();
ss.info( "Местное время " + time.getValue()); // Часовой пояс текущего пользователя Europe/Moscow
//Инфо: Местное время 11:00:00.

getMonthLocalTime()

Метод возвращает месяц, сохраненный объектом SimpleDateTime, в часовом поясе текущего пользователя.

Возвращаемое значение:

Тип	Описание
String	Название месяца

Пример:

getMonthLocalTime

const startDateTime = new SimpleDateTime('2019-12-31 23:45:00');
ss.info(startDateTime.getMonthLocalTime());
//Инфо: Январь

getMonthUTC()

Метод возвращает значение месяца, сохраненное объектом SimpleDateTime, в часовом поясе UTC.

Возвращаемое значение:

Тип	Описание
String	Название месяца

Пример:

getMonthUTC

const startDateTime = new SimpleDateTime('2019-12-31 23:45:00');
ss.info(startDateTime.getMonthUTC());
//Инфо: Декабрь

getNumericValue()

Этот метод возвращает временную метку Unix, в которой хранится количество секунд с 1 января 1970, 00:00:00.

Возвращаемое значение:

Тип	Описание
Integer	Значение временной метки Unix

Пример:

getNumericValue

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
ss.info(startDateTime.getNumericValue());
//Инфо: 1546329600

getTime()

Метод возвращает объект SimpleTime, который показывает значение времени объекта SimpleDateTime.

Возвращаемое значение:

Тип	Описание
SimpleTime	Время в часовом поясе UTC

Пример:

getTime

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
const time = startDateTime.getTime();
ss.info(time.getValue());
//Инфо: 08:01:00

getValue()

Этот метод возвращает значение даты и времени в часовом поясе UTC.

Возвращаемое значение:

Тип	Описание
null \| string	Значение даты и времени во внутреннем формате

Пример:

getValue

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
ss.info(startDateTime.getValue()); // 2019-01-01 08:00:00

getWeekOfYearLocalTime()

Данный метод возвращает порядковый номер недели, сохраненный объектом SimpleDateTime в часовом поясе текущего пользователя.

Возвращаемое значение:

Тип	Описание
Integer	Номер текущей недели

Пример:

getWeekOfYearLocalTime

const startDateTime = new SimpleDateTime('2022-12-31 23:45:00');
ss.info(startDateTime.getWeekOfYearLocalTime()); // Часовой пояс текущего пользователя Europe/Moscow 
//Инфо: 1

getWeekOfYearUTC()

Этот метод возвращает номер недели, сохраненный объектом SimpleDateTime в часовом поясе UTC.

Возвращаемое значение:

Тип	Описание
Integer	Номер текущей недели

Пример:

getWeekOfYearUTC

const startDateTime = new SimpleDateTime('2023-12-31 23:45:00');
ss.info(startDateTime.getWeekOfYearUTC()); 
//Инфо: 52

getYearLocalTime()

Метод возвращает значение года, сохраненное объектом SimpleDateTime в часовом поясе текущего пользователя.

Возвращаемое значение:

Тип	Описание
Integer	Четырехзначное значение года

Пример:

getYearLocalTime

const holidayDateTime = new SimpleDateTime('2019-12-31 23:45:00');
ss.info(holidayDateTime.getYearLocalTime()); // Часовой пояс текущего пользователя Europe/Moscow  
//Инфо: 2020

getYearUTC()

Метод возвращает значение года, сохраненное объектом SimpleDateTime в часовом поясе UTC.

Возвращаемое значение:

Тип	Описание
Integer	Четырехзначное значение года

Пример:

getYearUTC

const holidayDateTime = new SimpleDateTime('2019-12-31 23:45:00');
ss.info(holidayDateTime.getYearUTC()); 
//Инфо: 2019

isValid()

Используйте этот метод, чтобы определить, является ли допустимым указанное значение даты и времени.

Возвращаемое значение:

Тип	Описание
Boolean	Метод возвращает true, если значение даты и времени допустимо; если нет, то метод возвращает false.

Пример:

isValid

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
startDateTime.setValue('2011-aa-01 00:00:00');
ss.info(startDateTime.isValid());
//Инфо: false

setValue(dateTime)

Используйте этот метод для определения значения даты и времени в объекте SimpleDateTime.

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
dateTime	Строка в часовом поясе UTC и внутреннем формате ГГГГ-ММ-ДД чч:мм:сс.	Да	Нет

Возвращаемое значение:

Тип	Описание
Void	Метод не возвращает значение.

Пример:

setValue

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
startDateTime.setValue('2020-01-01 12:00:00');
ss.info(startDateTime.getValue());
//Инфо: 2020-01-01 12:00:00

subtract(first, second)

Этот метод возвращает количество времени между двумя значениями SimpleDateTime. Кроме того, он может вычесть количество времени из текущего объекта SimpleDateTime.

Метод getDisplayValue() возвращает значение в часовом поясе текущего пользователя. Метод getValue() возвращает данные только в часовом поясе UTC.

Параметры:

Название	Тип	Обязательный	Значение по умолчанию
first	SimpleDateTime Object / Integer	Да	Нет
second	SimpleDateTime Object	Нет	NULL

Возвращаемое значение:

Тип
Объект SimpleDuration или null

Пример 1:

subtract #1

const startDatetime = new SimpleDateTime('2019-11-08 20:00:00');
const endDatetime = new SimpleDateTime('2019-11-08 20:06:28');
const diffDuration = new SimpleDateTime().subtract(startDatetime, endDatetime); 
ss.info(diffDuration.getDurationSeconds());
// Инфо: 388

Тот же пример без использования метода subtract:

const startDatetime = new SimpleDateTime('2019-11-08 20:00:00');
const endDatetime = new SimpleDateTime('2019-11-08 20:06:28');
const diffSeconds = endDatetime.getNumericValue() - startDatetime.getNumericValue(); 
ss.info(diffSeconds);
// Инфо: 388

Пример 2:

subtract #2

const datetime = new SimpleDateTime('2020-08-28 09:00:00');
datetime.subtract(3600);
ss.info(datetime.getValue());
//Инфо: 2020-08-28 08:00:00

Тот же пример без использования метода subtract:

subtract #2

const datetime = new SimpleDateTime('2020-08-28 09:00:00');
datetime.addSeconds(-3600);
ss.info(datetime.getValue());
//Инфо: 2020-08-28 08:00:00

Page tree

SimpleDateTime

SimpleDateTime(dateTime)

addDays(days)

addMonths(months)

addSeconds(seconds)

addWeeks(weeks)

addYears(years)

after(dateTime)

before(dateTime)

compareTo(dateTime)

equals(dateTime)

getDate()

getDayOfMonthLocalTime()

getDayOfMonthUTC()

getDayOfWeekLocalTime()

getDayOfWeekUTC()

getDaysInMonthLocalTime()

getDaysInMonthUTC()

getDisplayValue()

getErrorMsg()

getLocalDate()

getLocalTime()

getMonthLocalTime()

getMonthUTC()

getNumericValue()

getTime()

getValue()

getWeekOfYearLocalTime()

getWeekOfYearUTC()

getYearLocalTime()

getYearUTC()

isValid()

setValue(dateTime)

subtract(first, second)