Referenz - DATEDIFF
Syntax: DATEDIFF(Intervall, SerialA, SerialB [, erster_Tag_der_Woche [, erste_Woche_des_Jahres]])
Kategorie: Zeit
Typ: Funktion
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.
'SerialA' und 'SerialB' sind die Zeitpunkte, deren Unterschied ermittelt werden soll. Wenn 'SerialA' größer ist als 'SerialB', dann ist das Ergebnis negativ.
'Intervall' ist ein String, der angibt, wie groß die Intervalle sein sollen, die zum 'SerialA' (dem Ausgangszeitpunkt) hinzugezählt werden sollen. Er ist einer von diesen Werten:
| 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 |
'erster_Tag_der_Woche' wirkt sich auf das Ergebnis aus, wenn als Intervall "ww" angegeben wurde. Er 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' wirkt sich auf das Ergebnis aus, wenn als Intervall "ww" angegeben wurde. Er 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, 24) ' 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 11 Tage bis Weihnachten!Unterschiede zu QB: existiert nur in QBX PDS und in VBDOS
Unterschiede zu früheren Versionen von FreeBASIC: existiert erst 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 | ||||
|---|---|---|---|---|
|
||||




FreeBASIC-Nachrichten jetzt auch über Twitter erhalten. Follow us!
Versionen