در بسیاری از APIها، استفاده از مقادیر int برای توصیف بازه زمانی رایج است که منجر به اشکالات و سردرگمی میشود. این مقاله به بررسی مشکل استفاده از int برای نشان دادن مدت زمان میپردازد و پیشنهاد میکند که به جای آن از نوع TimeSpan استفاده شود. استفاده از نامهای واضحتر مانند delayMilliseconds و timeoutSeconds به جای delay و timeout، به خوانایی و جلوگیری از حدس و گمان توسعهدهندگان کمک میکند. استفاده از TimeSpan به جای int یا uint، به دلیل وضوح بیشتر و ایمنی نوع، توصیه میشود. در سناریوهای غیر بحرانی عملکرد، TimeSpan یک انتخاب بهتر است، زیرا به طور داخلی از یک long برای ذخیره مقدار استفاده میکند و امکان نمایش بازههای زمانی با واحدهای مختلف را فراهم میکند.
مشاهده مطلب اصلی