Mit der DatePart-Funktion können Sie ein Datum auswerten und ein bestimmtes Zeitintervall zurückgeben. Sie können mit DatePart zum Beispiel den Tag der Woche berechnen.
Syntax | ||||
Result := DatePart(Interval, Date [, FirstDayOfWeek [, FirstWeekOfYear] ]) | ||||
Rückgabewert | ||||
Typ |
Beschreibung | |||
Long |
Zahl der Zeitintervalle | |||
Parameter | ||||
Verwendung |
Name |
Typ |
Übergabe |
Beschreibung |
Erforderlich |
Interval |
String |
ByVal |
s.u. |
Erforderlich |
Date |
Double |
ByVal |
Das auszuwertende Datum |
Optional |
FirstDayOfWeek |
Variant |
ByVal |
Bestimmt den 1. Tag der Woche |
Optional |
FirstWeekOfYear |
Variant |
ByVal |
Bestimmt die 1. Woche des Jahres |
Interval bestimmt das zurückzugebende Zeitintervall. Folgende Werte können für Interval angegeben werden:
Interval |
Beschreibung |
yyyy |
Jahr |
q |
Quartal |
m |
Monat |
y |
Tag des Jahres |
d |
Tag |
w |
Wochentag |
ww |
Woche |
h |
Stunde |
n |
Minute |
s |
Sekunde |
Über den optionalen Parameter FirstDayOfWeek können Sie den ersten Tag der Woche definieren.
FirstDayOfWeek |
Beschreibung |
1 |
Sonntag (=Defaultwert, wenn nicht angegeben) |
2 |
Montag |
3 |
Dienstag |
4 |
Mittwoch |
5 |
Donnerstag |
6 |
Freitag |
7 |
Samstag |
Der optionale Parameter FirstWeekOfYear bestimmt die erste Woche des Jahres, die per Default als die Woche definiert ist, in der der 1. Januar liegt. Folgende Definitionen sind hier möglich:
FirstWeekOfYear |
Beschreibung |
1 |
Woche, in der der 1. Januar liegt |
2 |
Woche, in der mindestens vier Tage des neuen Jahres liegen |
3 |
erste vollständige Woche des neuen Jahres |
Beispiel:
Dim Part As Long
Part := DatePart("m", ToDate("07.05.1999")) # ergibt 5
Part := DatePart("ww", ToDate("07.05.1999")) # ergibt 18 (die 18. Woche)