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)