Imprimir      Abrir versão PDF da ajuda online


Tópico anterior

Tópico seguinte

Duration

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

Sintaxe

Duration(período)

Tipo de resultado

Número

Argumentos

A tabela seguinte descreve os argumentos para a função.

Argumento

Descrição

período

Especifica o período que deve ser devolvido. O valor pode ser um literal de uma cadeia no formato PnYnMnDTnHnM ou uma expressão que avalia para uma cadeia no formato PnYnMnDTnHnM.

Na cadeia PnYnMnDTnHnM:

  • P é o indicador do 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, imagine que pretende especificar um período de 50 meses. Pode especificar o período como um literal de cadeia, por exemplo, como P4Y2M ou como P50M. Em alternativa, se pretender especificar um período que varia em função de um valor num campo, pode utilizar esse campo numa expressão no argumento.

No exemplo seguinte, o Período de Adiamento é um campo customizado configurado para armazenar um valor para um período em meses. O valor no campo Período do Adiamento é utilizado para calcular o período:

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

Assim, se o valor no campo Período de Adiamento for 12, a expressão avalia para P12M, que é uma cadeia válida para o argumento. Se o valor no campo Período de Adiamento for 50, a expressão avalia para P50M, que também é uma cadeia válida.

Pode especificar vários anos, meses, dias, horas ou minutos no literal da cadeia. Da mesma forma, se o argumento contiver uma expressão, não existe um limite para o número que pode ser devolvido pela expressão.

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

  • Não especifique um sinal de adição (+) para valores positivos.
  • Pode especificar uma duração negativa como -Duration(período) ou Duration(-período).
  • A especificação dos segundos não é suportada.
  • Se o número de anos, meses, dias, horas ou minutos for zero, poderá omitir o número e o respetivo designador correspondente.
  • Se nenhum dos componentes de hora estiver presente no período, o designador T não poderá ser incluído no período.
  • O designador P deve estar sempre presente no período.

Exemplos

Seguem-se 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 tópicos seguintes para obter informações do Expression Builder relacionadas:


Publicado em Agosto 2018 Copyright © 2005, 2018, Oracle. Todos os direitos reservados. Legal Notices.