Timestamp
نشان دهنده نقطه ای از زمان مستقل از هر منطقه زمانی یا تقویمی است که به صورت ثانیه و کسری از ثانیه با وضوح نانوثانیه در زمان UTC Epoch نمایش داده می شود.
با استفاده از تقویم گرگوری پرولپتیک کدگذاری شده است که تقویم میلادی را به عقب تا سال اول گسترش می دهد. با فرض اینکه تمام دقیقهها 60 ثانیه طول بکشند، کدگذاری میشود، یعنی ثانیههای کبیسه «لکهدار» شدهاند به طوری که برای تفسیر به جدول دوم کبیسه نیازی نیست. محدوده از 0001-01-01T00:00:00Z تا 9999-12-31T23:59:59.999999999Z است.
برای مثال و مشخصات بیشتر، به تعریف Timestamp مراجعه کنید .
امضا:
export declare class Timestamp
سازندگان
سازنده | اصلاح کننده ها | شرح |
---|---|---|
(سازنده) (ثانیه، نانوثانیه) | یک مهر زمانی جدید ایجاد می کند. |
خواص
ویژگی | اصلاح کننده ها | تایپ کنید | شرح |
---|---|---|---|
نانوثانیه | عدد | کسری از ثانیه در وضوح نانوثانیه.* | |
ثانیه | عدد | تعداد ثانیه های زمان UTC از زمان یونیکس 1970-01-01T00:00:00Z. |
مواد و روش ها
روش | اصلاح کننده ها | شرح |
---|---|---|
از تاریخ (تاریخ) | static | یک مهر زمانی جدید از تاریخ داده شده ایجاد می کند. |
از میلیس (میلی ثانیه) | static | یک مهر زمانی جدید از تعداد میلی ثانیه داده شده ایجاد می کند. |
برابر است (سایر) | اگر این Timestamp برابر با زمان ارائه شده باشد، درست برمیگردد. | |
اکنون() | static | یک مهر زمانی جدید با تاریخ فعلی، با دقت میلی ثانیه ایجاد می کند. |
به روز() | یک Timestamp به یک شیء Date جاوا اسکریپت تبدیل می کند. این تبدیل باعث از دست دادن دقت می شود زیرا اشیاء Date فقط از دقت میلی ثانیه پشتیبانی می کنند. | |
toJSON() | نمایشی قابل سریالسازی با JSON از این Timestamp را برمیگرداند. | |
toMillis() | یک Timestamp را به یک مهر زمانی عددی (بر حسب میلی ثانیه از دوره) تبدیل می کند. این عمل باعث از بین رفتن دقت می شود. | |
toString() | یک نمایش متنی از این Timestamp را برمیگرداند. | |
ارزش() | این شی را به یک رشته ابتدایی تبدیل میکند، که اجازه میدهد اشیاء Timestamp با استفاده از عملگرهای > ، <= ، >= و > مقایسه شوند. |
مهر زمانی. (سازنده)
یک مهر زمانی جدید ایجاد می کند.
امضا:
constructor(
seconds: number,
nanoseconds: number);
مولفه های
پارامتر | تایپ کنید | شرح |
---|---|---|
ثانیه | عدد | تعداد ثانیه های زمان UTC از زمان یونیکس 1970-01-01T00:00:00Z. باید از 0001-01-01T00:00:00Z تا 9999-12-31T23:59:59Z شامل باشد. |
نانوثانیه | عدد | کسرهای غیر منفی ثانیه در وضوح نانوثانیه. مقادیر دوم منفی با کسرها باید همچنان مقادیر نانوثانیهای غیر منفی داشته باشند که در زمان به جلو حساب میشوند. باید از 0 تا 999999999 باشد. |
مهر زمان. نانوثانیه
کسری از ثانیه در وضوح نانوثانیه.*
امضا:
readonly nanoseconds: number;
Timestamp.seconds
تعداد ثانیه های زمان UTC از زمان یونیکس 1970-01-01T00:00:00Z.
امضا:
readonly seconds: number;
Timestamp.fromDate()
یک مهر زمانی جدید از تاریخ داده شده ایجاد می کند.
امضا:
static fromDate(date: Date): Timestamp;
مولفه های
پارامتر | تایپ کنید | شرح |
---|---|---|
تاریخ | تاریخ | تاریخ برای مقداردهی اولیه Timestamp . |
برمی گرداند:
یک Timestamp
جدید که نشان دهنده همان نقطه زمانی تاریخ داده شده است.
Timestamp.fromMillis()
یک مهر زمانی جدید از تعداد میلی ثانیه داده شده ایجاد می کند.
امضا:
static fromMillis(milliseconds: number): Timestamp;
مولفه های
پارامتر | تایپ کنید | شرح |
---|---|---|
میلی ثانیه | عدد | تعداد میلی ثانیه از زمان یونیکس 1970-01-01T00:00:00Z. |
برمی گرداند:
یک Timestamp
جدید که نشان دهنده همان نقطه زمانی است که تعداد میلی ثانیه داده شده است.
Timestamp.isEqual()
اگر این Timestamp
برابر با زمان ارائه شده باشد، درست برمیگردد.
امضا:
isEqual(other: Timestamp): boolean;
مولفه های
پارامتر | تایپ کنید | شرح |
---|---|---|
دیگر | مهر زمان | Timestamp برای مقایسه با. |
برمی گرداند:
بولی
درست است اگر این Timestamp
برابر با زمان ارائه شده باشد.
Timestamp.now()
یک مهر زمانی جدید با تاریخ فعلی، با دقت میلی ثانیه ایجاد می کند.
امضا:
static now(): Timestamp;
برمی گرداند:
یک مهر زمانی جدید که نشان دهنده تاریخ فعلی است.
Timestamp.toDate()
یک Timestamp
به یک شیء Date
جاوا اسکریپت تبدیل می کند. این تبدیل باعث از دست دادن دقت می شود زیرا اشیاء Date
فقط از دقت میلی ثانیه پشتیبانی می کنند.
امضا:
toDate(): Date;
برمی گرداند:
تاریخ
شیء Date
جاوا اسکریپت که نشان دهنده همان نقطه زمانی این Timestamp
است ، با دقت میلی ثانیه
Timestamp.toJSON()
نمایشی قابل سریالسازی با JSON از این Timestamp
را برمیگرداند .
امضا:
toJSON(): {
seconds: number;
nanoseconds: number;
};
برمی گرداند:
{ ثانیه: عدد; نانوثانیه: عدد; }
Timestamp.toMillis()
یک Timestamp
را به یک مهر زمانی عددی (بر حسب میلی ثانیه از دوره) تبدیل می کند. این عمل باعث از بین رفتن دقت می شود.
امضا:
toMillis(): number;
برمی گرداند:
عدد
نقطه زمانی مربوط به این مهر زمانی، به عنوان تعداد میلی ثانیه از دوره یونیکس 1970-01-01T00:00:00Z نشان داده شده است.
Timestamp.toString()
یک نمایش متنی از این Timestamp
را برمیگرداند .
امضا:
toString(): string;
برمی گرداند:
رشته
Timestamp.valueOf()
این شی را به یک رشته ابتدایی تبدیل میکند، که اجازه میدهد اشیاء Timestamp
با استفاده از >
مقایسه شوند ، <=
عملگرهای >=
و >
.
امضا:
valueOf(): string;
برمی گرداند:
رشته