Timestamp subtract（时间戳减法(Timestamp subtract)）¶

Supported in: Batch, Faster, Streaming

Subtract value from timestamp in specified unit.

Expression categories: Datetime

Declared arguments¶

Timestamp: Timestamp that will be modified.
Expression\
Unit: Time unit.
Enum\
Value to subtract: Value that is subtracted from timestamp.
Expression\

Output type: Timestamp

Examples¶

Example 1: Base case¶

Argument values:

Timestamp: 2022-02-02T00:00:00Z
Unit: DAYS
Value to subtract: 1

Output: 2022-02-01T00:00:00Z

Example 2: Base case¶

Argument values:

Timestamp: 2022-02-02T00:00:00Z
Unit: HOURS
Value to subtract: 2

Output: 2022-02-01T22:00:00Z

Example 3: Base case¶

Argument values:

Timestamp: 2022-02-02T00:00:00Z
Unit: MILLISECONDS
Value to subtract: 2

Output: 2022-02-01T23:59:59.998Z

Example 4: Base case¶

Argument values:

Timestamp: 2022-02-02T00:00:00Z
Unit: MINUTES
Value to subtract: 2

Output: 2022-02-01T23:58:00Z

Example 5: Base case¶

Argument values:

Timestamp: 2022-02-01T00:00:00Z
Unit: MONTHS
Value to subtract: 2

Output: 2021-12-01T00:00:00Z

Example 6: Base case¶

Argument values:

Timestamp: 2022-02-01T00:00:00Z
Unit: QUARTERS
Value to subtract: 2

Output: 2021-08-01T00:00:00Z

Example 7: Base case¶

Argument values:

Timestamp: 2022-02-02T00:00:00Z
Unit: SECONDS
Value to subtract: 5

Output: 2022-02-01T23:59:55Z

Example 8: Base case¶

Argument values:

Timestamp: 2022-02-01T00:00:00Z
Unit: YEARS
Value to subtract: 2

Output: 2020-02-01T00:00:00Z

Example 9: Null case¶

Argument values:

Timestamp: date
Unit: YEARS
Value to subtract: value

date	value	Output
2022-02-01T00:00:00Z	null	null
null	2	null
null	null	null

中文翻译¶

时间戳减法(Timestamp subtract)¶

支持：批处理(Batch)、快速处理(Faster)、流处理(Streaming)

按指定单位从时间戳中减去数值。

表达式类别： 日期时间(Datetime)

声明的参数¶

时间戳(Timestamp)： 将被修改的时间戳。
表达式\
单位(Unit)： 时间单位。
枚举\
要减去的数值(Value to subtract)： 从时间戳中减去的数值。
表达式\

输出类型： Timestamp

示例¶

示例1：基本情况¶

参数值：

时间戳： 2022-02-02T00:00:00Z
单位： DAYS
要减去的数值： 1

输出： 2022-02-01T00:00:00Z

示例2：基本情况¶

参数值：

时间戳： 2022-02-02T00:00:00Z
单位： HOURS
要减去的数值： 2

输出： 2022-02-01T22:00:00Z

示例3：基本情况¶

参数值：

时间戳： 2022-02-02T00:00:00Z
单位： MILLISECONDS
要减去的数值： 2

输出： 2022-02-01T23:59:59.998Z

示例4：基本情况¶

参数值：

时间戳： 2022-02-02T00:00:00Z
单位： MINUTES
要减去的数值： 2

输出： 2022-02-01T23:58:00Z

示例5：基本情况¶

参数值：

时间戳： 2022-02-01T00:00:00Z
单位： MONTHS
要减去的数值： 2

输出： 2021-12-01T00:00:00Z

示例6：基本情况¶

参数值：

时间戳： 2022-02-01T00:00:00Z
单位： QUARTERS
要减去的数值： 2

输出： 2021-08-01T00:00:00Z

示例7：基本情况¶

参数值：

时间戳： 2022-02-02T00:00:00Z
单位： SECONDS
要减去的数值： 5

输出： 2022-02-01T23:59:55Z

示例8：基本情况¶

参数值：

时间戳： 2022-02-01T00:00:00Z
单位： YEARS
要减去的数值： 2

输出： 2020-02-01T00:00:00Z

示例9：空值情况¶

参数值：

时间戳： date
单位： YEARS
要减去的数值： value

date	value	输出
2022-02-01T00:00:00Z	null	null
null	2	null
null	null	null