dateadd
دالة
ينطبق على: Databricks SQL Databricks Runtime 10.4 LTS وما فوق
value
unit
يضيف s إلى طابع expr
زمني . هذه الدالة هي مرادف للدالة timestampadd.
بناء الجملة
dateadd(unit, value, expr)
unit
{ MICROSECOND |
MILLISECOND |
SECOND |
MINUTE |
HOUR |
DAY | DAYOFYEAR |
WEEK |
MONTH |
QUARTER |
YEAR }
الوسيطات
unit
: وحدة قياس.value
: تعبير رقمي مع عددunit
s لإضافته إلىexpr
.expr
: تعبير الطابع الزمني.
المرتجعات
طابع زمني.
إذا كانت value
سالبة، يتم طرحها من expr
.
إذا كان unit
هو MONTH
، QUARTER
أو YEAR
، تعديل جزء اليوم من النتيجة لينتج عنه تاريخ صالح.
ترجع الدالة خطأ تجاوز إذا كانت النتيجة تتجاوز النطاق المدعوم من الطوابع الزمنية.
الأمثلة
> SELECT dateadd(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 dateadd(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
2022-02-28 00:00:00.000000