| Imprimir Abrir versão PDF da ajuda online

#### Duration A função Duração 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(period) ### 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: Duração('P'+ ValorCampo([{nPeríodo_Adiamento}])+'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 -Duração(período) ou Duração(-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 Duração: Duração('P0Y1M1DT2H5M') Duração('P0Y0DT1H') Duration('P1D') Duração('P0Y0M0DT0H0M') Duração('P0DT1M') Duration('P24M') Duration('P500D') Duração('P'+ ValorCampo([{nPeríodo_Adiamento}])+'M') Duração(‘PT1000H3M’) Duração(‘-P1Y200M’) #### Tópicos Relacionados Consulte os tópicos seguintes para obter informações do Expression Builder relacionadas: Acerca do Expression Builder Utilizar o Expression Builder Funções do Expression Builder

Publicado em Agosto 2022 | Copyright © 2005, 2022, Oracle e/ou respetivas associadas. Legal Notices.