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

Período

A literal de uma string no formato a seguir PnYnMnDTnHnM:

em que:

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

Observe os pontos a seguir:

  • Não use um sinal de mais (+) para valores positivos.
  • Você pode especificar uma duração negativa como -Duration(Period).
  • Não é suportado especificar segundos.
  • A duração máxima suportada é 'P5Y12M200DT200H59M' (ou seja, 5 anos, 12 meses, 200 dias, 200 horas e 59 minutos).
  • Se o número de anos, meses, dias, horas ou minutos for zero, é possível omitir o número e seu designador correspondente.
  • Se o número de anos, meses ou dias for zero e o componente de data/hora for um valor diferente de zero, pelo menos um componente de ano, mês ou dia (um número e seu designador) deve estar presente.
  • 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')

Tópicos relacionados

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


Publicado em Otubro de 2016 Copyright © 2005, 2016, Oracle. Todos os direitos reservados. Legal Notices.