التابع هو حقل مرن يمنحك الأدوات التي تحتاجها لتشكيل بياناتك بمرونة عالية.
إليك بعض الأشياء التي تحتاج إلى معرفتها قبل البدء في استخدام الدوال:
| الاسم | الوظيفة | كيفية الاستخدام | أمثلة | النتيجة |
| Concatenate | يقوم بدمج العديد من النصوص في نص أطول ويمكن كتابته بطريقتين مختلفتين. | ([Text 1],[Text 2],...,[Text n])Concat | Concat({{First Name}} ,” ” ,”Last Name” ) | Jack Klinger |
| Length | يحسب عدد الأحرف في النص. | ([Text])Len | Len(”Arnold” ) | 6 |
|
Len({{First Name}}
)
*Given that the first name is “Arnold” in this example |
6 | |||
| Left | يعيد عددًا معينًا من الأحرف من بداية النص. | ([Text],[Number of characters])Left | Left(”Arnold”,3 ) | Arn |
|
Left({{First Name}},3 )
*Given that the first name is “Arnold” in this example |
Arn | |||
| Right | يعيد عددًا معينًا من الأحرف من نهاية النص. | ([Text],[Number of characters])Right | Right(”Arnold”,3 ) | Old |
|
Right({{First Name}},3 )
*Given that the first name is “Arnold” in this example |
Old | |||
| Substring | هي عكس Left() تمامًا، حيث تزيل أول n من الأحرف وتعطي باقي النص. | ([text],[n])Substring * n هي عدد الأحرف التي سيتم إزالتها | Substring(“ABCDEFG”,2 ) | CDEFG |
| Index Of | يعيد موضع سلسلة نصية في سلسلة نصية أكبر، حيث يُحسب الحرف الأول كـ 0، والثاني كـ 1، وهكذا. | ([Search In],[Search For])Indexof | IndexOf(“ABCDEFG” , ”CDE” ) | 2 * الحرف الثالث يعيد كـ 2 لأن العد يبدأ من 0 |
| IndexOf(“ABCDEFG” , ”A” ) | 0 * الحرف الأول يعيد كـ 0 | |||
| IndexOf(“ABCDEFG” , ”L” ) | -1 * إذا لم يتم العثور على السلسلة النصية فإنه يعيد -1 لأنها لا تحتوي على فهرس | |||
| Replace | للبحث عن سلسلة نصية واستبدالها بسلسلة نصية أخرى. | ([Search In],[Search For],[Substitute With])Replace | IndexOf(“ABCDEFG” , ”CD” , ”LM” ) | ABLMEFG |
| Trim | يزيل الفراغات الفارغة من بداية ونهاية النص. | ([Text])Trim | Trim(” Hello There! ” ) | “!Hello There” |
| Trimleft | يزيل الفراغات الفارغة من بداية النص. | ([Text])Trimleft | Trimleft(” Hello There! ” ) | “!Hello There ” |
| Trimright | يزيل الفراغات الفارغة من نهاية النص. | ([Text])Trimright | Trimright(” Hello There! ” ) | “ !Hello There” |
| Coalesce | يعيد أول قيمة غير خالية من مجموعة المعلمات. | ([Param 1],[Param 2],.....,[Param n])Coalesce | Format(,,1 ,”Mike” , ,) | 1 |
| الاسم | الوظيفة | كيفية الاستخدام | أمثلة | النتيجة |
| Now | يعيد التاريخ والوقت الحاليين اعتمادًا على المنطقة الزمنية لمكان العمل. | ()Now | - | |
| Now UTC | يعيد التاريخ والوقت الحاليين في التوقيت العالمي المنسق (UTC)، أي GMT+0. | ()NowUTC * سيعمل هذا بشكل صحيح فقط إذا كان نوع الحقل نصًا، إذا كان نوع الحقل تاريخًا فسيعمل مثل Now() | - | |
| Today | يعيد التاريخ الحالي اعتمادًا على المنطقة الزمنية لمكان العمل. | ()Today | - | |
| Today UTC | يعيد التاريخ الحالي في التوقيت العالمي المنسق (UTC)، أي GMT+0. | ()TodayUTC * سيعمل هذا بشكل صحيح فقط إذا كان نوع الحقل نصًا، إذا كان نوع الحقل تاريخًا فسيعمل مثل Today() | - | |
| Month | يعيد [تاريخ] من الشهر معين. | ([تاريخ])Month | Month(“2012-12-31” ) | 12 |
| Month Name | يعيد [رقم] من اسم الشهر. | ([رقم])MonthName | MonthName(12 ) | December |
| MonthName(Month(“2012-12-31”) ) | December | |||
| Short Month Name | يعيد [رقم] من الاسم المختصر للشهر. | ([رقم])ShortMonthName | ShortMonthName(12 ) | Dec |
| ShortMonthName(Month(“2012-12-31”) ) | Dec | |||
| Year | يعيد [تاريخ] من السنة معين كرقم. | ([تاريخ])Year | Year(“2023-01-22” ) | 2023 |
| Format | يعطي [تاريخ] معين لـتنسيق محدد. | ([تنسيق],[تاريخ])Format | Format(“2023-01-22” ,”yyyy-MMM-dd” ) | 2023-Jan-22 |
| Format(“2023-01-22” , ”yyyy.dd.m” ) | 2023.22.1 | |||
| Create Date | لإنشاء [السنة] و[الشهر] و[اليوم] من تاريخ. | ([اليوم],[الشهر],[السنة])CreateDate | CreateDate(2023 ,8 ,23 ) | 2023-08-23 |
| Subtract Date | يعيد [تاريخ 1] و[تاريخ 2] من عدد الأيام بين. | ([تاريخ 1],[تاريخ 2])SubtractDate * يجب أن يكون [تاريخ 2] أكبر من [تاريخ 1] وإلا ستكون النتيجة سلبية | SubtractDate(“2023-08-23” , ”2023-08-18” ) | 5 |
| Subtract Time | يعيد [تاريخ 1] و[تاريخ 2] من عدد الدقائق بين. | ([تاريخ 1],[تاريخ 2])SubtractTime * يجب أن يكون [تاريخ 2] أكبر من [تاريخ 1] وإلا ستكون النتيجة سلبية | SubtractTime(“2023-08-23 12:00” , ”2023-08-23 10:00” ) | 120 |
| SubtractTime(“2023-08-23 12:00” , ”2023-08-23 10:00” ) / 60 | 2 * تم تقسيم النتيجة على 60 للحصول على عدد الساعات بدلاً من الدقائق | |||
| Get Working Days | يعيد [تاريخ النهاية] و[تاريخ البداية] من عدد أيام العمل (الأيام التجارية) بين. |
([أول يوم في الأسبوع (اختياري)],[طول عطلة نهاية الأسبوع (اختياري)],[تاريخ النهاية],[تاريخ البداية])GetWorkingDays
* يجب أن يكون [تاريخ النهاية] أكبر من [تاريخ البداية] وإلا ستكون النتيجة سلبية * يأخذ أول يوم في الأسبوع رقمًا بين 1 و 7، الافتراضي هو 1 وهو الاثنين، و 7 هو الأحد * طول عطلة نهاية الأسبوع هو عدد الأيام في عطلة نهاية الأسبوع، وهو يومان بشكل افتراضي |
GetWorkingDays(“2023-09-25” , ”2023-09-27 ” ) | 3 |
