> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kayanos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# دوال النماذج ومرشحات البحث

> دوال سياق النموذج فقط، وفحوص واجهة الاستخدام المرتبطة بالصلاحيات، وعمليات البحث عن البيانات، وفحوص أيام العمل، وبناء المرشحات.

## متى تستخدم هذه الدوال؟

هذه الدوال مدعومة في سياق تعبير النموذج العادي. وهي تكيّف النموذج ولا تمنح صلاحية ولا تحل محل التفويض على الخادم. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

## طريقة الكتابة

استخدم الدالة بصيغة `hasVerb("review")`. لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.

## مرجع الدوال الكامل

### `f._in`

بديل صريح لـ `f.in` يبني مرشح إدراج لقيمة ضمن قائمة.

**التوقيع:** `f._in(field, values)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f._in("status", ["received", "in_review"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.adj`

يبني مرشحاً لمديين متجاورين دون تداخل.

**التوقيع:** `f.adj(field, range)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.adj("service_period", ["2026-01-01", "2026-01-31"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.and`

يبني مرشح بحث مركباً لا يطابق إلا السجلات التي تحقق كل المرشحات الفرعية. مرره حصراً إلى `getRecords`.

**التوقيع:** `f.and(...filters)`

**مثال:**

```txt theme={null}
getRecords("licenses", f.and(f.eq("status", "approved"), f.gte("score", 80)))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.cd`

يبني مرشح احتواء الحقل ضمن مجموعة القيم المعطاة.

**التوقيع:** `f.cd(field, values)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.cd("tags", ["priority", "inspection", "public"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.cs`

يبني مرشح احتواء لكل القيم داخل حقل قائمة.

**التوقيع:** `f.cs(field, values)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.cs("tags", ["priority", "inspection"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.eq`

يبني مرشح مساواة لحقل وسجل قيمة محددة.

**التوقيع:** `f.eq(field, value)`

**مثال:**

```txt theme={null}
getRecords("licenses", f.eq("status", "approved"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.fts`

يبني مرشح بحث نصي كامل.

**التوقيع:** `f.fts(field, query)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.fts("description", "service counter"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.gt`

يبني مرشحاً للقيم الأكبر من قيمة محددة.

**التوقيع:** `f.gt(field, value)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.gt("requested_amount", 0))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.gte`

يبني مرشحاً للقيم الأكبر من أو المساوية لقيمة محددة.

**التوقيع:** `f.gte(field, value)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.gte("score", 80))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.ilike`

يبني مرشح نمط غير حساس لحالة الأحرف.

**التوقيع:** `f.ilike(field, pattern)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.ilike("title", "%inspection%"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.imatch`

يبني مرشح مطابقة تعبير نمطي غير حساس لحالة الأحرف.

**التوقيع:** `f.imatch(field, pattern)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.imatch("district", "^central$"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.in`

يبني مرشح إدراج لقيمة ضمن قائمة. استخدم `f._in` إذا كان الاسم سيجعل التعبير المعقد أقل وضوحاً.

**التوقيع:** `f.in(field, values)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.in("status", ["received", "in_review"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.is`

يبني مرشحاً على أسلوب قاعدة البيانات لقيمة `null` أو لحالة منطقية.

**التوقيع:** `f.is(field, value)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.is("closed_at", null))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.isdistinct`

يبني مرشحاً يتطلب قيمة مميزة عن القيمة المعطاة.

**التوقيع:** `f.isdistinct(field, value)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.isdistinct("owner_id", $.current_owner_id))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.like`

يبني مرشح نمط حساساً لحالة الأحرف.

**التوقيع:** `f.like(field, pattern)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.like("reference", "CSR%"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.lt`

يبني مرشحاً للقيم الأصغر من قيمة محددة.

**التوقيع:** `f.lt(field, value)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.lt("days_open", 30))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.lte`

يبني مرشحاً للقيم الأصغر من أو المساوية لقيمة محددة.

**التوقيع:** `f.lte(field, value)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.lte("attachments_count", 10))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.match`

يبني مرشح مطابقة تعبير نمطي حساساً لحالة الأحرف.

**التوقيع:** `f.match(field, pattern)`

**مثال:**

```txt theme={null}
getRecords("licenses", f.match("code", "^LIC-[0-9]+$"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.neq`

يبني مرشح عدم مساواة لحقل وسجل قيمة محددة.

**التوقيع:** `f.neq(field, value)`

**مثال:**

```txt theme={null}
getRecords("licenses", f.neq("status", "cancelled"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.nilike`

يبني مرشح نفي لنمط غير حساس لحالة الأحرف.

**التوقيع:** `f.nilike(field, pattern)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.nilike("title", "%archived%"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.nin`

يبني مرشحاً ينفي إدراج القيمة ضمن القائمة.

**التوقيع:** `f.nin(field, values)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.nin("status", ["archived", "deleted"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.nis`

يبني صيغة النفي للمرشح `f.is`.

**التوقيع:** `f.nis(field, value)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.nis("closed_at", null))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.nisdistinct`

يبني مرشحاً ينفي شرط القيمة المميزة.

**التوقيع:** `f.nisdistinct(field, value)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.nisdistinct("owner_id", $.current_owner_id))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.nlike`

يبني مرشح نفي لنمط حساس لحالة الأحرف.

**التوقيع:** `f.nlike(field, pattern)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.nlike("reference", "TEST%"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.nxl`

يبني مرشحاً لمدى لا يمتد إلى يسار المدى المعطى.

**التوقيع:** `f.nxl(field, range)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.nxl("service_period", ["2026-01-01", "2026-01-31"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.nxr`

يبني مرشحاً لمدى لا يمتد إلى يمين المدى المعطى.

**التوقيع:** `f.nxr(field, range)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.nxr("service_period", ["2026-01-01", "2026-01-31"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.or`

يبني مرشح بحث مركباً يطابق السجل عند تحقق أي مرشح فرعي. مرره حصراً إلى `getRecords`.

**التوقيع:** `f.or(...filters)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.or(f.eq("priority", "high"), f.eq("priority", "urgent")))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.ov`

يبني مرشح تداخل لمجال أو مجموعة قيم.

**التوقيع:** `f.ov(field, values)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.ov("service_area", ["central", "north"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.ov_array`

يبني مرشح تداخل بين حقلي قوائم.

**التوقيع:** `f.ov_array(field, values)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.ov_array("categories", ["roads", "lighting"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.phfts`

يبني مرشح بحث نصي كامل يطابق عبارة متصلة.

**التوقيع:** `f.phfts(field, query)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.phfts("description", "street light"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.plfts`

يبني مرشح بحث نصي كامل بصيغة عبارة عادية.

**التوقيع:** `f.plfts(field, query)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.plfts("description", "road repair"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.sl`

يبني مرشحاً لمدى يقع بالكامل إلى يسار المدى المعطى.

**التوقيع:** `f.sl(field, range)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.sl("service_period", ["2026-02-01", "2026-02-28"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.sr`

يبني مرشحاً لمدى يقع بالكامل إلى يمين المدى المعطى.

**التوقيع:** `f.sr(field, range)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.sr("service_period", ["2026-01-01", "2026-01-31"]))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `f.wfts`

يبني مرشح بحث نصي كامل بصيغة الويب، بما فيها عوامل البحث المدعومة.

**التوقيع:** `f.wfts(field, query)`

**مثال:**

```txt theme={null}
getRecords("service_requests", f.wfts("description", "lighting OR roads"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `getRecord`

يبحث عن سجل واحد لتعبير نموذج. قد ينتج عن غياب العميل أو مهلة البحث قيمة فارغة أو شبيهة بـ `null`؛ لا تستخدمه لإثبات الصلاحية.

**التوقيع:** `getRecord(qualifiedRecordId)`

**مثال:**

```txt theme={null}
getRecord("licenses:license-42")
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `getRecords`

يبحث عن سجلات لتعبير نموذج باستخدام مرشح مبني بـ `f.*`. لا تعرض نتائج البحث في مخرج عام ما لم يراجع مالك الخدمة نطاق البيانات.

**التوقيع:** `getRecords(entityKey, filters)`

**مثال:**

```txt theme={null}
getRecords("licenses", f.eq("status", "approved"))
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `hasAnyScope`

يتحقق من احتواء جلسة النموذج الحالية على أي نطاق من قائمة النطاقات المعطاة.

**التوقيع:** `hasAnyScope(scopes)`

**مثال:**

```txt theme={null}
hasAnyScope(["central-service-centre", "north-service-centre"])
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `hasScope`

يتحقق من احتواء جلسة النموذج الحالية على نطاق واحد بالاسم المعطى.

**التوقيع:** `hasScope(scope)`

**مثال:**

```txt theme={null}
hasScope("central-service-centre")
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `hasVerb`

يتحقق من أفعال جلسة النموذج للعضو الحالي. تعيد المعالجة على الخادم `true`، لذلك لا تمثل وسيلة تفويض من جهة الخادم.

**التوقيع:** `hasVerb(verb)`

**مثال:**

```txt theme={null}
hasVerb("review")
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `hasVerbOnRecord`

يتحقق من الفعل الممنوح لعضو النموذج الحالي على سجل مؤهل ونطاقاته. استخدمه لتكييف تجربة النموذج فقط، وليس لفرض التفويض.

**التوقيع:** `hasVerbOnRecord(verb, qualifiedRecordId)`

**مثال:**

```txt theme={null}
hasVerbOnRecord("update", $.license_id)
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `isWeekday`

يتحقق مما إذا كان التاريخ يوم عمل، مع استخدام بيانات الوردية الاختيارية نفسها والرجوع إلى السبت والأحد عند غيابها.

**التوقيع:** `isWeekday(date, entityId?)`

**مثال:**

```txt theme={null}
isWeekday($.appointment_date, $.assigned_position_id)
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

### `isWeekend`

يتحقق مما إذا كان التاريخ غير يوم عمل للكيان المرتبط بالوردية اختيارياً. عند غياب بيانات الوردية، يرجع إلى السبت والأحد.

**التوقيع:** `isWeekend(date, entityId?)`

**مثال:**

```txt theme={null}
isWeekend($.appointment_date, $.assigned_position_id)
```

**التوافر:** متاحة في تعبيرات النموذج العادية فقط، كاستدعاءات دوال لا كتحويلات. تحظر النماذج غير المتصلة دوال البيانات والصلاحيات.

**ملاحظة:** استخدمها كاستدعاء دالة؛ لا تستخدمها كتحويل.

## قائمة تحقق قبل النشر

* ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
* تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
* لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
* راجع [سياقات وتوافر التعبيرات](/ar/reference/expressions/contexts) قبل نسخ تعبير بين ميزتين.

![دوال النماذج ومرشحات البحث في KayanOS](https://kayanos.app/docs-images/ar/reference/expressions-helpers-forms.png)