temporalDiff
别名:datetimeDiff
语法
temporalDiff(X, Y, [unit])
参数
X 是一个时间类型的标量、向量、矩阵,或包含时间类型列的表。
Y 是一个标量,或和 X 相同长度的向量、维度相同的矩阵或表。其类型必须与 X 严格相同。
unit 可选参数,是一个字符串标量,指定时间单位。取值可以是:
- "d" 表示自然日
- "B" 表示工作日
- 一个交易日历标识,例如 "XNYS",对应的交易日历文件必须保存在 marketHolidayDir 配置项指定的目录中。
注: 若指定 unit,X 和 Y 必须是 DATE 类型。
详情
temporalDiff
函数计算 X 和 Y 之间的时间差。
当提供 unit 参数时,时间差的计算将基于指定的时间单位(天、工作日或特定交易所的交易日)。
返回值:与 X 形状相同的标量/向量/矩阵/表。
例子
timestamps = [13:30:49,13:30:39,13:30:50,13:30:57,13:30:35]
temporalDiff(timestamps, 13:30:00)
// Output: [49,39,50,57,35]
若指定 unit 参数,X 和 Y 必须为日期(DATE)类型:
dates = [2019.12.31, 2020.01.03, 2020.01.10, 2020.01.15, 2020.01.17]
temporalDiff(dates, 2019.12.30, "d") // Output: [1,4,11,16,18]
temporalDiff(dates, 2019.12.30, "B") // Output: [1,4,9,12,14]
temporalDiff(dates, 2019.12.30, "XNYS") // Output: [1,3,8,11,13]