列印      開啟 PDF 版的線上說明


上一個主題

下一個主題

Duration

Expression Builder 中的 Duration 函數會傳回數字,以天數或一部分天數來表示期間 (如期間引數所示)。

語法

Duration(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)。
  • 不支援指定秒數。
  • 如果年數、月數、天數、小時數或分鐘數為零,您可以省略該數字及其對應的指定項。
  • 如果期間中沒有任何時間元件,則期間中不可以包含 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的相關資訊,請參閱下列主題:


2018年8月 Copyright © 2005, 2018, Oracle 及/或其關係機構。版權所有. Legal Notices.