DatePart-Funktion
Gibt eine Variante ( Integer ) zurück, die den angegebenen Teil eines bestimmten Datums enthält.
Warnung Bei der Verwendung dieser Funktion ist ein Problem aufgetreten. Der letzte Montag in einigen Kalenderjahren kann als Woche 53 zurückgegeben werden, obwohl es Woche 1 sein sollte. Weitere Informationen und eine Problemumgehung finden Sie unter Format oder DatePart-Funktionen können für den letzten Montag im Jahr eine falsche Wochennummer zurückgeben . |
Syntax
DatePart ( Intervall, Datum [ , ersterWochentag ] [ , ersteJahreswoche ] )
Die Syntax der DatePart- Funktion hat die folgenden Argumente:
Streit | Beschreibung |
Intervall | Erforderlich. Zeichenfolgenausdruck, der das Zeitintervall darstellt, das Sie zurückgeben möchten. |
Datum | Erforderlich. Variantenwert ( Datum ), den Sie auswerten möchten. |
erster Tag der Woche | Optional. Eine Konstante, die den ersten Tag der Woche angibt. Wenn nicht angegeben, wird Sonntag angenommen. |
erste Woche des Jahres | Optional. Eine Konstante, die die erste Woche des Jahres angibt. Wenn nicht anders angegeben, wird angenommen, dass die erste Woche die Woche ist, in der der 1. Januar liegt. |
Einstellungen
Das Intervallargument hat diese Einstellungen:
Einstellung | Beschreibung |
jjjj | Jahr |
q | Quartal |
m | Monat |
j | Tag des Jahres |
d | Tag |
w | Wochentag |
ww | Woche |
h | Stunde |
n | Minute |
s | Zweite |
Das Argument firstdayofweek hat diese Einstellungen:
Konstante | Wert | Beschreibung |
vbUseSystem | 0 | Verwenden Sie die NLS-API-Einstellung. |
vbSonntag | 1 | Sonntag (Standard) |
vbMontag | 2 | Montag |
vbDienstag | 3 | Dienstag |
vbMittwoch | 4 | Mittwoch |
vbDonnerstag | 5 | Donnerstag |
vbFreitag | 6 | Freitag |
vbSamstag | 7 | Samstag |
Das Argument firstweekofyear hat diese Einstellungen:
Konstante | Wert | Beschreibung |
vbUseSystem | 0 | Verwenden Sie die NLS-API-Einstellung. |
vbFirstJan1 | 1 | Beginnen Sie mit der Woche, in der der 1. Januar liegt (Standard). |
vbFirstFourDays | 2 | Beginnen Sie mit der ersten Woche, die mindestens vier Tage im neuen Jahr hat. |
vbErsteVolleWoche | 3 | Beginnen Sie mit der ersten vollen Woche des Jahres. |
Bemerkungen
Sie können die DatePart- Funktion verwenden, um ein Datum auszuwerten und ein bestimmtes Zeitintervall zurückzugeben. Beispielsweise können Sie DatePart verwenden, um den Wochentag oder die aktuelle Stunde zu berechnen.
Das Argument firstdayofweek wirkt sich auf Berechnungen aus, die die Intervallsymbole „w" und „ww" verwenden.
Wenn date ein Datumsliteral ist, wird das angegebene Jahr zu einem festen Bestandteil dieses Datums. Wenn das Datum jedoch in doppelte Anführungszeichen (" ") eingeschlossen ist und Sie das Jahr weglassen, wird das aktuelle Jahr jedes Mal in Ihren Code eingefügt, wenn der Datumsausdruck ausgewertet wird. Dadurch ist es möglich, Code zu schreiben, der in verschiedenen Jahren verwendet werden kann.
Hinweis: Wenn für date die Eigenschaft Calendar auf gregorianischen Wert eingestellt ist, muss das angegebene Datum gregorianische sein. Wenn der Kalender Hijri ist, muss das angegebene Datum Hijri sein.
Der zurückgegebene Datumsteil entspricht den Zeiteinheiten des aktuellen arabischen Kalenders. Wenn der aktuelle Kalender beispielsweise Hijri ist und der zurückzugebende Datumsteil das Jahr ist, ist der Jahreswert ein Hijri-Jahr.
Abfragebeispiele
Ausdruck | Ergebnisse |
SELECT DatePart("yyyy",[DateofSale]) AS NewDate FROM ProductSales; | Gibt das 'Jahr' der Datumswerte des Felds "DateofSale" zurück. |
SELECT DatePart("q",[DateofSale]) AS NewDate FROM ProductSales; | Gibt das 'Quartal' (basierend auf dem Kalenderjahr) der Datumswerte des Felds "DateofSale" zurück. |
SELECT DatePart("y",[DateofSale]) AS NewDate FROM ProductSales; | Gibt den 'Day of Year' (1 bis 365) der Datumswerte des Felds "DateofSale" zurück. |
SELECT DatePart("d",[DateofSale]) AS NewDate FROM ProductSales; | Gibt den 'Tag' der Datumswerte des Felds "DateofSale" zurück. |
SELECT DatePart("w",[DateofSale]) AS NewDate FROM ProductSales; | Gibt den 'Wochentag' (von 1 bis 7, wobei 1 für Sonntag steht) der Datumswerte des Felds "DateofSale" zurück. |
SELECT DatePart("ww",[DateofSale]) AS NewDate FROM ProductSales; | Gibt die 'Wochennummer' (von 1 bis 52) der Datumswerte des Felds "DateofSale" zurück. |
SELECT DatePart("h",[DateTime]) AS NewDate FROM ProductSales; | Gibt die 'Stunde' der Datumswerte des Feldes "DateTime" zurück. |
SELECT DatePart("n",[DateTime]) AS NewDate FROM ProductSales; | Gibt die 'Minuten' der Datumswerte des Feldes "DateTime" zurück. |
SELECT DatePart("s",[DateTime]) AS NewDate FROM ProductSales; | Gibt die 'Sekunden' der Datumswerte des Feldes "DateTime" zurück. |
VBA-Beispiel
Hinweis: Die folgenden Beispiele veranschaulichen die Verwendung dieser Funktion in einem Visual Basic for Applications (VBA)-Modul. Um weitere Informationen zum Arbeiten mit VBA zu erhalten, wählen Sie Entwicklerreferenz in der Dropdown-Liste neben Suchen aus und geben Sie einen oder mehrere Begriffe in das Suchfeld ein.
Dieses Beispiel verwendet ein Datum und zeigt mithilfe der DatePart- Funktion das Quartal des Jahres an, in dem es auftritt.
Dim TheDate As Date ' Declare variables.
Dim Msg
TheDate = InputBox("Enter a date:")
Msg = "Quarter: " & DatePart("q", TheDate)
MsgBox Msg
No comments:
Post a Comment