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
Die korrekte Verwendung von Datums- und Zeitfunktionen kann manchmal schwierig sein. In der Hilfe beschreiben die Funktionsthemen die spezifischen Einzelheiten der einzelnen Funktionen. Informationen über allgemeine Überlegungen bei der Verwendung von Datum- und Zeitfunktion finden Sie in den folgenden Themen:
- Verwenden von Datumzeiten in Ausdrücken
- Serielle Datumzeiten
- Wie sich UTC-Offsets auf Datumzeit-Ausdrücke auswirken
- Datums- und Uhrzeitoptionen
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( ).