Важно: для инициализации Datetime не следует использовать объект JavaScript Date.

Имеет конструкторы:

new Datetime(value: string, format?: string): TDatetime;
new Datetime(value: number) : TDatetime;
new Datetime(year: number, month: number, day?: number, hours?: number, minutes?: number, seconds?: number, ms?: number): TDatetime;

Примеры создания объектов даты-времени:

const now = new Datetime();
const datetime1 = new Datetime(2022, 2, 24, 9, 0, 0, 0);
const datetime2 = new Datetime(1645686000);
const datetime3 = new Datetime('2022-02-24');
const datetime4 = new Datetime('2022-02-24T00:00:00.000Z');
const datetime5 = new Datetime('24.02.2022', 'DD.MM.YYYY');

Если в конструкторе записывать дату как строку и не указывать формат, то по умолчанию значение проверяется на соответствие формату YYYY-MM-DDTHH:mm:ss.SSSZ. Поэтому задавать значение можно как:

• 2021-01
• 2021-01-23
• 2021-01-21T08:30 и т. д.

Значения этого типа неизменяемые, так что методы мутации возвращают обновлённое значение, не меняя исходного.

const now = new Datetime();
const yesterday = now.addDate(0, 0, -1);

now.after(yesterday) // true

Чтобы все расчёты в скрипте проходили в часовом поясе пользователя, нужно это явно указать, задав текущую временную зону:

// Получаем нужного пользователя для расчетов
const user = ...;
// Устанавливаем временную зону для всех дальнейших вычислений в скрипте
System.timezones.current = user.timezone;
const today_22_00 = Context.data.datavremya.getDate().asDatetime(new TTime(22, 0, 0, 0));