شاهین

رویداد زمان‌سنجی‌شده

پیشرفته
به‌روزرسانی ۲۰ تیر ۱۴۰۵ تحریریه شاهین ۲ دقیقه مطالعه
تلفظEN/taɪm ɪˈvent/

فراخوان time_event تایمری را روشن می‌کند تا وقتی همان رویداد بعدا واقعا ثبت شد، زمان سپری‌شده به‌صورت یک پراپرتی مدت همراهش فرستاده شود.

این فراخوان الگویی هوشمند برای اندازه‌گیری مدت است: به‌جای اینکه خودتان زمان شروع و پایان را نگه دارید و تفریق کنید، تایمر را در لحظه شروع روشن می‌کنید. سپس کتابخانه هنگام ثبت رویداد، مدت را خودکار حساب و ضمیمه می‌کند. کاربردش جایی است که «چقدر طول کشید» به‌اندازه «چه شد» مهم است؛ مثلا مدت پر کردن یک فرم، زمان تا اولین خرید، یا مدت ماندن در یک مرحله. نکته مهم این است که این پراپرتی مدت باید به‌عنوان عدد ثبت شود تا بشود میانگین و توزیعش را حساب کرد. تله رایج فراموش کردن پایان است: اگر تایمر روشن شود ولی رویداد نهایی هرگز ثبت نشود (کاربر فرایند را رها کند)، آن مدت اصلا ضبط نمی‌شود. پس این فراخوان زمان تکمیل را می‌سنجد، نه زمان رها شدن؛ برای رها شدن باید جداگانه فکر کرد.