TTime

Время

Хранит в себе время, не превышающее 24 часа.

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

new TTime(): TTime;
new TTime(duration: TDuration): TTime;
new TTime(hours: number, minutes: number, seconds: number, milliseconds: number): TTime;

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

const time = new TTime(3, 15, 0, 0);
const newTime = time.add(2, 15, 0, 0);
newTime.after(time); // true

Hierarchy

  • TTime

Properties

Readonly hours

hours: number

Количество часов.

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

const time = new TTime(3, 15, 0, 0);
const hours = time.hours;

Readonly milliseconds

milliseconds: number

Количество миллисекунд.

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

const time = new TTime(3, 15, 0, 0);
const milliseconds = time.milliseconds;

Readonly minutes

minutes: number

Количество минут.

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

const time = new TTime(3, 15, 0, 0);
const minutes = time.minutes;

Readonly seconds

seconds: number

Количество секунд.

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

const time = new TTime(3, 15, 0, 0);
const seconds = time.seconds;

Methods

add

  • Добавление времени.

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

    const time = new TTime(3, 15, 0, 0);
const duration = new Duration(100, 'millisecond');
const newTime = time.add(duration);

    Если добавить больше 24 часов, то время будет отсчитываться заново с 00:00.

    Parameters

    Returns TTime

after

  • Стоит ли время позже заданного.

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

    const startTime = new TTime(3, 15, 0, 0);
const endTime = new TTime(5, 30, 0, 0);
const after = startTime.after(endTime); // false

    Parameters

    Returns boolean

afterOrEqual

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

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

    const startTime = new TTime(3, 15, 0, 0);
const endTime = new TTime(5, 30, 0, 0);
const before = startTime.afterOrEqual(endTime); // false

    Parameters

    Returns boolean

asDatetime

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

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

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

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

    Parameters

    Returns TDatetime

before

  • Стоит ли время раньше заданного.

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

    const startTime = new TTime(3, 15, 0, 0);
const endTime = new TTime(5, 30, 0, 0);
const before = startTime.before(endTime); // true

    Parameters

    Returns boolean

beforeOrEqual

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

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

    const startTime = new TTime(3, 15, 0, 0);
const endTime = new TTime(5, 30, 0, 0);
const before = startTime.beforeOrEqual(endTime); // true

    Parameters

    Returns boolean

equal

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

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

    const startTime = new TTime(3, 15, 0, 0);
const endTime = new TTime(5, 30, 0, 0);
const equal = startTime.equal(endTime); // false

    Parameters

    Returns boolean

format

  • format(format?: undefined | string): string

  • Приводит время к нужному формату.

    По умолчанию используется формат HH:mm:ss:

    • HH — часы в 24-часовой системе;
    • hh — часы в 12-часовой системе;
    • mm — минуты;
    • ss — секунды;
    • SSS — миллисекунды.

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

    const time = new TTime(13, 15, 0, 0);
const formatTime = time.format('hh mm'); //1pm 15

    Parameters

    • Optional format: undefined | string

    Returns string