Smartbi Insight V11帮助中心
页面树结构

版本比较

旧版本 4

changes.mady.by.user 刘芳

保存于

比较

新版本 当前版本

changes.mady.by.user 刘芳

保存于

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。


...

信息
title前置条件

计算列函数，数据库适配情况，查看：计算列函数数据库适配情况。

1、DATEADD

类别描述
函数写法

DATEADD(date,num,unit)

函数作用

在日期中添加或减去指定的时间间隔

参数说明date: 表示输入的日期、日期时间
num:可以输入正整数，也可以输入负整数；正数则是根据偏移类型，进行相加；负数则是根据偏移类型进行减法。
unit:偏移类型。
若unit=“Y"，则代表偏移年。
若unit="Q",则代表偏移季。
若unit=“M"，则代表偏移月。
若unit=“D"，则代表偏移日。
示例


1、求1个日期+N天，得到一个全新的日期:DATEADD([订单日期],10,'D') 假设[订单日期]是2024-07-05，返回的结果是2024-07-15。
2、求1个日期-N天，得到一个全新的日期:DATEADD([订单日期],-10,‘D’) 假设[订单日期]是2024-07-15，返回的结果是2024-07-05。
3、DATEADD(STRTODATE('2024-07-01','YYYY-MM-dd'),10,'D')返回'2024-07-11'。
4、DATEADD(STRTODATE('2024-07-01','YYYY-MM-dd'),-10,'D')返回'2024-06-21'。

2、DATEDIF

类别描述
函数写法

DATEDIF(startdate,enddate,unit)

函数作用

返回两个指定日期间的天数、月数或年数。

参数说明startdate：代表所指定时间段的初始日期 ，支持日期、日期时间
enddate：代表所指定时间段的终止日期，支持日期、日期时间
unit：函数返回信息的类型；
若unit=“Y"，则返回年差数；
若unit="Q",则返回季差数；
若unit=“M"，则返回月差数；
若unit=“D"，则返回日差数。
示例

1、例如想要获取[发货时间]-[下单时间]相相隔多少天，可以通过:
DATEDIF([下单时间],[发货时间],'D'),得到的结果为[发货时间]-[下单时间] 的天数差值，正数显示正数，为负数则显示负数。
2、DATEDIF(STRTODATE('2024-07-08','YYYY-MM-dd'),STRTODATE('2024-07-10','YYYY-MM-dd'),'D')返回2。

3、UNIXTIMETODATE

类别描述
函数写法

UNIXTIMETODATE(timestamp)

函数作用

把自1970年1月1日00:00:00GMT经过的秒数转成日期

参数说明timestamp:时间戳
返回值说明:有些数据库返回的值会相差8小时
示例

1、UNIXTIMETODATE(1720497600) 返回2024-07-09 12:00:00
2、UNIXTIMETODATE(1720454400) 返回2024-07-09 00:00:00


4、DATETOUNIXTIME

类别描述
函数写法

DATETOUNIXTIME(date)

函数作用

返回指定日期自1970年1月1日00:00:00GMT经过的秒数。

参数说明date:日期、日期时间
返回值说明:有些数据库返回的值会相差8小时
示例

1、DATETOUNIXTIME (STRTODATE('2008-08-08','YYYY-MM-dd'))返回：1218124800000。
2、DATETOUNIXTIME (STRTODATE('2008-08-08 18:30:13','YYYY-MM-dd HH:mm:ss'))返回：1218178213。


5.STRTODATE

类别描述
函数写法

STRTODATE(str,fmt)

函数作用

支持将文本日期转为日期类型。

参数说明str：可以文本日期、日期、日期时间格式。
fmt：日期格式，YYYY、MM、dd、HH、mm、ss 分别代表年月日时分秒。
示例
1、STRTODATE('1926-08-17 11:45:14', 'YYYY-MM-dd HH:mm:ss') 返回1926-08-17 11:45:14。
2、STRTODATE('1926-08-17', ''YYYY-MM-dd') 返回 1926-08-17。
3、STRTODATE('19260817', ''YYYYMMdd') 返回1926-08-17。

...



6.DATEFORMAT

类别描述
函数写法

DATEFORMAT(date, fmt)

函数作用

DATEFORMAT返回一个格式化的时间或日期字符串。

参数说明

date: 要进行格式转换日期、时间。

fmt:格式化，YYYY、MM、dd、HH、mm、ss 分别代表年月日时分秒。

示例1、假设有一个名为 date 的列，包含日期或日期/时间值DATEFORMAT([date],'YYYY-MM-dd')，返回每个行的日期。
3、把文本日期转成日期再格式化：DATEFORMAT(STRTODATE('1926-08-17 11:45:14','YYYY-MM-dd HH:mm:ss'), 'HH:mm:ss') 返回11:45:14。
4、把文本日期转成日期再格式化，DATEFORMAT(STRTODATE('1926-08-17 11:45:14','YYYY-MM-dd HH:mm:ss'), 'YYYY/MM/dd') 返回 1926/08/17。

...

7.DAY

类别描述
函数写法

DAY(date)

函数作用

函数用于提取日期或日期/时间表达式中的天数部分。

参数说明date:参数是一个日期或日期/时间表达式，可以是列名、变量或常量。
示例

1、DAY(‘2023-07-27’)返回2。

2、DAY('2023-07-27 09:30:00') 返回27。
3、假设有一个名为 date 的列，包含日期或日期/时间值DAY([date])，返回每个行的日期值的月份部分，也可以将 DAY() 函数与其他函数、运算符和条件一起使用，以进行更复杂的查询和计算。

...

8.MINUTE

类别描述
函数写法

MINUTE(date)

函数作用

返回某一指定时间的分钟数，其值是介于0与59之间的一个整数

参数说明date::日期、日期时间。
示例1、MINUTE('2023-10-01 14:18:20') 返回 18

...


9.HOUR

类别描述
函数写法

HOUR(date)

函数作用

返回某一指定时间的小时数。

参数说明date:日期、日期时间。
示例

1、HOUR('2023-10-01 14:18:20‘)返回14。


610.YEAR

类别描述
函数写法

YEAR(Date)

函数作用

用于提取日期或日期/时间表达式中的年份部分。它返回一个表示年份的整数值

参数说明Date: 日期、日期时间。
示例

1、YEAR(‘2023-07-27’)返回2023
2、YEAR('2023-07-27 09:30:00') 返回2023
3、假设有一个名为 date 的列，包含日期或日期/时间值YEAR([date])，返回每个行的日期值的年.



711.MONTH

类别描述
函数写法

MONTH(date)

函数作用

用于提取日期或日期/时间表达式中的月份部分。它返回一个表示月份的整数值，范围从 1 到 12，对应于一年中的不同月份

参数说明date:日期、日期时间
示例1、假设有一个名为 date 的列，包含日期或日期/时间值MONTH([date])，返回每个行的日期值的月份部分。
2、MONTH(STRTODATE('1926-08-17', 'YYYY-MM-dd')) 返回8。


812.QUARTER

类别描述
函数写法

QUARTER(date)

函数作用

根据日期获取对应季度(整数)

参数说明date:参数是一个日期或日期/时间表达式，可以是列名、变量或常量。
示例

1、QUARTER(’2017-03-07 00:00:00‘) 1。

2、QUARTER(‘2017/03/07’) 1。

...


13.SECOND

类别描述
函数写法

SECOND(date)

函数作用

获取时间中的秒数(整数)，其值是介于0与59之间的一个整数。

参数说明date:参数是一个日期或日期/时间表达式，可以是列名、变量或常量。
示例

SECOND(‘15:36:25’)返回25 。

SECOND('11:45:14')返回 14。

...


14.WEEK

类别描述
函数写法

WEEK(date)

函数作用

返回一个代表一年中的第几周的数字。

参数说明date:表示输入的日期。
示例

1、WEEK('2010/01/01') 返回53。

...


15.DAYOFYEAR

类别描述
函数写法

DAYOFYEAR(date)

函数作用

从日期获取该日为一年内的第几天。

参数说明
示例

参数说明:
date:日期、日期时间。
示例:
1、DAYOFYEAR('2023-10-01 14:18:20') 返回274。
2、DAYOFYEAR('2018-05-15') 返回135。


1216.DAYOFWEEK

类别描述
函数写法

DAYOFWEEK(date)

函数作用

从日期获取该日为一周内的第几天。

参数说明date:日期、日期时间。
示例
DAYOFWEEK
1、DAYOFWEEK('2005/09/10') 返回7。
DAYOFWEEK
2、DAYOFWEEK('2005/09/11') 返回1。

...

17.GETDATE

类别描述
函数写法

GETDATE

函数作用

获取当前系统日期

参数说明无
示例获取当前系统服务器日期getDate()，返回当前日期如'2023-01-01'