date_trunc
وظيفه
ينطبق على: التحقق من Databricks SQL Databricks Runtime
إرجاع الطابع الزمني المقتطع إلى الوحدة المحددة في unit
.
بناء الجمله
date_trunc(unit, expr)
الحجج
unit
STRING
: قيمة حرفية.expr
: أوDATE
TIMESTAMP
أوSTRING
بتنسيق طابع زمني صالح.
ارجاع
A TIMESTAMP
.
تلاحظ
الوحدات الصالحة ل unit
هي (غير حساسة لحالة الأحرف):
'YEAR'
، ،'YYYY'
'YY'
: اقتطاع إلى التاريخ الأول من السنة التيexpr
يقع فيها، سيكون الجزء الزمني صفرا'QUARTER'
: اقتطاع إلى التاريخ الأول من ربع السنة الذيexpr
يقع فيه الجزء الزمني سيكون صفرا'MONTH'
، ،'MM'
'MON'
: اقتطاع إلى التاريخ الأول من الشهر الذيexpr
يقع فيه الجزء الزمني سيكون صفرا'WEEK'
: اقتطاع يوم الاثنين من الأسبوع الذيexpr
يقع فيه، وسيكون الجزء الزمني صفرا'DAY'
،'DD'
: صفر خارج الجزء الزمني'HOUR'
: صفر خارج الدقيقة والثانية مع جزء الكسر'MINUTE'
: صفر خارج الثاني مع جزء الكسر'SECOND'
: صفر خارج جزء الكسر الثاني'MILLISECOND'
: صفر خارج الميكرو ثانية'MICROSECOND'
: يبقى كل شيء
unit
إذا لم يكن مكونا بشكل جيد، ترجع NULL
الدالة .
امثله
> SELECT date_trunc('YEAR', '2015-03-05T09:32:05.359');
2015-01-01 00:00:00
> SELECT date_trunc('MM', '2015-03-05T09:32:05.359');
2015-03-01 00:00:00
> SELECT date_trunc('DD', '2015-03-05T09:32:05.359');
2015-03-05 00:00:00
> SELECT date_trunc('HOUR', '2015-03-05T09:32:05.359');
2015-03-05 09:00:00
> SELECT date_trunc('MILLISECOND', '2015-03-05T09:32:05.123456');
2015-03-05 09:32:05.123
-- Not a recognised unit
> SELECT date_trunc('MS', '2015-03-05T09:32:05.123456');
NULL