Wer ist online?
Buchempfehlung
FreeBASIC-Chat
FreeBASIC-Nachrichten jetzt auch über Twitter erhalten. Follow us!Referenz - DATEDIFF
Syntax: DATEDIFF (Intervall, SerialA, SerialB [, 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.
DATEDIFF gibt den zeitlichen Unterschied zwischen zwei Serial Numbers aus.
- 'SerialA' und 'SerialB' sind die Zeitpunkte, deren Unterschied ermittelt werden soll. Wenn 'SerialA' größer ist als 'SerialB', so ist das Ergebnis negativ.
- 'Intervall' ist ein String, der angibt, wie groß die Intervalle sein sollen, in denen der zeitliche Unterschied zwischen 'SerialA' und 'SerialB' gemessen werden soll. Die möglichen Angaben werden weiter unten aufgelistet.
- '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.
Folgende Intervallangaben sind möglich:
| Wert | Bedeutung |
|---|---|
| "yyyy" | Jahre |
| "q" | Quartale (drei Monate) |
| "m" | Monate |
| "w" | Sieben-Tage-Einheiten (Wochen) |
| "ww" | Kalenderwochen (beginnen und enden bei einem bestimmten Wochentag) |
| "d" oder "y" | Tage |
| "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"
DIM AS DOUBLE SerialA, SerialB
SerialA = NOW
SerialB = DATESERIAL(YEAR(NOW), 12, 25) ' Weihnachten dieses Jahr
PRINT "Heute ist der "; FORMAT(SerialA, "dd.mm.yyyy.")
PRINT "Noch";
PRINT DATEDIFF("d", SerialA, SerialB);
PRINT " Tage bis Weihnachten!"
SLEEP
Ausgabebeispiel:
Heute ist der 13.12.2005.
Noch 12 Tage bis Weihnachten!Unterschiede zu QB: existiert nur in QBX PDS und in VBDOS
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, DATEPART, FORMAT, ISDATE, Serial Numbers, Datum und Zeit
| Zusätzliche Informationen und Funktionen | ||||
|---|---|---|---|---|
|
||||
Versionen