Share via

date_add وظيفه

  • مقالة

ينطبق على:وضع علامة Databricks SQL وضع علامة Databricks Runtime 13.3 LTS وما فوق

value إضافة و unit إلى طابع exprزمني . هذه الدالة هي مرادف للدالة timestampadd.

بناء الجملة

date_add(unit, value, expr)

unit
 { MICROSECOND |
   MILLISECOND |
   SECOND |
   MINUTE |
   HOUR |
   DAY | DAYOFYEAR |
   WEEK |
   MONTH |
   QUARTER |
   YEAR }

الوسيطات

  • unit: وحدة قياس.
  • value: تعبير رقمي مع عدد units لإضافته إلى expr.
  • expr: تعبير الطابع الزمني.

المرتجعات

طابع زمني.

إذا كانت value سالبة، يتم طرحها من expr. إذا كان unit هو MONTH، QUARTERأو YEAR ، فسيتم تعديل جزء اليوم من النتيجة لينتج عنه تاريخ صالح.

ترجع الدالة خطأ تجاوز إذا كانت النتيجة تتجاوز النطاق المدعوم من الطوابع الزمنية.

الأمثلة

> SELECT date_add(MICROSECOND, 5, TIMESTAMP'2022-02-28 00:00:00');
 2022-02-28 00:00:00.000005

-- March 31. 2022 minus 1 month yields February 28. 2022
> SELECT date_add(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
 2022-02-28 00:00:00.000000