Timestamp class

Timestamp reprezentuje punkt w czasie niezależny od strefy czasowej i kalendarza, wyrażony jako sekundy i ułamki sekund w rozdzielczości nanosekundy w czasie UTC.

Kod jest kodowany przy użyciu kalendarza proleptycznego gregoriańskiego, który powoduje rozszerzenie kalendarza gregoriańskiego wstecz do pierwszego roku. Jest zakodowany przy założeniu, że wszystkie minuty trwają 60 sekund, tzn.sekundy przestępne są „rozmywane”. więc do interpretacji nie jest potrzebna tabela drugiej przestępnej. Zakres wynosi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59.999999999Z.

Przykłady i dodatkowe specyfikacje znajdziesz w definicji sygnatury czasowej.

Podpis:

export declare class Timestamp

Zespoły

Zespół Modyfikatory Opis
(konstruktor)(sekundy, nanosekundy) Tworzy nową sygnaturę czasową.

Właściwości

Właściwość Modyfikatory Typ Opis
nanosekundy liczba Ułamki sekundy w rozdzielczości nanosekundy*.
sekundy liczba Liczba sekund czasu UTC od początku epoki uniksowej 1970-01-01T00:00:00Z.

Metody

Metoda Modyfikatory Opis
fromDate(date) static Tworzy nową sygnaturę czasową na podstawie podanej daty.
fromMillis(milisekundy) static Tworzy nową sygnaturę czasową z podanej liczby milisekund.
isEqual(other) Zwraca wartość „prawda”, jeśli ta wartość Timestamp jest równa podanej wartości.
now() static Tworzy nową sygnaturę czasową z bieżącą datą z dokładnością do milisekund.
toDate() Konwertuje obiekt Timestamp na obiekt Date JavaScript. Ta konwersja powoduje utratę precyzji, ponieważ obiekty Date obsługują tylko dokładność milisekund.
toJSON(), Zwraca możliwą do serializowania reprezentację tego elementu Timestamp w formacie JSON.
toMillis() Konwertuje parametr Timestamp na liczbową sygnaturę czasową (w milisekundach od początku epoki). Ta operacja powoduje utratę dokładności.
toString() Zwraca tekstową reprezentację wartości Timestamp.
valueOf(), Konwertuje ten obiekt na podstawowy ciąg znaków, co umożliwia porównywanie obiektów Timestamp za pomocą operatorów >, <=, >= i >.

Sygnatura czasowa.(konstruktor)

Tworzy nową sygnaturę czasową.

Podpis:

constructor(
    seconds: number, 
    nanoseconds: number);

Parametry

Parametr Typ Opis
sekundy liczba Liczba sekund czasu UTC od początku epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w przedziale od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z włącznie.
nanosekundy liczba Nieujemne ułamki sekundy w rozdzielczości nanosekundy. Ujemne wartości sekundowe ułamkowe muszą nadal mieć nieujemne wartości nanosekund, które są odliczane do przodu w czasie. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

timestamp.nanoseconds

Ułamki sekundy w rozdzielczości nanosekundy*.

Podpis:

readonly nanoseconds: number;

Sygnatura czasowa.sekundy

Liczba sekund czasu UTC od początku epoki uniksowej 1970-01-01T00:00:00Z.

Podpis:

readonly seconds: number;

timestamp.fromDate()

Tworzy nową sygnaturę czasową na podstawie podanej daty.

Podpis:

static fromDate(date: Date): Timestamp;

Parametry

Parametr Typ Opis
data Data Data inicjowania funkcji Timestamp.

Zwroty:

Sygnatura czasowa

Nowy obiekt Timestamp reprezentujący ten sam moment w czasie co podana data.

timestamp.fromMillis()

Tworzy nową sygnaturę czasową z podanej liczby milisekund.

Podpis:

static fromMillis(milliseconds: number): Timestamp;

Parametry

Parametr Typ Opis
milisekundy liczba Liczba milisekund od początku epoki uniksowej 1970-01-01T00:00:00Z.

Zwroty:

Sygnatura czasowa

Nowy element typu Timestamp reprezentujący ten sam punkt w czasie co podana liczba milisekund.

Timestamp.isEqual()

Zwraca wartość „prawda”, jeśli ta wartość Timestamp jest równa podanej wartości.

Podpis:

isEqual(other: Timestamp): boolean;

Parametry

Parametr Typ Opis
inne Sygnatura czasowa Timestamp do porównania.

Zwroty:

wartość logiczna

true (prawda), jeśli ta wartość Timestamp jest równa podanej wartości.

Sygnatura czasowa.now()

Tworzy nową sygnaturę czasową z bieżącą datą z dokładnością do milisekund.

Podpis:

static now(): Timestamp;

Zwroty:

Sygnatura czasowa

nową sygnaturę czasową reprezentującą bieżącą datę.

Timestamp.toDate()

Konwertuje obiekt Timestamp na obiekt Date JavaScript. Ta konwersja powoduje utratę precyzji, ponieważ obiekty Date obsługują tylko dokładność milisekund.

Podpis:

toDate(): Date;

Zwroty:

Data

Obiekt JavaScript Date reprezentujący ten sam punkt w czasie co Timestamp z dokładnością do milisekund.

Timestamp.toJSON()

Zwraca reprezentację tego elementu Timestamp w postaci serializacyjnej.

Podpis:

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

Zwroty:

{ seconds: number; nanoseconds: number;

timestamp.toMillis()

Konwertuje parametr Timestamp na liczbową sygnaturę czasową (w milisekundach od początku epoki). Ta operacja powoduje utratę dokładności.

Podpis:

toMillis(): number;

Zwroty:

liczba

Punkt w czasie odpowiadający tej sygnaturze czasowej wyrażony jako liczba milisekund od początku epoki uniksowej 1970-01-01T00:00:00Z.

Timestamp.toString()

Zwraca tekstową reprezentację wartości Timestamp.

Podpis:

toString(): string;

Zwroty:

ciąg znaków

timestamp.valueOf()

Konwertuje ten obiekt na podstawowy ciąg znaków, co umożliwia porównywanie obiektów Timestamp za pomocą operatorów >, <=, >= i >.

Podpis:

valueOf(): string;

Zwroty:

ciąg znaków