try_add دالة

إرجاع مجموع expr1 و expr2 أو NULL في حالة الخطأ.

منذ:داتابريكز وقت التشغيل 10.0

بناء الجملة

try_add ( expr1 , expr2 )

الوسيطات

  • expr1تعبير رقمي أو تاريخ أو طابع زمني أو فاصل زمني.
  • expr2إذا كان expr1 يجب أن يكون رقمي تعبير رقمي أو INTERVAL خلاف expr2 ذلك.

المرتجعات

  • إذا كان expr1 رقمي، النوع الأقصى الشائع للوسائط.
  • إذا كان expr1 تاريخا expr2 وهو فاصل زمني نهاري النتيجة هو TIMESTAMP.
  • إذا كانت expr1 و هي فترات شهر expr2 السنة تكون النتيجة فاصل شهر السنة من وحدات واسعة بما فيه الكفاية لتمثيل النتيجة.
  • إذا كانت expr1 و هي فترات زمنية يومية تكون expr2 النتيجة فاصل زمني يومي من وحدات واسعة بما فيه الكفاية لتمثيل النتيجة.
  • وإلا، فإن نوع النتيجة يتطابق expr1 مع .

إذا كان كلا التعبيرين فاصلا فيجب أن يكونا من نفس الفئة.

إذا تجاوز الناتج نوع النتائج Databricks وقت التشغيل بإرجاع NULL.

عند إضافة فاصل زمني لمدة شهر إلى وقت تشغيل DATE Databricks سوف أؤكد أن تاريخ الناتج بشكل جيد.

أمثلة

> 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