CTOD( )-Funktion

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).

Syntax

CTOD(Zeichenfolge/Zahl <;Format>)

Parameter

Name Typ Beschreibung
Zeichenfolge/Zahl

Zeichen

numerisch

Das Feld, der Ausdruck oder Literalwert, der in ein Datum umformatiert werden soll oder von dem das Datum zu extrahieren ist.
Format

Optional

Zeichen

Das Datumsformat von Zeichenfolge/Zahl. Das Format ist für Werte erforderlich, die ein anderes Datumsformat als JJJJMMTT oder JJMMTT verwenden, wie beispielsweise "TT/MM/JJJJ".

Hinweis

Wenn Sie die CTOD-Funktion mit einem Datumzeitwert verwenden, der den Format-Parameter erfordert, spezifizieren Sie lediglich den Datumsteil des Formats und nicht den Zeitteil. Beispiel:

CTOD("31/12/2014 23:59:59"; "TT/MM/JJJJ")

Wenn auch der Zeitteil angegeben wird, werden keine Ergebnisse angegeben.

Ausgabe

Datumzeit. Der Datumswert wird im aktuellen Analytics-Datumsformat angezeigt.

Beispiele

Einfache Beispiele

Zeichenliteral eingeben

Gibt `20141231` zurück, was als „31 Dez 2014“ angezeigt wird, unter der Annahme eines aktuellen Analytics-Datumanzeigeformats von „TT MMM JJJJ“:

CTOD("20141231")
CTOD("31/12/2014"; "DD/MM/YYYY")
CTOD("20141231 235959")

Numerisches Literal eingeben

Gibt `20141231` zurück, was als „31 Dez 2014“ angezeigt wird, unter der Annahme eines aktuellen Analytics-Datumanzeigeformats von „TT MMM JJJJ“:

CTOD(20141231)
CTOD(31122014; "DDMMYYYY")
CTOD(20141231,235959)

Zeichenfeld eingeben

Gibt jeden Wert des angegebenen Zeichenfelds als Datum mit dem aktuellen Analytics-Datumanzeigeformat zurück:

CTOD(Invoice_date, "DD/MM/YYYY")
CTOD(Eingangszeitstempel)

Numerisches Feld eingeben

Gibt jeden Wert des angegebenen numerischen Felds als Datum mit dem aktuellen Analytics-Datumanzeigeformat zurück:

CTOD(Fälligkeitsdatum; "DDMMYYYY")
CTOD(Zahlungszeitstempel)

Weiterführende Beispiele

Vergleich eines Zeichen- oder numerischen Felds mit einem Datum

Verwenden Sie die CTOD( )-Funktion, um ein Zeichen- oder numerisches Feld, das Datumswerte enthält, mit einem Datum zu vergleichen.

Der folgende Filter vergleicht zwei Werte:

  • das numerische Feld Fälligkeitsdatum, das Datumswerte im Format TTMMJJJJ speichert
  • den literalen Datumswert 1. Juli 2014
SET FILTER TO CTOD(Fälligkeitsdatum; "DDMMYYYY") < ‘20140701‘

Bemerkungen

Datumsformate erforderlich

Zeichen- und numerische Felder, die Datums- oder Datumzeit-Werte enthalten, müssen den Formaten entsprechen, die in der nachfolgenden Tabellen aufgeführt sind. Für Datumzeit-Werte kann eine beliebige Kombination von Datums-, Trennzeichen- und Zeitformaten verwendet werden, die für deren Datentyp gültig sind. Das Datum muss der Zeit vorangestellt werden und durch ein Trennzeichen getrennt werden.

Ein Datum oder der Datumsteil von Datumzeit-Werten kann ein beliebiges Datumsformat verwenden, das von Analytics unterstützt wird und für den Datentyp zulässig ist, vorausgesetzt dass Formate außer JJJJMMTT und JJMMTT richtig durch Format definiert sind.

Datumsformate

Trennzeichenformate

Zeitformate

Zeichenfelder

JJJJMMTT

einzelnes Leerzeichen

hhmmss

hh:mm:ss

JJMMTT

der Buchstabe 't'

hhmm

hh:mm

ein beliebiges Datumsformat, das von Analytics unterstützt wird und für den Datentyp zulässig ist, wenn dieses durch Format definiert ist

der Buchstabe 'T'

hh

 

 

+/-hhmm

+/-hh:mm

(UTC Anpassung)

 

 

+/-hh

(UTC Anpassung)

 

 

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.)

Numerische Felder

JJJJMMTT

Dezimalpunkt

hhmmss

JJMMTT

 

hhmm

ein beliebiges Datumsformat, das von Analytics unterstützt wird und für den Datentyp zulässig ist, wenn dieses durch Format definiert ist

 

hh

Andere Konvertierungsfunktionen für Datumzeit

Konvertierung von Zeichen oder numerischen Daten auf Datumzeit

Funktion Beschreibung

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 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.

DATETIME( )

Wandelt eine Datumzeit in eine Zeichenfolge um. Kann ebenfalls die aktuelle Datumzeit 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 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).

Leitfaden für die Skripterstellung in ACL 14.1