CMOY( )-Funktion

Gibt den Monat eines Jahres für eine angegebene Datumzeit wieder. Abkürzung für „Character Month of Year“ (Zeichen Monat des Jahres).

Syntax

CMOY(Datum/Datumzeit; Länge)

Parameter

Name Typ Beschreibung
Datum/Datumzeit

Datumzeit

Das Feld, der Ausdruck oder Literalwert, für den der Monat wiederzugeben ist.
Länge

numerisch

Die Länge der Ausgabezeichenfolge wird durch einen Wert von 1 bis 9 festgelegt. Geben Sie kleinere Werte an, wenn die Monate abgekürzt werden sollen.

Ausgabe

Zeichen.

Beispiele

Einfache Beispiele

Gibt „Dezember“ zurück:

CMOY(`20141231`; 9)

Gibt „Dez“ zurück:

CMOY(`20141231 235959`; 3)

Gibt die abgekürzte Monatsbezeichnung für jeden Wert im Feld Eingang_Zeitstempel zurück:

CMOY(Eingang_Zeitstempel; 3)

Gibt die vollständige Monatsbezeichnung für jeden Wert im Feld Rechnungsdatum zurück:

CMOY(Rechnungsdatum; 9)

Gibt die vollständige Monatsbezeichnung für jeden Wert plus 15 Tage im Feld Rechnungsdatum zurück:

CMOY(Rechnungsdatum + 15; 9)

Bemerkungen

Parameterdetails

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

Wenn der Parameter Länge kürzer ist als die Länge der Bezeichnung des Monats, wird die Bezeichnung auf die angegebene Länge gekürzt. Wenn der Parameter Länge länger als der Monatsname ist, wird der Monatsname mit Leerzeichen aufgefüllt.

Angabe eines literalen Datums- oder Datumzeit-Werts

Wenn für Datum/Datumzeit ein literales Datum oder ein literaler Datumzeit-Wert 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`.

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

    `20141231`

    JJMMTT

    `141231`

    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.

     

Verwandte Funktionen

Wenn der Monat des Jahres als Zahl (1-12) angezeigt werden soll, verwenden Sie die Funktion MONTH( ) statt CMOY( ).

Leitfaden für die Skripterstellung in ACL 14.1