متغیرهای سیستمی

متغیرهای سیستمی، مقدارهای آماده‌ای هستند که اپ ادیتور به‌صورت خودکار در اختیار اپلیکیشن قرار می‌دهد. این متغیرها معمولاً فقط‌خواندنی هستند و می‌توانید از آن‌ها در شرط‌ها، عملکردها، نمایش متن و منطق صفحات استفاده کنید.

همه متغیرهای سیستمی با پیشوند sys.‎ شروع می‌شوند. این پیشوند نشان می‌دهد مقدار توسط سیستم ساخته شده و نباید به‌عنوان متغیر کاربری تعریف یا بازنویسی شود.

نکات مهم

متغیرهای سیستمی نیازی به ساخت دستی ندارند.
مقدار آن‌ها توسط سیستم و در زمان اجرا به‌روزرسانی می‌شود.
برای استفاده، نام کامل متغیر را دقیقاً مطابق جدول‌ها وارد کنید.

اطلاعات اپ

نام	متغیر	توضیح
نام اپ	`sys.app.name`	نام برنامه
پکیج اپ	`sys.app.packageName`	شناسه پکیج برنامه
نسخه عددی	`sys.app.versionCode`	کد نسخه برنامه
وب بودن	`sys.app.isWeb`	آیا برنامه روی وب اجرا شده است

پلتفرم

نام	متغیر	توضیح
اندروید بودن	`sys.platform.isAndroid`	آیا دستگاه اندروید است
iOS بودن	`sys.platform.isIOS`	آیا دستگاه iOS است
ویندوز بودن	`sys.platform.isWindows`	آیا دستگاه ویندوز است
لینوکس بودن	`sys.platform.isLinux`	آیا دستگاه لینوکس است
مک بودن	`sys.platform.isMacOS`	آیا دستگاه مک است

تایمر

نام	متغیر	توضیح
تیک تایمر	`sys.timer.tick`	شمارنده تیک تایمر سراسری (هر ثانیه)

وضعیت اجرا

نام	متغیر	توضیح
دسترسی اینترنت	`sys.runtime.hasInternetAccess`	دسترسی واقعی به اینترنت
روشنایی سیستم	`sys.runtime.brightness`	حالت روشنایی سیستم (light/dark)
اولین اجرا	`sys.runtime.isFirstLaunch`	آیا اولین اجرا بعد از نصب یا آپدیت است؟
نصب جدید	`sys.runtime.isNewInstallation`	آیا نصب تازه انجام شده است.
زبان جاری	`sys.runtime.currentLangId`	شناسه زبان فعلی اپ

اندازه و جهت صفحه

نام	متغیر	توضیح
جهت صفحه	`sys.metrics.orientation`	جهت فعلی صفحه (portrait/landscape)
حالت پرتره	`sys.metrics.isPortrait`	آیا جهت صفحه portrait است
حالت افقی	`sys.metrics.isLandscape`	آیا جهت صفحه landscape است
عرض	`sys.metrics.width`	عرض فعلی صفحه (logical)
ارتفاع	`sys.metrics.height`	ارتفاع فعلی صفحه (logical)
نسبت تصویر	`sys.metrics.aspectRatio`	نسبت ابعاد صفحه
چگالی پیکسل	`sys.metrics.devicePixelRatio`	devicePixelRatio فعلی
عرض منطقی	`sys.metrics.logicalWidth`	عرض منطقی viewport
ارتفاع منطقی	`sys.metrics.logicalHeight`	ارتفاع منطقی viewport
عرض فیزیکی	`sys.metrics.physicalWidth`	عرض فیزیکی viewport
ارتفاع فیزیکی	`sys.metrics.physicalHeight`	ارتفاع فیزیکی viewport

صفحه

نام	متغیر	توضیح
شناسه صفحه جاری	`sys.page.currentId`	شناسه صفحه فعال فعلی
شناسه صفحه قبلی	`sys.page.previousId`	شناسه صفحه قبلی در ناوبری

کاربر

نام	متغیر	توضیح
ورود کاربر	`sys.user.isLoggedIn`	آیا کاربر وارد حساب شده است
شناسه کاربر	`sys.user.id`	شناسه کاربر فعلی
تکمیل پروفایل	`sys.user.profileIsComplete`	وضعیت کامل بودن پروفایل کاربر
نام کاربر	`sys.user.name`	نام کاربر
نام خانوادگی	`sys.user.lastname`	نام خانوادگی کاربر
موبایل	`sys.user.mobile`	شماره موبایل کاربر
ایمیل	`sys.user.email`	ایمیل کاربر

زبان و منطقه زمانی

نام	متغیر	توضیح
تگ زبان	`sys.locale.tag`	تگ کامل locale سیستم
کد زبان	`sys.locale.languageCode`	کد زبان سیستم
کد کشور	`sys.locale.countryCode`	کد کشور locale
نام منطقه زمانی	`sys.timezone.name`	نام timezone سیستم
آفست منطقه زمانی	`sys.timezone.offset`	اختلاف timezone به فرمت +HH:mm
آفست دقیقه‌ای	`sys.timezone.offsetMinutes`	اختلاف timezone بر حسب دقیقه

تاریخ و زمان

نام	متغیر	توضیح
یونیکس میلی‌ثانیه	`sys.datetime.epochMs`	زمان جاری بر حسب epoch milliseconds
یونیکس ثانیه	`sys.datetime.epochSec`	زمان جاری بر حسب epoch seconds
ISO محلی	`sys.datetime.isoLocal`	تاریخ‌زمان محلی با ISO-8601
ISO UTC	`sys.datetime.isoUtc`	تاریخ‌زمان UTC با ISO-8601
RFC3339 محلی	`sys.datetime.rfc3339Local`	تاریخ‌زمان محلی با فرمت RFC3339
تاریخ‌زمان کامل /	`sys.datetime.yyyy_mm_dd_hh_mm`	تاریخ‌زمان میلادی تا دقیقه
تاریخ‌زمان کامل / ثانیه	`sys.datetime.yyyy_mm_dd_hh_mm_ss`	تاریخ‌زمان میلادی تا ثانیه
تاریخ‌زمان کامل -	`sys.datetime.yyyy-mm-dd_hh:mm:ss`	تاریخ‌زمان میلادی با جداکننده - و :

تاریخ میلادی

نام	متغیر	توضیح
سال میلادی	`sys.date.gregorian.year`	سال میلادی جاری
ماه میلادی	`sys.date.gregorian.month`	ماه میلادی جاری
روز میلادی	`sys.date.gregorian.day`	روز میلادی جاری
روز هفته میلادی	`sys.date.gregorian.weekday`	روز هفته میلادی (1..7)
روز سال میلادی	`sys.date.gregorian.dayOfYear`	شماره روز در سال میلادی
هفته ISO	`sys.date.gregorian.isoWeek`	شماره هفته به استاندارد ISO
تاریخ میلادی /	`sys.date.gregorian.yyyy_mm_dd`	تاریخ میلادی با /
تاریخ میلادی -	`sys.date.gregorian.yyyy-mm-dd`	تاریخ میلادی با -

تاریخ شمسی

نام	متغیر	توضیح
سال شمسی	`sys.date.jalali.year`	سال شمسی جاری
ماه شمسی	`sys.date.jalali.month`	ماه شمسی جاری
روز شمسی	`sys.date.jalali.day`	روز شمسی جاری
تاریخ شمسی کامل	`sys.date.jalali.full`	تاریخ شمسی به فرمت yyyy/mm/dd
روز هفته شمسی	`sys.date.jalali.weekday`	شماره روز هفته شمسی
نام ماه شمسی	`sys.date.jalali.monthName`	نام ماه شمسی
نام روز هفته شمسی	`sys.date.jalali.weekdayName`	نام روز هفته شمسی

بخش‌های تاریخ

نام	متغیر	توضیح
سال چهاررقمی	`sys.date.parts.yyyy`	سال به صورت 4 رقمی
سال دورقمی	`sys.date.parts.yy`	سال به صورت 2 رقمی
ماه دورقمی	`sys.date.parts.mm`	ماه به صورت 2 رقمی
روز دورقمی	`sys.date.parts.dd`	روز به صورت 2 رقمی

زمان

نام	متغیر	توضیح
ساعت	`sys.time.hour`	ساعت جاری
دقیقه	`sys.time.minute`	دقیقه جاری
ثانیه	`sys.time.second`	ثانیه جاری
میلی‌ثانیه	`sys.time.millisecond`	میلی‌ثانیه جاری
زمان HH:mm	`sys.time.hh_mm`	زمان به فرمت HH:mm
زمان HH:mm:ss	`sys.time.hh_mm_ss`	زمان به فرمت HH:mm:ss

فرمت محلی

نام	متغیر	توضیح
تاریخ کامل محلی	`sys.intl.date.full`	تاریخ کامل براساس locale دستگاه
تاریخ کوتاه محلی	`sys.intl.date.short`	تاریخ کوتاه براساس locale دستگاه
زمان محلی	`sys.intl.time`	زمان براساس locale دستگاه

نمونه استفاده

برای نمایش نام کاربر، از sys.user.name در متن یا ویجت نمایشگر متغیر استفاده کنید.
برای نمایش دکمه ورود فقط به کاربران واردنشده، شرط را بر اساس sys.user.isLoggedIn تنظیم کنید.
برای اجرای رفتار متفاوت در وب و اندروید، از sys.app.isWeb یا sys.platform.isAndroid استفاده کنید.
برای نمایش تاریخ شمسی امروز، از sys.date.jalali.full استفاده کنید.

نکات مهم​

اطلاعات اپ​

پلتفرم​

تایمر​

وضعیت اجرا​

اندازه و جهت صفحه​

صفحه​

کاربر​

زبان و منطقه زمانی​

تاریخ و زمان​

تاریخ میلادی​

تاریخ شمسی​

بخش‌های تاریخ​

زمان​

فرمت محلی​

نمونه استفاده​

ادامه مسیر​