date_trunc دالة

ينطبق على: Databricks SQL Databricks Runtime

إرجاع الطابع الزمني المقتطع إلى الوحدة المحددة في unit.

بناء الجملة

date_trunc(unit, expr)

الوسيطات

• unitSTRING: قيمة حرفية.
• expr: أو DATETIMESTAMPأو STRING بتنسيق طابع زمني صالح.

المرتجعات

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

الدالات ذات الصلة

• الدالة trunc