Timestamp은 시간대 또는 캘린더와는 별개로 특정 시점을 나타내며 UTC 에포크 시간 기준으로 나노초 단위의 초와 초 단위로 표현됩니다.
이 값은 그레고리력을 1년 역산하는 역산 그레고리력을 사용하여 인코딩됩니다. 인코딩 시 모든 분의 길이가 60초라고 가정합니다. 즉, 윤초는 '스미어(smear)' 처리되므로 해석을 위한 별도의 윤초 테이블이 필요하지 않습니다. 범위는 0001-01-01T00:00:00Z~9999-12-31T23:59:59.999999999Z입니다.
예시와 추가 사양은 타임스탬프 정의를 참고하세요.
서명:
export declare class Timestamp
생성자
| 생성자 | 특수키 | 설명 |
|---|---|---|
| (생성자)(초, 나노초) | 새 타임스탬프를 만듭니다. |
속성
| 속성 | 특수키 | 유형 | 설명 |
|---|---|---|---|
| 나노초 | 숫자 | 1초의 단위(나노초 단위)입니다.* | |
| 초 | 숫자 | Unix 에포크 1970-01-01T00:00:00Z 이후 UTC 시간(초)입니다. |
메소드
| 메서드 | 특수키 | 설명 |
|---|---|---|
| fromDate(날짜) | static |
지정된 날짜로부터 새 타임스탬프를 만듭니다. |
| fromMillis(밀리초) | static |
지정된 밀리초 단위로 새 타임스탬프를 만듭니다. |
| isEqual(기타) | 이 Timestamp가 제공된 항목과 같으면 true를 반환합니다. |
|
| now() | static |
현재 날짜(밀리초 단위)로 새 타임스탬프를 만듭니다. |
| toDate()를 사용하세요. | Timestamp을 JavaScript Date 객체로 변환합니다. Date 객체는 밀리초 정밀도만 지원하므로 이 변환으로 인해 정밀도가 저하됩니다. |
|
| JSON()으로 전송합니다. | 이 Timestamp의 JSON 직렬화 가능한 표현을 반환합니다. |
|
| toMillis() | Timestamp을 숫자 타임스탬프 (에포크 이후 밀리초 단위)로 변환합니다. 이 연산은 정밀도가 떨어집니다. |
|
| toString()으로 호출하세요. | 이 Timestamp의 텍스트 표현을 반환합니다. |
|
| valueOf() | 이 객체를 원시 문자열로 변환합니다. 이렇게 하면 >, <=, >=, > 연산자를 사용하여 Timestamp 객체를 비교할 수 있습니다. |
Timestamp.(생성자)
새 타임스탬프를 만듭니다.
서명:
constructor(
seconds: number,
nanoseconds: number);
매개변수
| 매개변수 | 유형 | 설명 |
|---|---|---|
| 초 | 숫자 | Unix 에포크 1970-01-01T00:00:00Z 이후 UTC 시간(초)입니다. 0001-01-01T00:00:00Z에서 9999-12-31T23:59:59Z까지여야 합니다. |
| 나노초 | 숫자 | 나노초 단위의 음수가 아닌 초수입니다. 분수가 있는 음의 초 값은 시간을 미래로 계산하는 음수가 아닌 나노초 값을 가져야 합니다. 범위는 0~999,999,999(포함)이어야 합니다. |
타임스탬프.나노초
1초의 단위(나노초 단위)입니다.*
서명:
readonly nanoseconds: number;
타임스탬프.초
Unix 에포크 1970-01-01T00:00:00Z 이후 UTC 시간(초)입니다.
서명:
readonly seconds: number;
Timestamp.fromDate()
지정된 날짜로부터 새 타임스탬프를 만듭니다.
서명:
static fromDate(date: Date): Timestamp;
매개변수
| 매개변수 | 유형 | 설명 |
|---|---|---|
| 날짜 | 날짜 | Timestamp를 초기화할 날짜입니다. |
반환:
지정된 날짜와 동일한 시점을 나타내는 새 Timestamp입니다.
Timestamp.fromMillis()
지정된 밀리초 단위로 새 타임스탬프를 만듭니다.
서명:
static fromMillis(milliseconds: number): Timestamp;
매개변수
| 매개변수 | 유형 | 설명 |
|---|---|---|
| 밀리초 | 숫자 | Unix 에포크 1970-01-01T00:00:00Z 이후의 밀리초 수입니다. |
반환:
지정된 밀리초 수와 동일한 시점을 나타내는 새 Timestamp입니다.
타임스탬프.isEqual()
이 Timestamp가 제공된 항목과 같으면 true를 반환합니다.
서명:
isEqual(other: Timestamp): boolean;
매개변수
| 매개변수 | 유형 | 설명 |
|---|---|---|
| 기타 | 타임스탬프 | 비교할 Timestamp입니다. |
반환:
부울
이 Timestamp가 제공된 항목과 같으면 true입니다.
Timestamp.now()
현재 날짜(밀리초 단위)로 새 타임스탬프를 만듭니다.
서명:
static now(): Timestamp;
반환:
현재 날짜를 나타내는 새 타임스탬프.
Timestamp.toDate()
Timestamp을 JavaScript Date 객체로 변환합니다. Date 객체는 밀리초 정밀도만 지원하므로 이 변환으로 인해 정밀도가 저하됩니다.
서명:
toDate(): Date;
반환:
날짜
이 Timestamp와 동일한 시점을 밀리초 단위로 나타내는 JavaScript Date 객체입니다.
Timestamp.toJSON()
이 Timestamp의 JSON 직렬화 가능한 표현을 반환합니다.
서명:
toJSON(): {
seconds: number;
nanoseconds: number;
};
반환:
{ 초: 숫자; 나노초: number; }
Timestamp.toMillis()
Timestamp을 숫자 타임스탬프 (에포크 이후 밀리초 단위)로 변환합니다. 이 연산은 정밀도가 떨어집니다.
서명:
toMillis(): number;
반환:
숫자
이 타임스탬프에 해당하는 시점으로, Unix 에포크 1970-01-01T00:00:00Z 이후 밀리초 단위로 표시됩니다.
Timestamp.toString()
이 Timestamp의 텍스트 표현을 반환합니다.
서명:
toString(): string;
반환:
문자열
Timestamp.valueOf()
이 객체를 원시 문자열로 변환합니다. 이렇게 하면 >, <=, >=, > 연산자를 사용하여 Timestamp 객체를 비교할 수 있습니다.
서명:
valueOf(): string;
반환:
문자열