time
كل ما يجيب عن سؤال «متى» — وقت الساعة، أو موضع على الرسم البياني يُحسب بالشموع، أو مدة زم…
ما هو
كل ما يجيب عن سؤال «متى» — وقت الساعة، أو موضع على الرسم البياني يُحسب بالشموع، أو مدة زمنية. يُحفظ منفصلاً عن الأرقام العادية حتى لا يختلط نوعا «متى» أبداً.
العائلة الجذرية لكل قيمة ذات شكل زمني، بثلاثة مسارات فرعية بالضبط: time.epoch (طابع زمني UTC بالثواني int64)، وtime.bar (موضع شمعة على الرسم البياني)، وtime.duration (مدة بالثواني). متمايزة عمداً عن num. لا يُكتب أي منفذ بنوع time المجرد: يجب ألا تتصل الساعتان ببعضهما، لذا يعلن كل منفذ دائماً مساره الفرعي وtime_domain المطابق.
ما الذي هو نوع منه
من يصنعه
لا توجد أداة تصنع هذا النوع مباشرة.
من يأخذه
كيف أحوّله إلى شيء آخر
لا شيء يحوّل time إلى نوع آخر.
الساعة
| time.epoch | ثوانٍ منذ 1970 (UTC) | EPOCH_SECONDS | متى حدث |
|---|---|---|---|
| time.bar | فهرس شمعة على الرسم البياني | BAR_INDEX | منذ كم شمعة |
| time.duration | مدة بالثواني | DURATION_SECONDS | كم استغرق |
لا تختلط هذه أبدًا: فهرس الشمعة ليس وقتًا، والمدة ليست تاريخًا. يرفض المدقق أي سلك بين نطاقي ساعة، ولا شيء يحوّل بينهما — احسب الآخر بأداة زمنية.