# ویرایشگر ساعت کاری برای اوپن‌استریت‌مپ

تعاریف فنی ساعت کاری در اوپن‌استریت‌مپ نسبتاً پیچیده است و ارائهٔ آن در قالب یک واسط کاربری سرراست و ساده چندان آسان و سهل نیست.

البته بیشتر اوقات معمولاً فقط بخش کوچکی از تعاریف نیازتان می‌شود. این ویرایشگر با در نظر گرفتن همین موضوع، قابلیت‌های پیچیده‌تر را در منوها پنهان می‌کند و بیشتر وقت‌ها برای کاربردهای معمول به اندکی دستکاری در الگوهای ازپیش‌تعریف‌شده نیاز دارید.

این سند مقدماتی است و در حال بهبود آن هستیم

## استفاده از ویرایشگر ساعت کاری

به‌طور معمول شیئی که ویرایش می‌کنید یا تگ ساعت کاری دارد (opening_hours،‏ service_times و collection_times) یا می‌توانید با به‌کارگیری پیش‌تنظیمی برای آن شیء، یک خانه برای ساعت کاری اضافه کنید. اگر لازم باشد که خانهٔ ساعت کاری را دستی اضافه نمایید و از وسپوچی استفاده می‌کنید، باید در زبانهٔ جزئیات، کلید آن را وارد کنید و سپس به زبانهٔ فرم (زبانهٔ خصوصیات) برگردید و آن را ویرایش نمایید. اگر معتقدید که تگ ساعت کاری باید در پیش‌تنظیم بخصوصی وجود داشته باشد، لطفاً برای ویرایشگر مدنظر گزارش بدهید.

اگر الگوی پیشفرضی تعریف کرده باشید (از طریق گزینهٔ «مدیریت الگوها» در منو) هنگامی که ویرایشگر با مقدار خالی شروع شود، این الگو به‌طور خودکار بار می‌شود. با استفاده از قابلیت «بارکردن الگو» می‌توانید هر الگوی ذخیره‌شده‌ای را بار کنید و با استفاده از گزینهٔ «ذخیره‌سازی الگو» می‌توانید مقدار کنونی را به‌عنوان الگو ذخیره نمایید. می‌توانید برای تگ‌های opening_hours،‏ service_times و collection_times الگوها و پیشفرض‌های جداگانه تعریف کنید.

به‌طور طبیعی می‌توانید مقدار ساعت کاری را از صفر بنویسید. اما پیشنهاد می‌کنیم یکی از الگوهای موجود نقطهٔ آغازتان باشد.

هنگامی که یک مقدار ساعت کاری موجود بار می‌شود، برای پیروی از تعاریف فنی ساعت کاری، تلاشی برای اصلاح خودکار آن انجام می‌شود. اگر اصلاح خودکار میسر نشود، مکان تقریبی رخداد خطا در قسمت نمایش خام ساعت کاری، مشخص می‌شود و می‌توانید به‌طور دستی آن را اصلاح نمایید. به‌طور تقریبی یک‌چهارم ساعت‌های کاری ثبت‌شده در پایگاه‌دادهٔ اوپن‌استریت‌مپ مشکل دارند، اما کمتر از ۱۰٪ آن‌ها اصلاح‌نشدنی هستند. برای اینکه بدانید کدام انحراف از تعاریف قابل‌مدارا هستند، OpeningHoursParser را ببینید.

### دکمهٔ منوی اصلی

- افزودن قاعده: قاعدهٔ جدیدی اضافه کنید.
- افزودن قاعده برای تعطیلات: برای تعطیلات و تغییر وضعیت آن قاعده‌ای اضافه کنید.
- افزودن قاعده برای ۲۴/۷: برای جایی که همیشه باز است قاعده‌ای اضافه کنید. تعاریف ساعت کاری از هیچ زیرمقداری برای 24/7 پشتیبانی نمی‌کند، اما افزودن انتخابگرهای سطح بالاتر (مثل بازهٔ سال) امکان‌پذیر است.
- بارکردن الگو: یک الگوی موجود را بار می‌کند.
- ذخیره در الگو: مقدار کنونی ساعت کاری را به‌عنوان الگو برای استفاده در آینده ذخیره کنید.
- مدیریت الگوها: الگوهای موجود را ویرایش (مثلاً تغییر نام) و حذف کنید.
- تازه‌سازی: تجزیه و بررسی دوبارهٔ مقدار ساعت کاری
- حذف همه: همهٔ قواعد را حذف کنید.

### قواعد

قواعد پیشفرض به‌عنوان قاعدهٔ عادی اضافه می‌شوند که یعنی بر مقادیر قاعده‌های قبلی برای همان روزها چیرگی دارند. هنگام استفاده از زمان‌های گسترده باید به این نکته توجه داشت. در این مواقع معمولاً باید نوع قاعده را با استفاده از گزینهٔ نمایش نوع قاعده به افزودنی تغییر دهید.

#### منوی قاعده

- افزودن اصلاحگر/توضیح: تأثیر قاعده را تغییر دهید و توضیح اختیاری اضافه کنید.
- افزودن تعطیلات: انتخابگر برای تعطیلات عمومی یا مدارس اضافه کنید.
- افزودن بازهٔ زمان...
  - زمان - زمان: زمان آغاز تا زمان پایان برای یک روز.
  - زمان - زمان گسترده: زمان آغاز تا زمان پایان در روز بعد (مثال: ۲۶:۰۰ یعنی ۰۲:۰۰ (ق.ظ.) در روز بعد).
  - زمان متغیر - زمان: از زمان آغاز غیرثابت (فلق، طلوع، غروب، شفق) تا زمان پایان در همان روز
  - زمان متغیر - زمان گسترده: از زمان آغاز غیرثابت تا زمان پایان در روز بعد.
  - زمان - زمان متغیر: زمان آغاز تا زمان پایان غیرثابت.
  - زمان متغیر - زمان متغیر: زمان آغاز غیرثابت تا زمان پایان غیرثابت.
  - زمان: لحظه‌ای در زمان.
  - زمان-پایان باز: از یک لحظهٔ آغاز به بعد.
  - زمان متغیر: در زمان غیرثابت مشخص
  - زمان متغیر-پایان باز: از یک زمان آغاز غیرثابت به بعد
- افزودن بازهٔ روز هفته: انتخابگری بر اساس هفته اضافه کنید.
- افزودن بازهٔ تاریخ...
  - تاریخ - تاریخ: از تاریخ آغاز (سال، ماه، روز) تا تاریخ پایان.
  - تاریخ متغیر - تاریخ: از تاریخ آغاز غیرثابت (فعلاً در تعارف فنی فقط easter آمده است) تا تاریخ پایان.
  - تاریخ - تاریخ متغیر: از تاریخ آغاز تا تاریخ غیرثابت.
  - تاریخ متغیر - تاریخ متغیر: از تاریخ آغاز غیرثابت تا تاریخ پایان غیرثابت.
  - وقوع در ماه - وقوع در ماه: از وقوع یک روز هفته در ماه تا همان روز.
  - وقوع در ماه - تاریخ: از وقوع یک روز هفته در ماه تا تاریخ پایان.
  - تاریخ - وقوع در ماه: از تاریخ آغاز تا وقوع یک روز هفته در ماه.
  - وقوع در ماه - تاریخ متغیر: از وقوع یک روز هفته در ماه تا تاریخ پایان غیرثابت.
  - تاریخ متغیر - وقوع در ماه: از تاریخ آغاز غیرثابت تا وقوع یک روز هفته در ماه.
  - تاریخ - پایان باز: از تاریخ آغاز به بعد.
  - تاریخ متغیر - پایان باز: از تاریخ آغاز غیرثابت به بعد.
  - وقوع در ماه - پایان باز: از وقوع یک روز هفته در ماه به بعد.
  - با آفست...: همان مدخل‌هایی که پیشتر گفته شد با مشخص‌کردن آفست (به‌ندرت استفاده می‌شود).
- افزودن بازهٔ سال: انتخابگری بر اساس سال اضافه کنید.
- افزودن بازهٔ هفته: انتخابگری بر اساس شمارهٔ هفته اضافه کنید.
- تکرار: از این قاعده کپی بگیرید و پس از موقعیت کنونی درج کنید.
- نمایش نوع قاعده: نمایش و تغییر نوع قاعده (عادی،‏ افزودنی و fallback (برای قاعدهٔ اول امکان‌پذیر نیست).
- برو بالا: این قاعده را یک پله بالا ببرید (برای قاعدهٔ اول امکان‌پذیر نیست).
- برو پایین: این قاعده را یک پله پایین ببرید.
- حذف: این قاعده را حذف کنید.

### بازه‌های زمان

برای اینکه ویرایش بازه‌های زمانی تا حد ممکن آسان باشد، هنگامی که مقادیر موجود بار می‌شوند یک بازهٔ زمانی و گام بهینه برای نوارهای بازه انتخاب می‌کنیم. برای بازه‌های زمانی جدید، نوار از ۰۶:۰۰ ق.ظ. آغاز می‌شود و گام‌های افزایشی ۱۵ دقیقه‌ای دارد. این را می‌توانید از منو تغییر دهید.

اگر استفادهٔ مستقیم از نوارها خیلی دشوار است، با زدن روی نوار زمان (نه روی دسته‌ها) زمان‌گزین بزرگ باز می‌شود. زمان‌گزین‌ها به روز بعد گسترش می‌یابند، بنابراین راه ساده‌ای برای گسترش بازهٔ زمان هستند بدون اینکه مجبور باشید بازه را حذف و دوباره اضافه کنید.

#### منوی بازهٔ زمان

- نمایش زمان‌گزین: برای انتخاب زمان آغاز و پایان یک کادر بزرگ نمایش می‌دهد. در نمایشگرهای خیلی کوچک روش مناسبی برای تغییر زمان است.
- پرش به خط‌نشان‌های ۱۵ دقیقه‌ای: استفاده از گام‌های ۱۵ دقیقه‌ای برای نوار بازه.
- پرش به خط‌نشان‌های ۵ دقیقه‌ای: استفاده از گام‌های ۵ دقیقه‌ای برای نوار بازه.
- پرش به خط‌نشان‌های ۱ دقیقه‌ای: استفاده از گام‌های ۱ دقیقه‌ای برای نوار بازه. استفاده روی گوشی خیلی راحت نیست.
- آغاز از نیمه‌شب: نوار بازه از نیمه‌شب آغاز می‌شود.
- نمایش دوره: برای مشخص‌کردن دوره به دقیقه خانهٔ دوره را نمایش می‌دهد.
- حذف: این بازهٔ زمان را حذف کنید.