Imprimir      Abrir a versão em PDF da Ajuda on-line


Tópico anterior

Próximo tópico

Duration

A função Duration no Expression Builder retorna um número que indica um período em dias ou frações de dias, como indicado pelo argumento de período.

Sintaxe

Duration(period)

Tipo de resultado

Número

Argumentos

A tabela a seguir descreve os argumentos da função.

Argumento

Descrição

period

Especifica o período que deverá ser retornado. O valor pode ser uma string literal no formato PnYnMnDTnHnM ou uma expressão que seja avaliada como uma string no formato PnYnMnDTnHnM.

Na string PnYnMnDTnHnM:

  • P é o indicador de período
  • nY especifica o número de anos
  • nM especifica o número de meses
  • nD especifica o número de dias
  • T separa as especificações de data e hora
  • nH especifica o número de horas
  • nM especifica o número de minutos

Por exemplo, suponha que você queira especificar um período de 50 meses. Você pode especificar o período como uma string literal; por exemplo, como P4Y2M ou P50M. Alternativamente, se quiser especificar um período que varie de acordo com um valor em um campo, você poderá usar esse campo em uma expressão no argumento.

No exemplo a seguir, o Período de diferimento está em um campo personalizado configurado para armazenar um valor para um período em meses. O valor no campo Período de diferimento é usado para calcular o período:

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

Então, se o valor no campo Período de diferimento for 12, a expressão será avaliada como P12M, que é uma string válida para o argumento. Se o valor no campo Período de diferimento for 50, a expressão será avaliada como P50M, que também é uma string válida.

Você pode especificar qualquer número de anos, meses, dias, horas ou minutos na string literal. Da mesma forma, se o argumento contiver uma expressão, não haverá limite quanto ao número que pode ser retornado pela expressão.

As considerações a seguir aplicam-se ao argumento do período:

  • Não use um sinal de mais (+) para valores positivos.
  • Você pode especificar uma duração negativa como -Duration(Period) ou Duration(-period).
  • Não é suportado especificar segundos.
  • Se o número de anos, meses, dias, horas ou minutos for zero, é possível omitir o número e seu designador correspondente.
  • Se nenhum componente de data/hora estiver presente no período, o designador T não deve ser incluído no período.
  • O designador P sempre deve estar presente no período.

Exemplos

Seguem exemplos válidos da função 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’)

Tópicos relacionados

Consulte os seguintes tópicos para obter informações relacionadas ao Expression Builder:


Publicado em Setembro de 2017 Copyright © 2005, 2017, Oracle. Todos os direitos reservados. Legal Notices.