تخطَّ إلى المحتوى
StatePath
كل أنواع البيانات

time

كل ما يجيب عن سؤال «متى» — وقت الساعة، أو موضع على الرسم البياني يُحسب بالشموع، أو مدة زم…

ما هو

كل ما يجيب عن سؤال «متى» — وقت الساعة، أو موضع على الرسم البياني يُحسب بالشموع، أو مدة زمنية. يُحفظ منفصلاً عن الأرقام العادية حتى لا يختلط نوعا «متى» أبداً.

العائلة الجذرية لكل قيمة ذات شكل زمني، بثلاثة مسارات فرعية بالضبط: ‏time.epoch (طابع زمني UTC بالثواني int64)، و‏time.bar (موضع شمعة على الرسم البياني)، و‏time.duration (مدة بالثواني). متمايزة عمداً عن ‏num. لا يُكتب أي منفذ بنوع ‏time المجرد: يجب ألا تتصل الساعتان ببعضهما، لذا يعلن كل منفذ دائماً مساره الفرعي و‏time_domain المطابق.

ما الذي هو نوع منه

من يصنعه

لا توجد أداة تصنع هذا النوع مباشرة.

من يأخذه

كيف أحوّله إلى شيء آخر

منtime

لا شيء يحوّل time إلى نوع آخر.

الساعة

time.epochثوانٍ منذ 1970 (UTC)EPOCH_SECONDSمتى حدث
time.barفهرس شمعة على الرسم البيانيBAR_INDEXمنذ كم شمعة
time.durationمدة بالثوانيDURATION_SECONDSكم استغرق

لا تختلط هذه أبدًا: فهرس الشمعة ليس وقتًا، والمدة ليست تاريخًا. يرفض المدقق أي سلك بين نطاقي ساعة، ولا شيء يحوّل بينهما — احسب الآخر بأداة زمنية.