SimpleDateTime

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

SimpleDateTime(dateTime)

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

Параметры:

Пример:

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

addDays(days)

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

Параметры:

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

Пример:

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 в соответствии с локальной датой и временем. Положительное значение параметра добавляет месяцы к объекту, отрицательное значение уменьшает количество месяцев.

Параметры:

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

Пример:

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 в соответствии с локальной датой и временем. Положительное значение параметра добавляет секунды к объекту, отрицательное значение уменьшает количество секунд.

Параметры:

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

Пример:

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 в соответствии с локальной датой и временем. Положительное значение параметра добавляет недели к объекту, отрицательное значение уменьшает количество недель.

Параметры:

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

Пример:

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 в соответствии с локальной датой и временем. Положительное значение параметра добавляет года к объекту, отрицательное значение уменьшает количество лет.

Параметры:

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

Пример:

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‘ с текущей датой. 

Параметры:

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

Пример:

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‘ с текущей датой.

Параметры:

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

Пример:

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)

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

Параметры:

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

Пример:

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 с имеющимся значением, чтобы определить, совпадают ли они.

Параметры:

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

Пример:

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 в часовом поясе системы.

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

Пример:

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

getDayOfMonthLocalTime()

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

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

Пример:

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

getDayOfMonthUTC()

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

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

Пример:

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

getDayOfWeekLocalTime()

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

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

Пример:

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

getDayOfWeekUTC()

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

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

Пример:

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

getDaysInMonthLocalTime()

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

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

Пример:

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

getDaysInMonthUTC()

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

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

Пример:

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

getDisplayValue()

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

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

Пример:

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
ss.info(startDateTime.getDisplayValue()); // current user's timezone is Europe/Moscow
//Инфо: 2019-01-01 11:00:00 

getErrorMsg()

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

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

Пример:

const startDateTime = new SimpleDateTime('2019-zz-01 08:00:00');
ss.error(startDateTime.getErrorMsg());
//Error: DateTimeZone::getOffset() expects parameter 1 to be DateTimeInterface, null given

getLocalDate()

This method returns the date saved by the SimpleDateTime object in the current user's time zone.

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

Пример:

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

getLocalTime()

This method returns the time saved in a SimpleDateTime object in the current user's time zone .

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

Пример:

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
const time = startDateTime.getLocalTime();
ss.info( "My local time is " + time.getByFormat('h:i:s'));
//Info: My local time is 02:00:00

getMonthLocalTime()

This method returns the month saved by SimpleDateTime object in the current user's time zone.

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

Пример:

const startDateTime = new SimpleDateTime('2019-12-31 23:45:00');
ss.info(startDateTime.getMonthLocalTime());
//Info: January

getMonthUTC()

This method returns the month saved by SimpleDateTime object in the system time zone.

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

Пример:

const startDateTime = new SimpleDateTime('2019-12-31 23:45:00');
ss.info(startDateTime.getMonthUTC());
//Info: December

getNumericValue()

This method returns the Unix timestamp, which stores the amount of seconds since January 1, 1970, 00:00:00.

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

Пример:

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

getTime()

This method returns a SimpleDateTime object that shows the piece of time of the SimpleDateTime object.

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

Пример:

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
const time = startDateTime.getTime();
ss.info(time.getByFormat('h:i:s'));
//Info: 11:01:00

getValue()

This method returns the date and time value in the internal format.

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

Пример:

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

getWeekOfYearLocalTime()

This method returns the week's number saved by the SimpleDateTime object in the current user's time zone.

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

Пример:

const startDateTime = new SimpleDateTime('2019-12-31 23:45:00');
ss.info(startDateTime.getWeekOfYearLocalTime());
//Info: 1

getWeekOfYearUTC()

This method returns the number of the week saved by the SimpleDateTime object in the system time zone.

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

Пример:

const startDateTime = new SimpleDateTime('2019-12-31 23:45:00');
ss.info(startDateTime.getWeekOfYearUTC());
//Info: 1

getYearLocalTime()

This method returns the year saved by the SimpleDateTime object in the current user's time zone.

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

Пример:

const holidayDateTime = new SimpleDateTime('2019-12-31 23:45:00');
ss.info(holidayDateTime.getYearLocalTime());
//Info: 2020

getYearUTC()

This method returns the year saved by the SimpleDateTime object in the system time zone.

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

Пример:

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

isValid()

This method allows to determine if a specified value is a valid date and time.

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

Пример:

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

setValue(dateTime)

Use this method to define the date and time value within the SimpleDateTime object.

Параметры:

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

Пример:

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

subtract(first, second)

This method returns the amount of time between two SimpleDateTime values. Also, it can subtract the amount of time from the current SimpleDateTime object.

Параметры:

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

Пример:

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());
// Info: 388

Same example without using the 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);
// Info: 388

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

Same example without using the subtract:

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