formatTimestamp()

Die Systemfunktion 'strLib.formatTimestamp()' akzeptiert einen Zeitmarkenwert (TIMESTAMP) als Eingabe und gibt einen Zeichenfolgewert (STRING) zurück.

EGL probiert für die Konvertierung die folgenden Formate in der angegebenen Reihenfolge aus. Wenn ein bestimmtes Format null, leer oder ungültig ist, geht EGL zum nächsten Format über:
  1. Die als Parameter bereitgestellte Formatierzeichenfolge
  2. strLib.defaultTimestampFormat
  3. Die Maske, mit der die Zeitmarkenvariable (TIMESTAMP) definiert wurde
Beim Konvertieren einer Zeitmarke (TIMESTAMP) auf der Basis der sie definierenden Maske, fügt EGL die folgenden Zeichen ein:

Weitere Informationen finden Sie im zweiten Beispiel in diesem Thema.

Syntax

  strLib.formatTimestamp(
    Zeitmarke TIMESTAMP(yyyyMMddHHmmssSSSSSS)? in
    [, Zeitmarkenformat STRING? in
    ])
  returns (Ergebnis STRING?)
Zeitmarke
Der zu formatierende Wert für TIMESTAMP. Bei der Eingabe kann es sich um einen beliebigen Ausdruck handeln, der mit einem Zeitmarkenwert (TIMESTAMP) zuordnungskompatibel ist, wie beispielsweise dem von der Systemfunktion 'dateTimeLib.currentTimestamp()' zurückgegebenen Wert.
Zeitmarkenformat
Gibt das Zeitmarkenformat an, wie in Datums-/Zeitmasken und Formatkennungen beschrieben. Sie können ein Literal, eine Zeichenfolgevariable oder eine beliebige der in EGL-Bibliothek 'strLib' beschriebenen Zeitmarkenformatkonstanten verwenden.
Ergebnis
Eine Zeichenfolgevariable (STRING). Wenn Zeitmarke nicht gültig ist, gibt die Funktion einen Nullwert zurück.

Beispiele

Dieses Beispiel zeigt ein komplexes Formatmuster:

  myTs TIMESTAMP = "20060606123200";
  myFormat STRING = "MMMMMMMMM dd, yyyy ' at ' hh:mm aa";
  result STRING;
  
  result = strLib.formatTimestamp(myTs,myFormat);
  // Das Ergebnis lautet "June 6, 2006 at 12:32 pm"

Im folgenden Beispiel verwendet EGL Masken aus den Variablen zum Erstellen der Zeichenfolgen:

  ts1 timestamp( "yyyyMMddHHmmssffffff" );
  ts2 timestamp( "yyyyMMdd" );
  ts3 timestamp( "MMddHHmmssff" );
  tsString STRING;

  defaultTimestampFormat = "";
  // Verwendung des Musters 'yyyy-MM-dd HH:mm:ss.SSSSSS'
  tsString = formatTimestamp( ts1 );

  // Verwendung des Musters 'yyyy-MM-dd'
  tsString = formatTimestamp( ts2 );

  // Verwendung des Musters 'MM-dd HH:mm:ss.SS'
  tsString = formatTimestamp( ts3 );

Feedback