DatePart

betrifft

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)