Timestamp class

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

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

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

Signature:

export declare class Timestamp

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

الشركة المصنِّعة المعدِّلات الوصف
(دالة الإنشاء)(ثوان، نانو ثانية) تنشئ طابعًا زمنيًا جديدًا.

أماكن إقامة

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

الطُرق

الطريقة المعدِّلات الوصف
fromDate(date) static ينشئ طابعًا زمنيًا جديدًا من التاريخ المحدد.
fromMillis(ملي ثانية) static تنشئ هذه الدالة طابعًا زمنيًا جديدًا من العدد المحدّد من المللي ثانية.
isEqual(other) يتم عرض true إذا كانت قيمة Timestamp هذه تساوي القيمة المقدّمة.
now() static تُنشئ طابعًا زمنيًا جديدًا بالتاريخ الحالي بدقة بالمللي ثانية.
toDate() تحوِّل هذه الدالة Timestamp إلى كائن Date في JavaScript. تتسبّب هذه الإحالة الناجحة في فقدان الدقة لأنّ عناصر Date تتيح دقة المللي ثانية فقط.
toJSON() تعرض تمثيلاً قابلاً للعرض بتنسيق JSON لهذا Timestamp.
toMillis() تحوِّل Timestamp إلى طابع زمني رقمي (بالمللي ثانية منذ تاريخ بدء حساب الفترة). تتسبب هذه العملية في فقدان الدقة.
toString() تعرض تمثيلاً نصيًا للسمة Timestamp هذه.
valueOf() تحوِّل هذا الكائن إلى سلسلة أساسية، ما يسمح بمقارنة كائنات Timestamp باستخدام العوامل > و<= و>= و>.

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

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

Signature:

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 (ضمنًا).

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

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

Signature:

readonly nanoseconds: number;

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

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

Signature:

readonly seconds: number;

Timestamp.fromDate()

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

Signature:

static fromDate(date: Date): Timestamp;

المَعلمات

المعلمة النوع الوصف
التاريخ التاريخ تاريخ إعداد Timestamp منه.

المرتجعات:

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

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

Timetamp.fromMillis()

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

Signature:

static fromMillis(milliseconds: number): Timestamp;

المَعلمات

المعلمة النوع الوصف
مللي ثانية رقم عدد المللي ثانية منذ حقبة يونكس 1970-01-01T00:00:00Z.

المرتجعات:

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

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

Timestamp.isEqual()

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

Signature:

isEqual(other: Timestamp): boolean;

المَعلمات

المعلمة النوع الوصف
غير ذلك الطابع الزمني تمثّل هذه السمة Timestamp المطلوب المقارنة بها.

المرتجعات:

قيمة منطقية

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;

المرتجعات:

السلسلة