Imprimir      Abrir versão PDF da ajuda online


Tópico anterior

Tópico seguinte

Duração

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

Sintaxe

Duração(período)

Tipo de resultado

Número

Argumentos

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

Argumento

Descrição

Período

Um literal de cadeia de caracteres no formato PnYnMnDTnHnM:

onde:

  • P é o indicador do 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

Repare nos seguintes pontos:

  • Não especifique um sinal de adição (+) para valores positivos.
  • Pode especificar uma duração negativa como -Duração(Período).
  • A especificação dos segundos não é suportada.
  • 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, poderá omitir o número e o respectivo designador correspondente.
  • Se o número de anos, meses ou dias for zero e o componente de hora for um valor diferente de zero, tem de estar presente, pelo menos, um dos componentes de ano, mês ou dia (um número e respectivo designador).
  • 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')

Duração('P1D')

Duração('P0Y0M0DT0H0M')

Duração('P0DT1M')

Tópicos relacionados

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


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