Leitfaden für die Skripterstellung in ACL 14.1

DATETIME( )-Funktion

Wandelt eine Datumzeit in eine Zeichenfolge um. Kann ebenfalls die aktuelle Datumzeit des Betriebssystems wiedergeben.

DATETIME(<Datumzeit> <;Format>)
Name Typ Beschreibung
Datumzeit

Optional

Datumzeit

Das Feld, der Ausdruck oder Literalwert, der umzuwandeln ist. Wird dies ausgelassen, wird das aktuelle Datum des Betriebssystems zurückgegeben.

Format

Optional

Zeichen

Das auf die Ausgabezeichenfolge anzuwendende Format, zum Beispiel "TT/MM/JJJJ". Wenn dies weggelassen wird, wird das aktuelle Analytics-Datumanzeigeformat verwendet. Ein Format kann nicht spezifiziert werden, wenn Datum/Datumzeit weggelassen wurde.

Zeichen.

Einfache Beispiele

Literale Datumzeit eingeben

Gibt „20141231 235959“ im aktuellen Analytics-Datums- und Zeitanzeigeformat zurück:

DATETIME(`20141231 235959`)

Gibt „31-Dez-2014 11:59 P“ zurück:

DATETIME(`20141231 235959`; "TT-MMM-JJJJ hh:mm A")

Gibt das aktuelle Datum und die Zeit des Betriebssystems als Zeichenfolge im aktuellen Analytics-Datums- und Zeitanzeigeformat zurück:

DATETIME()

Feldeingabe

Gibt jeden Wert im Feld Eingang_Zeitstempel als eine Zeichenfolge unter Verwendung des aktuellen Analytics-Datums- und Zeitanzeigeformats zurück:

DATETIME(Eingang_Zeitstempel)

Gibt jeden Wert im Feld Eingang_Zeitstempel als eine Zeichenfolge unter Verwendung des angegebenen Datum- und Zeitanzeigeformats zurück:

DATETIME(Eingang_Zeitstempel; "TT/MM/JJJJ hh:mm:ss")

Länge der Ausgabezeichenfolge

Die Länge der Ausgabezeichenfolge beläuft sich stets auf 27 Zeichen. Wenn das spezifizierte Ausgabeformat oder die Analytics-Datums- und Zeitformate weniger als 27 Zeichen haben, wird die Ausgabezeichenfolge mit nachgestellten Leerzeichen aufgefüllt.

Parameterdetails

Ein für Datumzeit spezifiziertes Feld kann ein beliebiges Datumzeit-format verwenden, vorausgesetzt die Felddefinition definiert das Format korrekt.

Wenn Sie Format einsetzen, um zu kontrollieren, wie die Ausgabezeichenfolge angezeigt wird, sind Sie auf die Formate der folgenden Tabelle beschränkt.

  • Es kann eine beliebige Kombination von Datums-, Zeit- und 12-Stundenformaten verwendet werden.
  • Das Datum muss der Zeit vorausgehen. Das Einsetzen eines Trennzeichens zwischen Datum und Zeit ist nicht erforderlich, da Analytics automatisch ein Leerzeichen als Trennzeichen in die Ausgabezeichenfolge einfügt.
  • Die Angabe des 12-Stundenformats ist optional und wird am Ende platziert.
  • Format muss in einzelne oder doppelte Anführungszeichen gesetzt werden.

    Beispiel: "TT-MMM-JJJJ hh:mm:ss AM"

Datumsformate

Zeitformate

12-Stundenformate

Beispiele

alle von Analytics unterstützten Datumanzeigeformate

hh:mm:ss

keine

24-Stundenformat

"TT/MM/JJJJ hh:mm:ss"

 

hhmmss

AM oder PM

12-Stundenformat

"MMTTJJ hhmmss PM"

 

hh:mm

A oder P

12-Stundenformat

"TT-MMM-JJJJ hh:mm A"

 

hhmm

 

 
 

hh

 

 

Angabe eines literalen Datumzeit-Werts

Wenn für Datumzeit eine literale Datumzeit angegeben wird, können lediglich die in der folgenden Tabelle aufgeführten Formate verwendet werden, und die Werte müssen in Backquotes gesetzt werden – zum Beispiel `20141231 235959`.

Verwenden Sie keine Trennzeichen wie zum Beispiel Schrägstriche (/) oder Doppelpunkte (:) zwischen den einzelnen Datums- und Zeitkomponenten.

  • Datumzeit-Werte – Sie können eine beliebige Kombination der in der folgenden Tabelle aufgelisteten Datums-, Trennzeichen- und Zeitformate verwenden. Das Datum muss der Zeit vorangestellt werden und durch ein Trennzeichen getrennt werden. Gültige Trennzeichen sind ein einzelnes Leerzeichen, der Buchstabe ‘t’ oder der Buchstabe ‘T’.

  • Zeitwerte – Sie müssen Zeiten im 24-Stunden-Format angeben. Verschiebungen zur Coordinated Universal Time (UTC) muss ein Plus- (+) oder Minuszeichen (-) vorangehen.

    Beispielformate

    Beispiel für Literalwerte

    JJJJMMTT hhmmss

    `20141231 235959`

    JJMMTTthhmm

    `141231t2359`

    JJJJMMTTThh (YYYYMMDDThh)

    `20141231T23`

    JJJJMMTT hhmmss+/-hhmm

    (UTC Anpassung)

    `20141231 235959-0500`

    JJMMTT hhmm+/-hh

    (UTC Anpassung)

    `141231 2359+01`

    Hinweis

    Verwenden Sie bei Daten mit einer UTC-Anpassung in Zeitformaten hh nicht alleine. Vermeiden Sie zum Beispiel: hh+hhmm. Die Ergebnisse können sonst unzuverlässig sein.

     

Konvertierung von Datumzeit auf Zeichen

Funktion Beschreibung

DATE( )

Extrahiert das Datum eines spezifizierten Datums oder einer Datumzeit und gibt dieses als Zeichenfolge wieder. Kann ebenfalls das aktuelle Datum des Betriebssystems wiedergeben.

TIME( )

Extrahiert die Uhrzeit einer spezifizierten Zeit oder einer Datumzeit und gibt diese als Zeichenfolge wieder. Kann ebenfalls die aktuelle Systembetriebszeit wiedergeben.

Konvertierung von Zeichen oder numerischen Daten auf Datumzeit

Funktion Beschreibung

CTOD( )

Konvertiert Zeichendaten oder numerische Daten in Datumswerte. Kann außerdem das Datum aus einem Zeichen- oder numerischen Datumzeitwert extrahieren und diesen als Datum wiedergeben. Abkürzung für „Character to Date“ (Zeichen in Datum).

CTODT( )

Konvertiert ein Zeichen oder numerische Datumzeitwerte in eine Datumzeit. Abkürzung für „Character to Datetime“ (Zeichen in Datumzeit).

CTOT( )

Konvertiert ein Zeichen oder numerische Zeitwerte in eine Uhrzeit. Kann außerdem die Zeit aus einem Zeichen- oder numerischen Datumzeitwert extrahieren und diesen als Uhrzeit wiedergeben. Abkürzung für „Character to Time“ (Zeichen in Zeit).

Konvertierung von seriellen Daten auf Datumzeit

Funktion Beschreibung

STOD( )

Wandelt eine serielley Datum – d.h. ein Datum, das als ganze Zahl ausgedrückt wird– in ein Datumswert um. Abkürzung für „Serial to Date“ (Seriell in Datum).

STODT( )

Wandelt eine serielle Datumzeit – d.h. eine Datumzeit, die als ganze Zahl und Bruchteil von 24 Stunden ausgedrückt wird– in einen Datumzeitwert um. Abkürzung für „Serial to Datetime“ (Seriell in Datumzeit).

STOT( )

Wandelt eine serielle Zeit – d.h. eine Uhrzeit, die als Bruchteil von 24 Stunden ausgedrückt wird, wobei 24 gleich 1 ist – in einen Zeitwert um. Abkürzung für „Serial to Time“ (Seriell in Zeit).