التابع هو حقل مرن يمنحك الأدوات التي تحتاجها لتشكيل بياناتك بمرونة عالية.
إليك بعض الأشياء التي تحتاج إلى معرفتها قبل البدء في استخدام الدوال:
| الاسم | الوظيفة | كيفية الاستخدام | أمثلة | النتيجة |
| الدمج | يدمج العديد من السلاسل في سلسلة أطول، ويمكن كتابته بطريقتين مختلفتين. | Concat([نص 1],[نص 2],...,[نص n]) | Concat({{الاسم الأول}} ,” ” ,”اسم العائلة” ) | جاك كلينجر |
| الطول | يحسب عدد الأحرف في نص. | Len([نص]) | Len(”أرنولد” ) | 6 |
|
Len({{الاسم الأول}}
)
*بناءً على أن الاسم الأول هو "أرنولد" في هذا المثال |
6 | |||
| اليسار | يعيد عددًا محددًا من الأحرف من بداية النص. | Left([نص],[عدد الأحرف]) | Left(”أرنولد”,3 ) | Arn |
|
Left({{الاسم الأول}},3 )
*بناءً على أن الاسم الأول هو "أرنولد" في هذا المثال |
Arn | |||
| اليمين | يعيد عددًا محددًا من الأحرف من نهاية النص. | Right([نص] , [عدد الأحرف]) | Right(”أرنولد”,3 ) | Old |
|
Right({{الاسم الأول}},3 )
*بناءً على أن الاسم الأول هو "أرنولد" في هذا المثال |
Old | |||
| Substring | هو العكس تمامًا لـ Left()، حيث يقوم بإزالة أول n حرفًا ويعيد باقي النص | Substring([النص] , [n]) * n هو عدد الأحرف التي سيتم إزالتها | Substring(“ABCDEFG”,2 ) | CDEFG |
| Index Of | يعيد موقع السلسلة في سلسلة أكبر، حيث يعتبر الحرف الأول 0، والحرف الثاني 1، وهكذا. | Indexof([البحث في],[البحث عن]) | IndexOf(“ABCDEFG” , ”CDE” ) | 2 * يُعتبر الحرف الثالث 2 لأننا نبدأ العد من 0 |
| IndexOf(“ABCDEFG” , ”A” ) | 0 * يُعتبر الحرف الأول 0 | |||
| IndexOf(“ABCDEFG” , ”L” ) | -1 * إذا لم يتم العثور على السلسلة، يُعيد -1 لأنه لا يوجد فهرس لها | |||
| Replace | للبحث عن سلسلة فرعية واستبدالها بسلسلة أخرى | Replace([البحث في],[البحث عن],[الاستبدال ب]) | IndexOf(“ABCDEFG” , ”CD” , ”LM” ) | ABLMEFG |
| Trim | يزيل المسافات الفارغة من بداية ونهاية النص. | Trim([النص]) | Trim(” مرحبًا! ” ) | “مرحبًا!” |
| Trimleft | يزيل المسافات الفارغة من بداية النص. | Trimleft([النص]) | Trimleft(” مرحبًا! ” ) | “مرحبًا! ” |
| Trimright | يزيل المسافات الفارغة من نهاية النص. | Trimright([النص]) | Trimright(” مرحبًا! ” ) | “ مرحبًا!” |
| Coalesce | يُرجى القيام بتحديد القيمة الأولى التي ليست فارغة من بين مجموعة من المعلمات | Coalesce([المعلمة 1],[المعلمة 2],.....,[المعلمة n]) | Format(,,1 ,”Mike” , ,) | 1 |
| الاسم | الوظيفة | كيفية الاستخدام | الأمثلة | النتيجة |
| الآن | يعيد التاريخ والوقت الحالي اعتمادًا على توقيت مساحة العمل. | الآن() | - | |
| الآن بتوقيت UTC | يعيد التاريخ والوقت الحالي في توقيت UTC، أي غرينتش+0. | NowUTC() * سيعمل هذا بشكل صحيح إذا كان نوع الحقل هو نص، إذا كان نوع الحقل تاريخًا، سيكون مشابهًا لـ now() | - | |
| اليوم | يعيد التاريخ الحالي اعتمادًا على توقيت مساحة العمل. | اليوم() | - | |
| اليوم بتوقيت UTC | يعيد التاريخ الحالي في توقيت UTC، أي غرينتش+0. | TodayUTC() * سيعمل هذا بشكل صحيح إذا كان نوع الحقل هو نص، إذا كان نوع الحقل تاريخًا، سيكون مشابهًا لـ Today() | - | |
| الشهر | يعيد الشهر من تاريخ معين | الشهر([تاريخ]) | الشهر(“2012-12-31” ) | 12 |
| اسم الشهر | يعيد اسم الشهر من رقم الشهر | اسمالشهر([الرقم]) | اسمالشهر(12 ) | ديسمبر |
| اسمالشهر(الشهر(“2012-12-31”) ) | ديسمبر | |||
| اسم الشهر المختصر | يعيد الاسم المختصر للشهر من رقم الشهر | اسمالشهرالمختصر([الرقم]) | اسمالشهرالمختصر(12 ) | ديسمبر |
| اسمالشهرالمختصر(الشهر(“2012-12-31”) ) | ديسمبر | |||
| السنة | يعيد السنة من تاريخ معين كرقم | السنة([تاريخ]) | السنة(“2023-01-22” ) | 2023 |
| التنسيق | لإعطاء تنسيق معين لتاريخ معين | التنسيق([تاريخ],[تنسيق]) | التنسيق(“2023-01-22” ,”yyyy-MMM-dd” ) | 2023-يناير-22 |
| التنسيق(“2023-01-22” , ”yyyy.dd.m” ) | 2023.22.1 | |||
| إنشاء تاريخ | لإنشاء تاريخ من سنة وشهر ويوم محدد | إنشاءتاريخ([سنة],[شهر],[يوم]) | إنشاءتاريخ(2023 ,8 ,23 ) | 2023-08-23 |
| طرح التاريخ | يعيد عدد الأيام بين تاريخين | طرحالتاريخ([تاريخ 2],[تاريخ 1]) * يجب أن يكون تاريخ 2 أكبر من تاريخ 1 وإلا سيكون النتيجة سالبة | طرحالتاريخ(“2023-08-23” , ”2023-08-18” ) | 5 |
| طرح الوقت | يعيد عدد الدقائق بين تاريخين | طرحالوقت([تاريخ 2],[تاريخ 1]) * يجب أن يكون تاريخ 2 أكبر من تاريخ 1 وإلا سيكون النتيجة سالبة | طرحالوقت(“2023-08-23 12:00” , ”2023-08-23 10:00” ) | 120 |
| طرحالوقت(“2023-08-23 12:00” , ”2023-08-23 10:00” ) / 60 | 2 * تم قسم النتيجة على 60 للحصول على عدد الساعات بدلاً من الدقائق | |||
| الحصول على أيام العمل | يعيد عدد أيام العمل (الأيام العملية) بين تاريخين |
الحصولعلىأيامالعمل([تاريخ البداية],[تاريخ النهاية],[أول يوم من الأسبوع (اختياري)],[طول عطلة نهاية الأسبوع (اختياري)])
* يجب أن يكون تاريخ النهاية أكبر من تاريخ البداية وإلا سيكون |
3 |
