Печать      Открыть версию интерактивной справки в формате PDF


Предыдущий раздел

Следующий раздел

Duration

Функция Duration в Expression Builder возвращает число, которое показывает величину периода в днях или частях дня, соответствующего заданному аргументу period.

Синтаксис

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 Copyright © Oracle, 2005, 2018 гг. Все права защищены.Legal Notices.