Imprimir      Abrir versión PDF de ayuda en línea


Tema anterior

Tema siguiente

Duration

La función Duration de Expression Builder devuelve un número que indica el periodo, en días o fracciones de días, que indica el argumento period.

Sintaxis

Duration(period)

Tipo de resultado

Número

Argumentos

En la tabla siguiente se describen los argumentos de esta función.

Argumento

Descripción

período

Especifica el período que se va a devolver. El valor puede ser un literal de cadena en el formato PnYnMnDTnHnM, o una expresión que se evalúa como una cadena en el formato PnYnMnDTnHnM.

En la cadena PnYnMnDTnHnM:

  • P es el indicador del periodo
  • nY especifica el número de años
  • nM especifica el número de meses
  • nD especifica el número de días
  • T separa las especificaciones de fecha y hora
  • nH especifica el número de horas
  • nM especifica el número de minutos

Por ejemplo, supongamos que desea especificar un período de 50 meses. Puede especificar el período como un literal de cadena, por ejemplo, como P4Y2M, o como P50M. Como alternativa, si desea especificar un período que varía en función del valor de un campo, puede utilizar ese campo en una expresión en el argumento.

En el siguiente ejemplo, Período diferido es un campo personalizado que está configurado para almacenar un valor para un período en meses. El valor del campo Período diferido se utiliza para calcular el período:

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

Por lo tanto, si el valor del campo Período diferido es 12, la expresión se evalúa en P12M, que es una cadena válida para el argumento. Si el valor del campo Período diferido es 50, la expresión se evalúa en P50M, que también es una cadena válida.

Puede especificar cualquier número de años, meses, días, horas o minutos en el literal de cadena. Del mismo modo, si el argumento contiene una expresión, no hay límite para el número que pueda devolver la expresión.

Las siguientes consideraciones se aplican al argumento de período:

  • No especifique un signo más (+) para los valores positivos.
  • Puede especificar una duración negativa como -Duration(period) o Duration(-period).
  • No se soporta la especificación de segundos.
  • Si el número de años, meses, días, horas o minutos es cero, puede omitir el número y su designador correspondiente.
  • Si ninguno de los componentes están presentes en el periodo, el designador T no se debe incluir en el periodo.
  • El designador P siempre debe estar presente en el periodo.

Ejemplos

A continuación se muestran ejemplos válidos de la función 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’)

Temas relacionados

Consulte los siguientes temas para obtener información relacionada con Expression Builder:


Publicado en agosto 2018 Copyright © 2005, 2018, Oracle. Todos los derechos reservados. Legal Notices.