FORMATÉ-DATE-HEURE

La fonction FORMATTED-DATETIME utilise un format de date et d'heure combiné pour convertir et combiner une date au format de date entier et une heure numérique exprimée en secondes après minuit en une représentation de date et d'heure formatée en fonction de ce format de date et d'heure combiné.

Le type de cette fonction dépend du type de argument-1 comme suit:
Tableau 1. Type de fonction FORMATÉ-DATETIME en fonction des types argument-1
argument-1 type Type de fonction
Alphanumérique Alphanumérique
Nationale Nationale
UTF-8 UTF-8

Format

Lire le diagramme de syntaxeIgnorer le diagramme de syntaxe graphiqueFUNCTION FORMATTED-DATETIME (argument-1 argument-2argument-3argument-4)
argument-1
Il doit s'agir d'un littéral national, UTF-8ou alphanumérique.
Le contenu de argument-1 doit être un format de date. Pour plus de détails, voir Formats de date et d'heure.
argument-2
Doit être au format de date entier. Pour plus de détails, voir Integer date form.
Une valeur sous forme d'entier de date est un entier positif qui représente un nombre de jours suivant le 31 décembre 1600, dans le calendrier grégorien. Il est basé sur une date de début du lundi 1er janvier 1601 et la date entière 1 représente le lundi 1er janvier 1601.
L'option de compilation INTDATE affecte la date de début des fonctions de date entière. Pour plus d'informations, voir INTDATE dans le document Enterprise COBOL Programming Guide.
argument-3
Il doit s'agir d'une valeur numérique au format numérique standard. Pour plus de détails, voir Standard numeric time form.
Une valeur dans le format d'heure numérique standard est une valeur numérique qui représente les secondes après minuit.
argument-4
Il doit s'agir d'un entier spécifiant le décalage par rapport au temps universel coordonné (UTC) exprimé en minutes. Si argument-4 est spécifié, l'amplitude de la valeur doit être inférieure ou égale à 1439. Pour plus de détails, voir Valeur de décalage UTC.
Remarque :
  • Un format d'heure de décalage est un format d'heure avec le décalage ajouté à la fin, par exemple, hhmmss + hhmm, hh:mm:ss + hh:mm, hhmmss.ssss+ hhmm et hh:mm:ss.ssss+ hh:mm.
  • Un format d'heure UTC est un format d'heure dans le fuseau horaire UTC, par exemple, hhmmssZ, hh:mm:ssZ, hhmmss.ssssZ, ou hh:mm:ss.ssssZ.
Si argument-4 est omis et que la partie heure du format dans argument-1 est un format UTC ou un format de décalage, la fonction est évaluée comme si 0 avait été spécifié pour argument-4.
Remarque: La valeur de décalage "1439" représente 23 heures et 59 minutes, soit une minute de moins qu'un jour.

Valeurs renvoyées

  • La valeur renvoyée est une représentation de la date contenue dans argument-2 combinée avec l'heure contenue dans argument-3 selon le format de argument-1.
  • Si le format dans argument-1 indique que la valeur renvoyée est exprimée en temps universel coordonné, la partie heure de la valeur renvoyée reflète l'ajustement de la valeur dans argument-3 par le décalage dans argument-4.
  • Si le format de l' argument-1 indique que l'heure doit être renvoyée en tant que décalage par rapport au temps universel coordonné, la valeur de l' argument-3 est reflétée directement dans la partie heure de la valeur renvoyée et le décalage de l' argument-4 est répercuté directement dans la partie décalage de la valeur renvoyée.

Exemple

Si le premier argument a le formatYYMMDDThhmmss.ss", le deuxième argument la valeur "143951", le troisième argument la valeur18867.812479168304, et le quatrième argument la valeur "+300", la valeur retournée sera "19950215T05142781+0500"