Timestamp class

تمثّل Timestamp نقطة زمنية مستقلة عن أي منطقة زمنية أو تقويم، ويتم تمثيلها كثواني وكسور من الثواني بدقة نانو ثانية حسب توقيت UTC.

حيث يتم ترميزه باستخدام التقويم الميلادي Proleptic الذي يوسع التقويم الميلادي إلى العام الأول. حيث يتم ترميزه على افتراض أن مدة كل الدقائق هي 60 ثانية، أي أن الثواني الكبيسة "ملطخة" بحيث لا تكون هناك حاجة إلى جدول القفزة الثانية للتفسير. النطاق من 0001-01-01T00:00:00Z إلى 9999-12-31T23:59:59.999999999Z.

للاطّلاع على أمثلة ومواصفات إضافية، يُرجى الرجوع إلى تعريف الطابع الزمني.

Signature:

export declare class Timestamp 

الشركات المصنِّعة

أماكن إقامة

الطُرق

الطابع الزمني (دالة الإنشاء)

تنشئ طابعًا زمنيًا جديدًا.

Signature:

constructor(
    seconds: number, 
    nanoseconds: number);

المَعلمات

الطابع الزمني.نانو ثانية

الكسور من الثانية بدقة نانو ثانية*

Signature:

readonly nanoseconds: number;

الطابع الزمني

عدد ثوانٍ التوقيت العالمي المنسّق (UTC) منذ حقبة Unix 1970-01-01T00:00:00Z.

Signature:

readonly seconds: number;

Timestamp.fromDate()

ينشئ طابعًا زمنيًا جديدًا من التاريخ المحدد.

Signature:

static fromDate(date: Date): Timestamp;

المَعلمات

المرتجعات:

الطابع الزمني

Timestamp جديد يمثّل النقطة الزمنية نفسها في التاريخ المحدّد.

Timetamp.fromMillis()

تنشئ هذه الدالة طابعًا زمنيًا جديدًا من العدد المحدّد من المللي ثانية.

Signature:

static fromMillis(milliseconds: number): Timestamp;

المَعلمات

المرتجعات:

الطابع الزمني

قيمة Timestamp جديدة تمثّل النقطة الزمنية نفسها كعدد محدد من المللي ثانية.

Timestamp.isEqual()

يتم عرض true إذا كانت قيمة Timestamp هذه تساوي القيمة المقدّمة.

Signature:

isEqual(other: Timestamp): boolean;

المَعلمات

المرتجعات:

قيمة منطقية

true إذا كانت قيمة Timestamp هذه تساوي القيمة المقدّمة.

Timetamp.now()

تُنشئ طابعًا زمنيًا جديدًا بالتاريخ الحالي بدقة بالمللي ثانية.

Signature:

static now(): Timestamp;

المرتجعات:

الطابع الزمني

طابع زمني جديد يمثل التاريخ الحالي.

Timestamp.toDate()

تحوِّل هذه الدالة Timestamp إلى كائن Date في JavaScript. تتسبّب هذه الإحالة الناجحة في فقدان الدقة لأنّ عناصر Date تتيح دقة المللي ثانية فقط.

Signature:

toDate(): Date;

المرتجعات:

التاريخ

يمثّل العنصر Date في JavaScript النقطة الزمنية نفسها التي يمثلها هذا Timestamp بدقة ملي ثانية.

Timestamp.toJSON()

تعرض تمثيلاً قابلاً للعرض بتنسيق JSON لهذا Timestamp.

Signature:

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

المرتجعات:

{ ثانية: رقم؛ نانو ثانية: رقم؛ }

Timestamp.toMillis()

تحوِّل Timestamp إلى طابع زمني رقمي (بالمللي ثانية منذ تاريخ بدء حساب الفترة). تتسبب هذه العملية في فقدان الدقة.

Signature:

toMillis(): number;

المرتجعات:

رقم

تمثّل هذه السمة النقطة الزمنية المقابلة لهذا الطابع الزمني، وتمثّلها عدد المللي ثانية منذ حقبة Unix 1970-01-01T00:00:00Z.

Timestamp.toString()

تعرض تمثيلاً نصيًا لـ Timestamp هذا.

Signature:

toString(): string;

المرتجعات:

السلسلة

Timetamp.valueOf()

تحوِّل هذا الكائن إلى سلسلة أساسية، ما يسمح بمقارنة كائنات Timestamp باستخدام العوامل > و<= و>= و>.

Signature:

valueOf(): string;

المرتجعات:

السلسلة