DAYOFYEAR (DAYOFYEAR)
تابع «روز سال» (DAYOFYEAR) عدد روز سال را می دهد. یعنی از 1 تا 366. این تابع روی تاریخ کار می کند. «تابع (Function)» تکه کدی است که ورودی می گیرد و خروجی می دهد.
معرفی و کاربرد روز سال
DAYOFYEAR(date) برای هر تاریخ، شماره روز سال را برمی گرداند. مثلا برای برنامه ریزی ترم مدرسه یا شمارش روزهای رویداد، بسیار مفید است. خروجی همیشه عددی بین 1 تا 366 است.
نحوه نوشتن (Syntax)
DAYOFYEAR(date);
مثال های عملی
یک تاریخ مشخص
روز سال برای تاریخ 2017-06-15 را بگیر:
SELECT DAYOFYEAR("2017-06-15");
ابتدای سال
برای اولین روز سال 2017، خروجی باید 1 باشد:
SELECT DAYOFYEAR("2017-01-01");
تاریخ امروز سیستم
با CURDATE() امروز را بگیر و روز سال را حساب کن:
SELECT DAYOFYEAR(CURDATE());
جزئیات فنی
این تابع از نسخه MySQL 4.0 در دسترس است. پارامتر date اجباری است و باید یک تاریخ معتبر باشد.
نکته: اگر نیاز به شماره «روز هفته» داری، از DAYOFWEEK استفاده کن.
همچنین ببینید
برای مرور سریع تعریف «روز سال» و دیگر توابع تاریخ، به EXTRACT هم سر بزن.
جمع بندی سریع
- DAYOFYEAR شماره روز سال را می دهد.
- خروجی بین 1 تا 366 است.
- ورودی حتما تاریخ معتبر باشد.
- برای امروز، از CURDATE() استفاده کن.
- برای «روز هفته»، DAYOFWEEK بهتر است.