CDOW( )-Funktion
Gibt den Namen des Wochentags für eine angegebene Datumzeit zurück. Abkürzung für „Character Day of Week“ (Zeichen Wochentag).
Syntax
CDOW(Datum/Datumzeit; Länge)
Parameter
Name | Typ | Beschreibung |
---|---|---|
Datum/Datumzeit |
Datumzeit |
Das Feld, der Ausdruck oder Literalwert, für den der Wochentag 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 Wochentage abgekürzt werden sollen. |
Ausgabe
Zeichen.
Beispiele
Einfache Beispiele
Gibt „Mittwoch“ zurück, weil der 31. Dezember 2014 auf einen Mittwoch fällt und die Länge „9“ beträgt:
CDOW(`20141231`; 8)
Gibt „Mit“ zurück, weil der 31. Dezember 2014 auf einen Mittwoch fällt und die Länge „3“ beträgt:
CDOW(`20141231 235959`; 3)
Gibt den vollständigen Wochentag für jeden Wert in dem Feld Rechnungsdatum zurück:
CDOW(Rechnungsdatum; 10)
Gibt den abgekürzten Wochentagnamen für jeden Wert im Feld Eingang_Zeitstempel zurück:
CDOW(Empfang_Eingangsstempel; 3)
Weiterführende Beispiele
Ein Feld hinzufügen, das den Wochentag für ein Datum erkennt
Verwenden Sie die CDOW( )-Funktion, um ein Kalkulationsfeld zu erstellen, das die Wochentage für alle Daten in einem Datumsfeld angibt. Nachdem Sie das Kalkulationsfeld angelegt haben, können Sie es der Ansicht neben der Datumsspalte hinzufügen:
DEFINE FIELD Wochentag COMPUTED CDOW(Trans_Datum; 3)
Einen Filter erstellen, um auf Transaktionen an Wochenenden zu testen
Verwenden Sie die CDOW( )-Funktion, um einen Filter für Transaktionen zu erstellen, die an einem Wochenende anfielen:
SET FILTER TO CDOW(Trans_Datum, 3) = "Sat" OR CDOW(Trans_Datum, 3) = "Sun"
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 des Wochentags, wird der Tag auf die angegebene Länge gekürzt. Wenn der Parameter Länge länger als der Wochentag ist, wird der Wochentag 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 Sie den Wochentag als eine Zahl zurückgeben möchten (1 bis 7), verwenden Sie statt CDOW( ) die Funktion DOW( ).