Timestamp class

Timestamp представляет собой момент времени, не зависящий от часового пояса или календаря, представленный в секундах и долях секунды с наносекундным разрешением по времени UTC Epoch.

Он кодируется с использованием пролептического григорианского календаря, который расширяет григорианский календарь назад до первого года. При кодировании предполагается, что все минуты имеют продолжительность 60 секунд, т. е. секунды координации «размазаны», поэтому для интерпретации не требуется таблица дополнительных секунд. Диапазон от 0001-01-01T00:00:00Z до 9999-12-31T23:59:59.999999999Z.

Примеры и дополнительные характеристики см. в определении Timestamp. .

Подпись:

export declare class Timestamp 

Конструкторы

Конструктор Модификаторы Описание
(конструктор)(секунды, наносекунды) Создает новую метку времени.

Характеристики

Свойство Модификаторы Тип Описание
наносекунды число Доли секунды с наносекундным разрешением.*
секунды число Количество секунд времени UTC с эпохи Unix 1970-01-01T00:00:00Z.

Методы

Метод Модификаторы Описание
от даты (дата) static Создает новую временную метку с указанной даты.
fromMillis(миллисекунды) static Создает новую метку времени из заданного количества миллисекунд.
isEqual(другое) Возвращает true, если эта Timestamp равна предоставленной.
сейчас() static Создает новую метку времени с текущей датой с точностью до миллисекунды.
на сегодняшний день() Преобразует Timestamp в объект Date JavaScript. Это преобразование приводит к потере точности, поскольку объекты Date поддерживают только точность в миллисекундах.
toJSON() Возвращает сериализуемое в формате JSON представление этой Timestamp .
toМиллис() Преобразует Timestamp в числовую временную метку (в миллисекундах с начала эпохи). Эта операция приводит к потере точности.
toString() Возвращает текстовое представление этой Timestamp .
значениеOf() Преобразует этот объект в примитивную строку, которая позволяет сравнивать объекты Timestamp с помощью операторов > , <= , >= и > .

Временная метка.(конструктор)

Создает новую метку времени.

Подпись:

constructor(
    seconds: number, 
    nanoseconds: number);

Параметры

Параметр Тип Описание
секунды число Количество секунд времени UTC с эпохи Unix 1970-01-01T00:00:00Z. Должно быть от 0001-01-01T00:00:00Z до 9999-12-31T23:59:59Z включительно.
наносекунды число Неотрицательные доли секунды с наносекундным разрешением. Отрицательные значения секунд с дробями по-прежнему должны иметь неотрицательные значения наносекунд, которые отсчитываются вперед во времени. Должно быть от 0 до 999 999 999 включительно.

Метка времени.наносекунды

Доли секунды с наносекундным разрешением.*

Подпись:

readonly nanoseconds: number;

Метка времени.секунды

Количество секунд времени UTC с эпохи Unix 1970-01-01T00:00:00Z.

Подпись:

readonly seconds: number;

Временная метка.fromDate()

Создает новую временную метку с указанной даты.

Подпись:

static fromDate(date: Date): Timestamp;

Параметры

Параметр Тип Описание
дата Дата Дата инициализации Timestamp .

Возврат:

Временная метка

Новая Timestamp представляющая тот же момент времени, что и данная дата.

Временная метка.fromMillis()

Создает новую метку времени из заданного количества миллисекунд.

Подпись:

static fromMillis(milliseconds: number): Timestamp;

Параметры

Параметр Тип Описание
миллисекунды число Количество миллисекунд с эпохи Unix 1970-01-01T00:00:00Z.

Возврат:

Временная метка

Новая Timestamp , представляющая тот же момент времени, что и заданное количество миллисекунд.

Временная метка.isEqual()

Возвращает true, если эта Timestamp равна предоставленной.

Подпись:

isEqual(other: Timestamp): boolean;

Параметры

Параметр Тип Описание
другой Временная метка Timestamp для сравнения.

Возврат:

логическое значение

true, если эта Timestamp равна предоставленной.

Временная метка.сейчас()

Создает новую метку времени с текущей датой с точностью до миллисекунды.

Подпись:

static now(): Timestamp;

Возврат:

Временная метка

новая временная метка, представляющая текущую дату.

Временная метка.toDate()

Преобразует Timestamp в объект Date JavaScript. Это преобразование приводит к потере точности, поскольку объекты Date поддерживают только точность в миллисекундах.

Подпись:

toDate(): Date;

Возврат:

Дата

Объект JavaScript Date , представляющий тот же момент времени, что и эта Timestamp , с точностью до миллисекунды.

Временная метка.toJSON()

Возвращает сериализуемое в формате JSON представление этой Timestamp .

Подпись:

toJSON(): {
        seconds: number;
        nanoseconds: number;
    };

Возврат:

{ секунды: число; наносекунды: число; }

Временная метка.toMillis()

Преобразует Timestamp в числовую временную метку (в миллисекундах с начала эпохи). Эта операция приводит к потере точности.

Подпись:

toMillis(): number;

Возврат:

число

Момент времени, соответствующий этой временной метке, представленный как количество миллисекунд с эпохи Unix 1970-01-01T00:00:00Z.

Временная метка.toString()

Возвращает текстовое представление этой Timestamp .

Подпись:

toString(): string;

Возврат:

нить

Временная метка.valueOf()

Преобразует этот объект в примитивную строку, что позволяет сравнивать объекты Timestamp с помощью > , <= Операторы , >= и > .

Подпись:

valueOf(): string;

Возврат:

нить