Imprimer      Ouvrir la version PDF de l'aide en ligne


Rubrique précédente

Rubrique suivante

Duration

La fonction Duration d'Expression Builder renvoie un nombre qui indique une période en jours ou en fractions de jour, comme l'indique l'argument de période.

Syntaxe

Duration(period)

Type du résultat

Nombre

Arguments

Le tableau suivant décrit les arguments de la fonction.

Argument

Description

period

Indique la période devant être retournée. La valeur peut être un littéral de type chaîne dans le format PnYnMnDTnHnM, ou une expression correspondant à une chaîne dans le format PnYnMnDTnHnM.

Dans la chaîne PnYnMnDTnHnM :

  • P indique la période
  • nY indique le nombre d'années
  • nM indique le nombre de mois
  • nD indique le nombre de jours
  • T sépare les spécifications de date et d'heure
  • nH indique le nombre d'heures
  • nM indique le nombre de minutes

Par exemple, supposons que vous vouliez spécifier une période de 50 mois. Vous pouvez spécifier la période en tant que littéral de type chaîne, par exemple P4Y2M ou P50M. Sinon, si vous voulez spécifier une période variant en fonction d'une valeur d'un champ, vous pouvez utiliser ce champ dans une expression dans l'argument.

Dans l'exemple suivant, Période de report est un champ personnalisé défini pour stocker une valeur pour une période en mois. La valeur du champ Période de report est utilisée pour calculer la période :

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

Ainsi, si le champ Période de report a la valeur 12, l'expression correspond à P12M, qui est une chaîne valide pour l'argument. Si le champ Période de report a la valeur 50, l'expression correspond à P50M, qui est également une chaîne valide.

Dans le littéral de type chaîne, vous pouvez spécifier un nombre d'années, de mois, de jours, d'heures ou de minutes. De même, si l'argument contient une expression, il n'y a aucune limite concernant le nombre pouvant être retourné par l'expression.

Les considérations ci-après s'appliquent à l'argument de période :

  • N'indiquez pas de signe plus (+) pour les valeurs positives.
  • Vous pouvez indiquer une durée négative sous la forme -Duration(period) ou Duration(-period).
  • Les secondes ne sont pas prises en charge.
  • Si le nombre d'années, de mois, de jours, d'heures ou de minutes est égal à zéro, vous pouvez omettre le nombre et le marqueur correspondant.
  • Si aucun des composants horaires ne figure dans la période, le marqueur T ne doit pas y être inclus.
  • Le marqueur P doit toujours être présent dans la période.

Exemples

Ci-dessous figurent quelques exemples valides de la fonction 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’)

Rubriques connexes

Pour obtenir des informations sur Expression Builder, reportez-vous aux rubriques suivantes :


Publié en septembre 2017 Copyright © 2005, 2017, Oracle. Tous droits réservés. Legal Notices.