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());
// Информация: 2022-02-28 00:00:00  

const tomorrowDatetime = new SimpleDateTime('tomorrow');
ss.info(tomorrowDatetime.getValue());
// Информация: 2022-03-02 00:00:00

const yesterdayWorkdayDayStart = new SimpleDateTime('yesterday 06:30');
ss.info(yesterdayWorkdayDayStart.getValue());
// Информация: 2022-02-28 06:30:00

const fistDayOfNextMonthStart = new SimpleDateTime('first day of next month 00:00');
ss.info(fistDayOfNextMonthStart.getValue());
// Информация: 2022-04-01 00:00:00

const rangeStartDatetime = new SimpleDateTime(`first day of ${monthName}`);
ss.info(rangeStartDatetime .getValue());
// Информация: 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);
// Информация: Февраль

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:00: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('2023-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	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)