📝 دوال النصوص
دوال لقراءة النصوص والبحث فيها وتنظيفها وتحويلها.
| الدالة | الوصف | الصياغة | المعاملات | مثال |
|---|---|---|---|---|
LEFT |
يستخرج عددًا محددًا من الأحرف بدءًا من يسار النص. | LEFT(Text, Number) |
Text — النص المصدر.Number — عدد الأحرف المطلوب استخراجها من اليسار. | LEFT('abcde', 2) = 'ab' |
RIGHT |
يستخرج عددًا محددًا من الأحرف بدءًا من يمين النص. | RIGHT(Text, Number) |
Text — النص المصدر.Number — عدد الأحرف المطلوب استخراجها من اليمين. | RIGHT('abcde', 2) = 'de' |
LEN |
يُرجع عدد الأحرف في نص معين. | LEN(Text) |
Text — النص المراد قياسه. | LEN('abc') = 3 |
LOWER |
يحوّل النص إلى أحرف صغيرة (lowercase). | LOWER(Text) |
Text — النص المراد تحويله. | LOWER('ArrAnge') = 'arrange' |
UPPER |
يحوّل النص إلى أحرف كبيرة (UPPERCASE). | UPPER(Text) |
Text — النص المراد تحويله. | UPPER('aPpLe') = 'APPLE' |
TRIM |
يزيل المسافات الفارغة من بداية النص ونهايته. | TRIM(Text) |
Text — النص المراد تنظيفه. | TRIM(' abc ') = 'abc' |
REVERSE |
يعكس ترتيب أحرف النص. | REVERSE(Text) |
Text — النص المراد عكسه. | REVERSE('abc') = 'cba' |
SEARCH |
يُرجع موضع أول حرف يظهر عنده نص البحث داخل النص المصدر؛ ويُرجع 0 إذا لم يُعثر عليه. |
SEARCH(Text, Search Text) |
Text — النص المراد البحث فيه.Search Text — النص المراد البحث عنه. | SEARCH('a b c test', 'test') = 7SEARCH('none', 'test') = 0 |
REPLACE |
يبحث عن جزء من نص داخل سلسلة نصية ويستبدل كل تكرار له بنص آخر. | REPLACE(Source Text, Search Text, Replacement Text) |
Source Text — النص الأصلي.Search Text — النص المراد إيجاده.Replacement Text — النص البديل. | REPLACE('test a b c test', 'test', '1') = '1 a b c 1' |
REGEX_REPLACE |
يستبدل كل تطابق لنمط تعبير نمطي (regex) داخل النص بنص بديل. | REGEX_REPLACE(Text, Pattern, Replacement) |
Text — النص الأصلي.Pattern — التعبير النمطي المراد مطابقته.Replacement — النص المراد إدراجه بدلًا من كل تطابق. | REGEX_REPLACE('abc', 'a', '1') = '1bc' |
T |
يُرجع القيمة إذا كانت نصًا؛ ويُرجع قيمة فارغة إذا لم تكن كذلك. | T(Value) |
Value — القيمة المراد فحصها. | T(10) = (فارغ)T('Hello') = 'Hello' |
TOTEXT |
يحوّل قيمة (رقم، تاريخ، قيمة منطقية، إلخ) إلى نص. | TOTEXT(Value) |
Value — القيمة المراد تحويلها. | TOTEXT(10) = '10' |