You can use the DatePart function to evaluate a date and return a specific time interval. For example, you can use DatePart to calculate the day of the week.
|
Syntax | ||||
|
DatePart(Interval, Date [, FirstDayOfWeek [, FirstWeekOfYear] ]) | ||||
|
Return value | ||||
|
Type |
Description | |||
|
Long |
Number of time intervals | |||
|
Parameter | ||||
|
Use |
Name |
Type |
Passing |
Description |
|
Required |
Interval |
String |
ByVal |
See below |
|
Required |
Date |
Double |
ByVal |
The date to be evaluated |
|
Optional |
FirstDayOfWeek |
Variant |
ByVal |
Determines the first day of week |
|
Optional |
FirstWeekOfYear |
Variant |
ByVal |
Determines the first week of year |
Interval determines the time interval to return. The following values can be specified for Interval:
|
Interval |
Description |
|
yyyy |
Year |
|
q |
Quarter |
|
m |
Month |
|
y |
Day of the year |
|
d |
Day |
|
w |
Weekday |
|
ww |
Week |
|
h |
Hour |
|
n |
Minute |
|
s |
Second |
You can use the optional FirstDayOfWeek parameter to define the first day of the week.
|
FirstDayOfWeek |
Description |
|
1 |
Sunday (= Default value) |
|
2 |
Monday |
|
3 |
Tuesday |
|
4 |
Wednesday |
|
5 |
Thursday |
|
6 |
Friday |
|
7 |
Saturday |
The optional FirstWeekOfYear parameter determines the first week of the year, which by default is defined as the week in which January 1 is located. The following definitions are possible here:
|
FirstWeekOfYear |
Description |
|
1 |
Week of January 1 |
|
2 |
Week in which at least four days of the new year are |
|
3 |
first full week of the new year |
Example:
Dim Part As Long
Part := DatePart("m", DateSerial(1999, 5, 31)) # retrieves 5
Part := DatePart("ww", DateSerial(1999, 5, 31)) # retrieves 22 (die 22th week)