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

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

Пример:

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

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

Пример:

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

getDaysInMonthLocalTime()

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

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

Пример:

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

getDaysInMonthUTC()

Данный метод возвращает количество дней в месяце, сохраненном объектом SimpleDateTime в часовом поясе 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()

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

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

Пример:

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

getLocalTime()

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

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

Пример:

const startDateTime = new SimpleDateTime('2019-01-01 08:00:00');
const time = startDateTime.getLocalTime();
ss.info( "Местное время " + time.getByFormat('h:i:s'));
//Инфо: Местное время 02:00:00

getMonthLocalTime()

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

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

Пример:

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

getMonthUTC()

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

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

Пример:

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

getNumericValue()

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

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

Пример:

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

getTime()

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

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

Пример:

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

getValue()

Этот метод возвращает значение даты и времени во внутреннем формате.

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

Пример:

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

getWeekOfYearLocalTime()

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

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

Пример:

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

getWeekOfYearUTC()

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

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

Пример:

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

getYearLocalTime()

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

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

Пример:

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

getYearUTC()

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

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

Пример:

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

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.

Параметры:

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

Пример:

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.

Параметры:

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

Пример 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:

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

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

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