DATEPART

FreeBASIC-Referenz » Alphabetische Befehlsreferenz » D » DATEPART

Syntax: DATEPART (Intervall, Serial [, erster_Tag_der_Woche [, erste_Woche_des_Jahres]])
Typ: Funktion
Kategorie: Datum und Zeit

Anmerkung:
Um diese Funktion nutzen zu können, muss die Datei datetime.bi in Ihren Quellcode eingebunden werden, z. B. mit INCLUDE. Alternativ können Sie auch die Datei vbcompat.bi einbinden, da dadurch auch automatisch datetime.bi eingebunden wird.

DATEPART extrahiert eine Teilangabe einer Serial Number.

Folgende Intervallangaben sind möglich:

WertBedeutung
"yyyy"Jahre
"q"Quartale (drei Monate)
"m"Monate
"ww"Wochen innerhalb des Jahres
"w"Tage innerhalb der Woche
"d"Tage innerhalb des Monats
"y"Tage innerhalb des Jahres
"h"Stunden
"n"Minuten
"s"Sekunden

Wenn als 'Intervall' der Wert "ww" angegeben wird, können weitere Angaben zu 'erster_Tag_der_Woche' und 'erste_Woche_des_Jahres' gemacht werden.

'erster_Tag_der_Woche' ist einer von diesen Werten:

Wertalternatives SymbolTag
ausgelassen-Sonntag
0fbUseSystemlokal eingestelltes System
1fbSundaySonntag
2fbMondayMontag
3fbTuesdayDienstag
4fbWednesdayMittwoch
5fbThursdayDonnerstag
6fbFridayFreitag
7fbSaturdaySamstag

'erste_Woche_des_Jahres' ist einer von diesen Werten:

Wertalternatives SymbolBedeutung
0 oder ausgelassenfbUseSystemlokal eingestelltes System
1fbFirstJan1Beginne mit der Woche des ersten Januars als erste Kalenderwoche des Jahres
2fbFirstFourDaysBeginne mit der ersten Woche, die vier Tage hat als erste Kalenderwoche des Jahres
3fbFirstFullWeekBeginne mit der ersten ganzen Woche des Jahres als erste Kalenderwoche des Jahres

Beispiel:

#INCLUDE "vbcompat.bi"

PRINT "Wir befinden uns im ";
PRINT DATEPART("q", NOW); ". Quartal."
PRINT "Es ist die "; DATEPART("ww", NOW, , fbFirstFullWeek);
PRINT ". ganze Kalenderwoche."
PRINT "Heute ist der "; DATEPART("w", NOW, fbMonday);
PRINT ". Tag seit Montag."
SLEEP

Unterschiede zu QB: existiert nur in QBX PDS und in VBWIN.

Unterschiede zu früheren Versionen von FreeBASIC: existiert seit FreeBASIC v0.15

Siehe auch:
NOW, DATESERIAL, DATEVALUE, TIMESERIAL, TIMEVALUE, YEAR, MONTH, DAY, WEEKDAY, HOUR, MINUTE, SECOND, MONTHNAME, WEEKDAYNAME, DATEADD, DATEDIFF, FORMAT, ISDATE, Serial Numbers, Datum und Zeit