إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على:
Databricks SQL
Databricks Runtime 10.4 LTS وما فوق
إرجاع مجموع expr1 و expr2أو NULL في حالة حدوث خطأ.
بناء الجملة
try_add ( expr1 , expr2 )
يمكن أيضا استدعاء هذه الدالة كدالة نافذة باستخدام العبارة OVER .
الوسيطات
expr1: تعبير رقمي أو تاريخ أو طابع زمني أو فاصل زمني.expr2: إذا كانexpr1عبارة عنexpr2رقم يجب أن يكون تعبيرا رقميا أو فاصلا زمنيا بخلاف ذلك.
المرتجعات
- إذا كان
expr1رقميا، فإن النوع الأقصى الشائع للوسيطات. - إذا كان
expr1عبارة عن DATE وكانexpr2عبارة عن فاصل زمني لليوم، تكون النتيجة TIMESTAMP. - إذا كانت
expr1وexpr2عبارة عن فترات زمنية لمدة شهر، تكون النتيجة عبارة عن فاصل زمني لمدة شهر من وحدات واسعة بما يكفي لتمثيل النتيجة. - إذا كانت
expr1وexpr2عبارة عن فواصل زمنية لليوم، تكون النتيجة فاصلا زمنيا لليوم بوحدات عريضة بما يكفي لتمثيل النتيجة. - وإلا، فإن نوع النتيجة يطابق
expr1.
إذا كان كلا التعبيرين عبارة عن فاصل زمني، فيجب أن يكونا من نفس الفئة.
إذا تجاوزت النتيجة نوع النتيجة Databricks SQL بإرجاع NULL.
عند إضافة فاصل زمني لمدة شهر إلى DATE Databricks SQL سيضمن أن التاريخ الناتج قد تم تكوينه بشكل جيد.
الأمثلة
> SELECT try_add(1, 2);
3
> SELECT try_add(DATE'2021-03-20', INTERVAL '2' MONTH);
2021-5-20
> SELECT try_add(TIMESTAMP'2021-03-20 12:15:29', INTERVAL '3' SECOND);
2021-03-20 12:15:32
> SELECT typeof(try_add(INTERVAL '3' DAY, INTERVAL '2' HOUR));
interval day to hour
> SELECT try_add(DATE'2021-03-31', INTERVAL '1' MONTH);
2021-04-30
> SELECT try_add(127Y, 1Y);
NULL