این اکسپرت (EA) برای حل یک کمبود اساسی در اکوسیستم متاتریدر ۵ طراحی شده است: تقویم اقتصادی داخلی MT5 تنها از طریق زبان MQL5 و تابع CalendarValueHistory() قابل دسترسی است و هیچ راه دیگری برای خواندن آن وجود ندارد. پکیج پایتون MetaTrader5 اگرچه قیمتها، نمادها، سفارشها و تاریخچه را ارائه میدهد، اما هیچ تابعی برای تقویم ندارد. بنابراین هر اسکریپت تحقیقاتی، داشبورد، ربات یا صفحه گستردهای که نیاز دارد بداند رویداد مهم بعدی چه زمانی منتشر میشود، راهی برای پرسیدن از ترمینال ندارد. این اکسپرت به عنوان “پل گمشده” روی هر چارتی قرار میگیرد و به صورت دورهای تقویم را در یک فایل CSV داخل پوشه MQL5\Files مینویسد تا هر ابزار خارجی بتواند آن را بخواند.
نویسنده این اکسپرت را با دقت مهندسیشده از چهار اشتباه رایج محافظت کرده است: اول، خروجی را به صورت UTF-8 مینویسد نه کدپیج محلی، زیرا نام رویدادها به زبان ترمینال بازگردانده میشوند و در MT5 غیرانگلیسی حاوی کاراکترهای غیرلاتین هستند که با FILE_ANSI به بایتهای نامعتبر UTF-8 تبدیل شده و در مصرفکنندههایی مثل پایتون یا اکسل باعث خطا یا خرابی میشوند. دوم، خروجی را بر اساس زمان مرتب میکند، چون تقویم به ازای هر ارز جداگانه پرسوجو میشود و خروجی طبیعی گروهبندیشده بر اساس ارز، پرشهای زمانی دارد. سوم، کل فایل را در یک فراخوانی مینویسد تا خوانندهای که وسط نوشتن فایل را باز میکند، لیست ناقص نبیند و خط اول شامل timestamp و تعداد رویدادهاست تا تازگی فایل قابل تشخیص باشد. چهارم، موجودیتهای HTML را در نام رویدادها رمزگشایی میکند، مثلاً & را به & تبدیل میکند تا نامهایی مثل “CFTC S&P 500” درست منتقل شوند.
این اکسپرت با گروهبندی منظمی از پارامترها کنترل کامل را به کاربر میدهد. در بخش “What to include” میتوان ارزها را با کاما جدا کرد (خالی = همه ارزها)، بازه زمانی را با InpHoursAhead (پیشرو) و InpHoursBack (پسرو برای دادههای تازه منتشرشده) تنظیم کرد و حداقل اهمیت رویداد را با InpMinImportance (۰=هیچ، ۱=کم، ۲=متوسط، ۳=بالا) مشخص کرد. در بخش “Output” نیز نام فایل خروجی، بازه بازنویسی (InpRefreshSec با حداقل ۳۰ ثانیه) و انتخاب UTF-8 یا کدپیج ترمینال (InpUtf8) قابل تنظیم است. این طراحی اجازه میدهد کاربر بسته به نیاز، فقط رویدادهای با اهمیت بالا و ارزهای خاص را در بازه زمانی دلخواه دریافت کند.
جهت سفارش طراحی و برنامهنویسی اختصاصی اندیکاتور، اکسپرت و ربات معاملهگر برای MetaTrader 4 و MetaTrader 5 میتوانید استراتژی، ایده یا نیاز معاملاتی خود را با تیم هوش فعال در میان بگذارید. برای دریافت مشاوره، بررسی امکان پیادهسازی و ثبت سفارش، از طریق شماره 09364549266 با پشتیبانی هوش فعال در ارتباط باشید.
معماری کد بر پایه یک ساختار Event بنا شده که هر ردیف خروجی را نگه میدارد تا کل مجموعه قبل از نوشتن قابل مرتبسازی باشد. تابع CurrencyOf با یک مکانیزم کش، ارز مربوط به هر کشور را فقط یک بار از ترمینال میپرسد چون هزاران مقدار تقویمی بین تعداد محدودی کشور مشترک هستند. تابع ImportanceWord مقادیر عددی importance را به کلمات خوانا (NONE/LOW/MEDIUM/HIGH) تبدیل میکند تا مصرفکننده مجبور نباشد CALENDAR_IMPORTANCE_HIGH را پاکسازی کند. تابع Unescape موجودیتهای HTML را با ترتیب صحیح (amp در آخر برای جلوگیری از باگ double-decoding) رمزگشایی میکند. تابع Csv نیز نقلقولگذاری استاندارد CSV را انجام میدهد تا نام رویدادهایی که کاما دارند، دستکاری نشوند. تابع SortByTime از مرتبسازی درجی استفاده میکند که برای چند صد ردیف کارآمد است و ترتیب مساویها را حفظ میکند.
توضیحات طراح اکسپرت CalendarExport
پنج جزئیات مهم در این ابزار وجود دارد. نخست، خروجی UTF-8 است، زیرا نام رویدادها توسط ترمینال بومیسازی میشوند و در MT5 غیرانگلیسی حاوی کاراکترهای دارای اعراب یا غیرلاتین هستند؛ اگر با کدپیج محلی نوشته شوند، به بایتهایی تبدیل میشوند که UTF-8 معتبر نیستند و بیشتر مصرفکنندهها یا خطا میدهند یا نام را بیصدا خراب میکنند. دوم، خروجی بر اساس زمان مرتب میشود، چون تقویم به ازای هر ارز یک بار پرسوجو میشود و خروجی طبیعی بر اساس ارز گروهبندی شده و در زمان جلو و عقب میپرد، اما این نسخه ترتیب زمانی دارد. سوم، فایل در یک فراخوانی واحد نوشته میشود؛ بدین ترتیب فایل در حافظه ساخته شده و یکجا نوشته میشود، در غیر این صورت خوانندهای که وسط نوشتن فایل را باز کند، لیست ناقصی میبیند و هیچ راهی برای فهمیدن آن ندارد. چهارم، موجودیتهای HTML رمزگشایی شدهاند، چون ترمینال نام رویدادها را escape شده ذخیره میکند و اگر بدون تغییر نوشته شود، بهصورت اشتباه به هر مصرفکنندهای میرسد. پنجم، یک هدر تازگی وجود دارد که خط اول آن شامل زمان بهروزرسانی، تعداد رویدادها و اختلاف UTC سرور است تا مصرفکننده بتواند فایل کهنه را از فایل جاری تشخیص دهد و متوجه شود که اکسپرت جدا شده، بهجای اینکه تقویم قدیمی را طوری نشان دهد که گویی زنده است. زمان بهروزرسانی از ساعت سرور معاملاتی خوانده میشود و نه از آخرین تیک، زیرا وقتی بازار بسته است آخرین تیک ثابت میماند و فایلی که به آن روش تاریخگذاری شده باشد در حالی که هر چند دقیقه بازنویسی میشود کهنه به نظر میرسد و پنجره رویداد در طول آخر هفته به عقب میلغزد.
ورودیها
ورودیهای این ابزار شامل InpCurrencies برای لیست جداشده با کاما مانند USD,EUR (برای همه ارزها خالی بگذارید)، InpHoursAhead برای میزان نگاه به جلو با پیشفرض ۴۸، InpHoursBack برای میزان نگاه به عقب جهت گرفتن دادههای تازه منتشرشده با پیشفرض ۳، InpMinImportance با مقادیر ۰ برای هیچ، ۱ برای کم، ۲ برای متوسط و ۳ برای بالا با پیشفرض ۲، InpFile برای نام فایل خروجی داخل MQL5\Files، InpRefreshSec برای بازه بازنویسی بر حسب ثانیه با حداقل ۳۰، و InpUtf8 برای خروجی UTF-8 که فقط اگر مصرفکنندهتان کدپیج محلی نیاز دارد خاموش میشود.
نکتهای درباره زبان
نام رویدادها به زبان ترمینال بازگردانده میشوند و MQL5 هیچ راهی برای درخواست زبان دیگر ارائه نمیدهد؛ اگر به کلیدی نیاز دارید که بین زبانها و نصبهای مختلف پایدار باشد، از ستون event_id استفاده کنید که دقیقاً به همین دلیل آنجاست.
عیبیابی
اگر فایل خالی بیرون آمد، MT5 تقویم را فقط زمانی پر میکند که ترمینال متصل باشد و برخی بروکرها آن را محدود میکنند، بنابراین در Tools → Options → Server بررسی کنید که تقویم فعال باشد.

تنظیمات اکسپرت CalendarExport
در ادامه هر یک از تنظیمات (Inputs) که کاربر در پنجرهی تنظیمات اکسپرت مشاهده میکند، بهصورت آیتمبهآیتم و همراه با توضیح پاراگرافی شرح داده شده است:
گروه اول: — What to include —
این گروه مشخص میکند که چه دادههایی از تقویم اقتصادی استخراج و در فایل CSV نوشته شوند.
ارزها (Currencies, comma separated):این پارامتر تعیین میکند که کدام ارزها در خروجی گنجانده شوند. کاربر باید کد ارزها را با کاما از هم جدا کند؛ مثلاً USD,EUR,GBP,JPY. اگر این فیلد خالی گذاشته شود، اکسپرت تمام ارزهای موجود در تقویم اقتصادی متاتریدر ۵ را استخراج میکند. توجه داشته باشید که هر ارز به کشور مربوطهاش وابسته است و اکسپرت برای هر رویداد، ارز کشور میزبان را از طریق CalendarCountryById استخراج و بهصورت کششده ذخیره میکند تا از تماسهای تکراری با ترمینال جلوگیری شود.
چند ساعت جلوتر (How many hours ahead to look):این پارامتر بازهی زمانی آینده را مشخص میکند. اکسپرت از لحظهی فعلی (بر اساس ساعت سرور معاملاتی، نه آخرین تیک) تا این تعداد ساعت جلوتر را جستوجو میکند و رویدادهای اقتصادی پیشرو را در فایل مینویسد. مقدار پیشفرض ۴۸ ساعت (دو روز) است که معمولاً برای پوشش رویدادهای مهم هفته کافی است. با افزایش این مقدار، حجم فایل خروجی بیشتر میشود.
چند ساعت عقب (How many hours back):این پارامتر بازهی زمانی گذشته را تعیین میکند. هدف اصلی آن، ثبت رویدادهایی است که همین الان منتشر شدهاند و مقدار واقعی (Actual) آنها تازه در تقویم درج شده است. مقدار پیشفرض ۳ ساعت است. اگر این مقدار را صفر بگذارید، فقط رویدادهای آینده در فایل نوشته میشوند. اگر آن را بزرگتر کنید، تاریخچهی بیشتری از رویدادها در خروجی ظاهر میشود.
حداقل اهمیت (Minimum importance):این پارامتر سطح اهمیت رویدادها را فیلتر میکند و تنها رویدادهایی با اهمیت مساوی یا بالاتر از مقدار وارد شده در خروجی نوشته میشوند. مقادیر مجاز عبارتاند از:
0= هیچ (None) — همهی رویدادها حتی بیاهمیت1= کم (Low)2= متوسط (Medium) — مقدار پیشفرض3= زیاد (High) — فقط رویدادهای بسیار مهم مانند نرخ بهره یا NFP
با مقدار پیشفرض 2، رویدادهای کماهمیت حذف میشوند و خروجی تمیزتر و کاربردیتر خواهد بود. در کد، این فیلتر با شرط if((int)ev.importance < InpMinImportance) continue; اعمال میشود.
گروه دوم: --- Output ---
این گروه مشخص میکند که فایل خروجی کجا، با چه فرمتی و با چه فراوانی نوشته شود.
نام فایل خروجی (Written to this terminal’s MQL5\Files):نام فایل CSV خروجی است که در پوشهی MQL5\Files ترمینال جاری ذخیره میشود.
فاصلهی بازنویسی (How often the file is rewritten, min 30):این پارامتر فاصلهی زمانی (به ثانیه) بین دو بار بازنویسی فایل را مشخص میکند. اکسپرت با EventSetTimer یک تایمر تنظیم میکند و در هر تیک تایمر، تابع Write() را دوباره اجرا میکند. حداقل مقدار مجاز ۳۰ ثانیه است؛ اگر عددی کمتر از ۳۰ وارد شود، بهصورت خودکار روی ۳۰ تنظیم میشود (در کد: InpRefreshSec > 30 ? InpRefreshSec : 30). مقدار پیشفرض ۳۰۰ ثانیه (۵ دقیقه) است که برای اکثر کاربردها تعادل مناسبی بین بهروز بودن و بار روی سیستم فراهم میکند.
انکودینگ UTF-8 (UTF-8 recommended, false = terminal codepage): این پارامتر مشخص میکند که فایل خروجی با چه کدگذاری (Encoding) نوشته شود: true (پیشفرض): فایل با انکودینگ UTF-8 نوشته میشود. این حالت برای مصرفکنندگان خارجی مانند پایتون، اکسل و JavaScript توصیه میشود، چون نام رویدادها ممکن است شامل کاراکترهای غیرلاتین یا حروف accentدار باشند و UTF-8 استاندارد جهانی است. در این حالت کد از FILE_BIN به همراه StringToCharArray با CP_UTF8 استفاده میکند.
- false: فایل با کدپیج محلی ترمینال (ANSI) نوشته میشود. این حالت فقط برای ابزارهای قدیمی که UTF-8 را پشتیبانی نمیکنند مناسب است، ولی در غیر این صورت ممکن است نام رویدادها در سمت مصرفکننده خراب یا غیرقابلخواندن شوند.
نکات تکمیلی دربارهی خروجی
علاوه بر تنظیمات فوق، اکسپرت یک خط هدر در ابتدای فایل مینویسد که شامل زمان آخرین بهروزرسانی، اختلاف ساعت سرور با GMT و تعداد رویدادها است. این خط به مصرفکننده کمک میکند تا تشخیص دهد فایل تازه است یا کهنه، و آیا اکسپرت هنوز متصل است یا خیر.
ستونهای فایل CSV بهترتیب عبارتاند از:
time_server, currency, importance, event, forecast, previous, actual, event_id
که در آن event_id یک شناسهی پایدار و مستقل از زبان است و برای کلیدگذاری در ابزارهای خارجی کاربرد دارد.
اکسپرت CalendarExport
این فایل ویژه است. پس از بررسی شماره، وضعیت اشتراک شما نمایش داده میشود.
⚠️ هشدار و سلب مسئولیت
اکسپرتهای رایگان ارائهشده در سایت هوش فعال صرفاً با هدف آموزش، آزمایش و آشنایی با ابزارهای معاملاتی ارائه میشوند و هیچگونه تضمینی بابت سوددهی یا عملکرد آنها در شرایط مختلف بازار وجود ندارد.
معاملات فارکس و سایر بازارهای مالی دارای ریسک بالایی هستند. هوش فعال هیچگونه مسئولیتی در قبال سود، زیان، تصمیمات معاملاتی یا خسارات احتمالی ناشی از استفاده از این اکسپرتها ندارد.
لطفاً پیش از استفاده در حساب واقعی، اکسپرت را در حساب Demo و یا سرمایهای که توان از دست دادن آن را دارید، آزمایش کنید.










