打印      打开 PDF 版本的联机帮助


上一主题

下一主题

Duration

Expression Builder 中的 Duration 函数返回一个数值,表示用 period 参数指明的天数或不足一天的时间间隔表示的期间。

语法

Duration(period)

结果类型

数字

参数

下表说明该函数的参数。

参数

说明

period

指定要返回的期间。值可以是格式为 PnYnMnDTnHnM 的字符串字面值,或者是表达式(其计算结果是格式为 PnYnMnDTnHnM 的字符串)。

在 PnYnMnDTnHnM 字符串中:

  • P 是期间指示符。
  • nY 指定年数
  • nM 指定月数
  • nD 指定天数
  • T 用来分隔日期规范和时间规范。
  • nH 指定小时数
  • nM 指定分钟数

例如,假定您想要指定 50 个月的期间。您可通过字符串字面值的形式指定期间,例如 P4Y2M 或 P50M。或者,如果您想要指定视字段值而定的期间,则可以在表达式的参数中使用该字段。

在以下示例中,推断期间是设置为存储期间值(月)的定制字段。“推断期间”字段中的值用于计算期间:

Duration('P'+ FieldValue([{nDeferral_Period}])+'M')

因此,如果“推断期间”字段中的值为 12,那么表达式的计算结果为 P12M,这是有效的参数字符串。如果“推断期间”字段中的值为 50,那么表达式的计算结果为 P50M,这也是有效的字符串。

您可以在字符串字面值中指定任意数量的年、月、天、小时或分钟。同样,如果参数包含表达式,则对于表达式可返回的数量没有限制。

以下注意事项适用于期间参数:

  • 不要为正值指定加号 (+)。
  • 您可通过 -Duration(Period) 或 Duration(-period) 的形式指定负持续时间。
  • 不支持指定秒数。
  • 如果年数、月数、天数、小时数或分钟数为 0,您可以省略数值和对应的指示符。
  • 如果在期间中没有时间部分,则期间中不能包括 T 指示符。
  • 在期间中必须始终存在 P 指示符。

示例

以下是 Duration 函数的有效示例:

Duration('P0Y1M1DT2H5M')

Duration('P0Y0DT1H')

Duration('P1D')

Duration('P0Y0M0DT0H0M')

Duration('P0DT1M')

Duration('P24M')

Duration('P500D')

Duration('P'+ FieldValue([{nDeferral_Period}])+'M')

Duration(‘PT1000H3M’)

Duration(‘-P1Y200M’)

相关主题

请参阅以下主题以了解相关的 Expression Builder 信息:


已发布 8月 2018 Copyright © 2005, 2018, Oracle. 保留所有权利。Legal Notices.