Referenz - 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.
- 'Intervall' ist ein String, der angibt, welcher Teil von 'Serial' zurückgegeben werden soll. Die möglichen Angaben werden weiter unten aufgelistet.
- 'Serial' ist eine Serial Number, von der eine bestimmte Teilangabe ausgegeben werden soll.
- 'erster_Tag_der_Woche' wirkt sich auf das Ergebnis aus, wenn als Intervall "ww" angegeben wurde; siehe unten.
- 'erste_Woche_des_Jahres' wirkt sich auf das Ergebnis aus, wenn als Intervall "ww" angegeben wurde; siehe unten.
- Der Rückgabewert ist ein INTEGER mit der extrahierten Teilangabe.
Folgende Intervallangaben sind möglich:
Wert | Bedeutung |
---|---|
"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:
Wert | alternatives Symbol | Tag |
---|---|---|
ausgelassen | - | Sonntag |
0 | fbUseSystem | lokal eingestelltes System |
1 | fbSunday | Sonntag |
2 | fbMonday | Montag |
3 | fbTuesday | Dienstag |
4 | fbWednesday | Mittwoch |
5 | fbThursday | Donnerstag |
6 | fbFriday | Freitag |
7 | fbSaturday | Samstag |
'erste_Woche_des_Jahres' ist einer von diesen Werten:
Wert | alternatives Symbol | Bedeutung |
---|---|---|
0 oder ausgelassen | fbUseSystem | lokal eingestelltes System |
1 | fbFirstJan1 | Beginne mit der Woche des ersten Januars als erste Kalenderwoche des Jahres |
2 | fbFirstFourDays | Beginne mit der ersten Woche, die vier Tage hat als erste Kalenderwoche des Jahres |
3 | fbFirstFullWeek | Beginne 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
Zusätzliche Informationen und Funktionen | ||||
---|---|---|---|---|
|