# فرکانس و برچسب دادهها
این راهنما توضیح میدهد که "فرکانس و برچسب دادهها" در arenil.com به چه معناست، انواع مختلف آن چیست، و چگونه میتوان آنرا در فرم وارد کرد. بهطور خلاصه، در پی راهی برای توصیف زمان اندازهگیری یا دورهٔ اندازهگیری یک متغیر هستیم. توجه کنید که ارزش بعضی از متغیرها در هر لحظه از زمان ارزش دارند (که به آنها متغیرهای ذخیره میگویند، مثل حجم پول) و برای اندازهگیری بعضی دیگر از متغیرها به بازهٔ زمانی نیاز داریم (که به آنها متغیرهای جریان میگویند، مثل درآمد). بهعبارت دیگر، هر داده قالب خاص خود را برای نمایش و ورود اطلاعات دارد و در زیربخشهای مختلف این راهنما، انوع آنرا معرفی میکنیم.
## درون هفته
فرکانسهای این گروه بر پایهٔ *روز درون یک هفته* هستند. این ممکن است تمام روزهای هفته را شامل شود (که همان فرکانس روزانه است) یا ممکن است برخی از روزهای هفته از آن حذف شود (مثلاً روزهای تعطیل حذف شود و از شنبه تا چهارشنبه باشد). برچسبها در این گروه معمولاً با یک تاریخ با فرمت `"yyyy-MM-dd"` تعریف میشوند، هرچند برای تعریف روزهای هفته اطلاعات بیشتری نیاز است که در ستون جزئیات جدول زیر ارائه میشود و باید در قسمت مربوطه در فرم نیز وارد شود.
| نوع فرکانس | ساختار ارزش | جزئیات | توضیحات |
|----|------|----|---|
| روزانه | `yyyy-MM-dd` | `d` | تکرار روزانه؛ یعنی هر روز اتفاق میافتد.|
| چندروزه | `yyyy-MM-dd` | `d#` | مثلاً اگر جزئیات برابر با d2 باشد، یعنی هر دو روز یکبار اتفاق میافتد. |
| هفتگی | `yyyy-MM-dd` | `w` | انتخاب یک روز مشخص از هفته که هر ۷ روز تکرار میشود. این تاریخ روز اول هفته را مشخص میکند، مثلاً اگر این تاریخ شنبه باشد، هفته از شنبه شروع خواهد شد. |
| چندهفتگی | `yyyy-MM-dd` | `w#` | تکرار هر چند هفته یکبار؛ مثلاً اگر جزئیات برابر با 2 باشد، یعنی هر دو هفته یکبار. این تاریخ نیز روز اول هفته را مشخص میکند. |
| روزهای خاص در هفته | `yyyy-MM-dd` | `i:Mon-Fri` | انتخاب روزهایی خاص در هفته؛ مثلاً فقط دوشنبه تا جمعه. |
## درون روز
این فرکانسها برپایهٔ فرکانس هفتگی تعریف میشوند و هر روز هفته را به قسمتهایی با طول مساوی تقسیمبندی میکنند. مثلاً، فرکانس ساعتی یا دو بار در روز در این گروه قرار میگیرد. فرمت کلی `"yyyy-MM-dd:#/#"` است که جای `#` عدد قرار میگیرد. به علامتهای `-`، `:`، و `/` دقت کنید. اولین عدد (قبل از `/`) جایگاه مشاهده و دومین عدد (بعد از `/`) تعداد قسمتها در روز است. تعریف هفته مشابه فرکانس هفتگی است، یعنی `d` روزانه یا `i:Mon-Fri` هفته از دوشنبه تا جمعه را تعریف میکند. این تعریف در ستون جزئیات جدول زیر بهجای ... قرار میگیرد.
| نوع فرکانس | ساختار ارزش | جزئیات | توضیحات |
|---|---------|-----------|---|
| ساعتی | `yyyy-MM-dd:#/24` |` ho\|...` | تقسیم روز به ۲۴ بخش؛ مقدار ۵ یعنی ساعت پنجم از آن روز. |
| دقیقهای | `yyyy-MM-dd:#/1440` | `mi\|...` | تقسیم روز به ۱۴۴۰ بخش؛ مقدار ۵۰۰ یعنی دقیقه ۵۰۰ام از روز. |
| ثانیهای | `yyyy-MM-dd:#/86400` | `se\|...` | تقسیم روز به ۸۶۴۰۰ بخش؛ مقدار ۷۰۰۰۰ یعنی ثانیه ۷۰۰۰۰ام. |
| تقسیم دلخواه در روز | `yyyy-MM-dd:#/#` | `da#\|...` | تقسیم سفارشی روز به N بخش (مثلاً da30\|w برای ۳۰ بخش در روز)؛ |
## درون سال
برای رویدادهایی که سالانه یا در بازههای خاصی از سال تکرار میشوند، از این نوع فرکانس استفاده کنید. این شامل فرکانس ماهانه، فصلی، سالانه و غیره میشود. در جدول زیر ساختار این فرکانسها و برچسبها معرفی میشود. نکته مهم آن است که بهجای ... در ستون جزئیات میتوانید نام فرهنگ برای ترجمه عدد به سال تقویم وارد کنید. مثلاً اگر شماره سال 1394 مربوط به تقویم هجری باشد، باید بهجای ... عبارت `fa` وارد کنید.
| نوع فرکانس | ساختار ارزش | جزئيات | توضیحات |
|---|------|---------|--------|
| سالانه | `####` | `y:...` | رویدادی که یکبار در سال اتفاق میافتد. نماد `####` یعنی شماره سال، مثلاً 2025. |
| فصلی | `####Q#` | `q:...` | تقسیم سال به ۴ فصل؛ 2025Q2 یعنی فصل دوم از سال ۲۰۲۵. |
| ماهانه | `####M#` | `m:...` | تقسیم سال به ۱۲ ماه؛ 2025M2 یعنی ماه دوم از سال ۲۰۲۵. |
| تقسیم دلخواه در سال | `####:#/#` | y12 | تقسیم سفارشی سال به تعداد بخشها؛ 2025:2/30 یعنی قسمت دوم از ۳۰ قسمت سال ۲۰۲۵. |
| چند سال یکبار | #### | `z#` | برای رویدادهایی که هر چند سال یکبار اتفاق میافتند؛ نماد `####` یعنی شماره سال، مثلاً 2025. همچنین z5 یعنی هر ۵ سال یکبار. |
## فهرست
این فرکانسها عملاً یک لیست از برچسبها هستند که یا شامل نامهای خاص و غیرتکراری یا تاریخها و زمانهای مشخص میشوند. طبیعتاً بهدلیل ساختارمند نبودن این نوع برچسبها، مقادیر آتی آن بهصورت خودکار تولید نمیشود و باید لیست موردنظر در جزئیات وارد شود.
| نوع فرکانس | ساختار ارزش (مثال) | جزئيات (مثال) | توضیحات |
|-----|------|---|------|
| فهرست متنی | Feb | Ls یا Ls:Jan,Feb,Mar | انتخاب یک مقدار متنی از یک لیست مشخص. مقدار باید دقیقاً با یکی از آیتمها مطابقت داشته باشد. |
| فهرست تاریخ | 2025-04-15 | Ld یا Ld:2025-04-15;2025-04-16;2025-04-17 | انتخاب یک تاریخ از لیست مشخص با فرمت "yyyy-MM-dd". تاریخ باید در فهرست موجود باشد. |
## نکات مهم
- **فرمت صحیح را رعایت کنید:**
از قالبهای تاریخ و جداکنندههایی که سیستم پشتیبانی میکند استفاده کنید (مثلاً `:` و `/` به درستی بهکار بروند).
- **مقدار انتخابی باید با فهرست هماهنگ باشد:**
هر مقداری که وارد میکنید باید دقیقاً در فهرست موجود باشد.
- **تقسیمبندیها را بشناسید:**
اگر روز به ۲۴ قسمت تقسیم شده، مقدار بین ۱ تا ۲۴ قابل قبول است. در سال، تقسیمبندی ممکن است ۴ فصل یا ۱۲ ماه باشد.
## اشتباهات رایج
- **جداکننده نادرست:**
مانند استفاده از `/` به جای `:` یا `-` به جای `/`.
- **فرمت اشتباه تاریخ:**
تاریخها باید دقیقاً با فرمت `"yyyy-MM-dd"` وارد شوند.
- **مقدار نادرست در فهرست:**
اگر مقداری که وارد میکنید در فهرست نباشد، سیستم نمیتواند آن را شناسایی کند.