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

#### Duração A função Duração 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) ### Result Type 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: Sobre o Expression Builder Usando o Expression Builder Funções do Expression Builder

Publicado em agosto de 2022 | Copyright © 2005, 2022, Oracle e/ou suas empresas afiliadas. Legal Notices.