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

new TDate(): TDate;
new TDate(year: number, month: number, day: number): TDate;

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

const date = new TDate(2022, 2, 24);
const newDate = date.addDate(0, 1, 5);

Обратите внимание, что тип TDate отличается от встроенного в JavaScript типа Date. Данный тип содержит только информацию о дате, без времени суток.

Hierarchy

  • TDate

Properties

Readonly day

day: number

День.

Пример использования:

const date = new TDate(2021, 1, 20);
const day = date.day;

Readonly month

month: number

Месяц.

Пример использования:

const date = new TDate(2021, 1, 20);
const month = date.month;

Readonly year

year: number

Год.

Пример использования:

const date = new TDate(2021, 1, 20);
const year = date.year;

Methods

addDate

  • addDate(years: number, month: number, days: number): TDate
  • Добавление даты.

    Пример использования:

    const date = new TDate(2021, 1, 20);
    const newDate = date.addDate(0, 1, 5);
    

    Parameters

    • years: number
    • month: number
    • days: number

    Returns TDate

after

  • Стоит ли дата позже заданной.

    Пример использования:

    const startDate = new TDate(2021, 1, 20);
    const endDate = new TDate(2021, 1, 21);
    const after = startDate.after(endDate); // false
    

    Parameters

    Returns boolean

afterOrEqual

  • Проверка, что текущая дата идёт после date или совпадает с этим значением.

    Пример использования:

    const startDate = new TDate(2021, 1, 20);
    const endDate = new TDate(2021, 1, 21);
    const equal = startDate.afterOrEqual(endDate); // false
    

    Parameters

    Returns boolean

asDatetime

  • Перевод в дату и время.

    Возвращает дату и время в указанном часовом поясе; если не указан — в текущем (по умолчанию часовой пояс компании).

    Пример использования:

    const date = new TDate(2021, 1, 20);
    const time = new TTime(3, 15, 0, 0);
    const datetime = date.asDatetime(time);
    

    Parameters

    Returns TDatetime

before

  • Стоит ли дата раньше заданной.

    Пример использования:

    const startDate = new TDate(2021, 1, 20);
    const endDate = new TDate(2021, 1, 21);
    const before = startDate.before(endDate); // true
    

    Parameters

    Returns boolean

beforeOrEqual

  • Проверка, что текущая дата идёт перед date или совпадает с этим значением.

    Пример использования:

    const startDate = new TDate(2021, 1, 20);
    const endDate = new TDate(2021, 1, 21);
    const equal = startDate.beforeOrEqual(endDate); // true
    

    Parameters

    Returns boolean

equal

  • Проверка на совпадение даты с заданной.

    Пример использования:

    const startDate = new TDate(2021, 1, 20);
    const endDate = new TDate(2021, 1, 21);
    const equal = startDate.equal(endDate); // false
    

    Parameters

    Returns boolean

format

  • format(format?: undefined | string): string
  • Приводит дату к нужному формату.

    По умолчанию используется формат YYYY-MM-DD:

    YYYY, y — год; MM — месяц с ведущим нулем; M — месяц без ведущим нулем; DD — день с ведущим нулем; D — день без ведущим нулем; d — день недели по счету.

    Пример использования:

    const date = new TDate(2021, 1, 20);
    const formatDate = date.format();
    

    Parameters

    • Optional format: undefined | string

    Returns string