Ξ
Δ
◄
►
¬
Ѕ
Filter
Direktiven
Interne Variablen
Interne Funktionen
Kontrollanweisungen
Operatoren
Deklarationen
Interne Klassen
Interne Methoden/Eigenschaften
Ahk2Exe-Compiler
Suchwörter hervorheben
<script src="../static/ga4.js" type="text/javascript"></script> </head> <body> <h1>DateDiff</h1> <p>Vergleicht zwei <a href="FileSetTime.htm#YYYYMMDD">Datum-Zeit</a>-Werte und gibt die Differenz zurück.</p> <pre class="Syntax">Ergebnis := <span class="func">DateDiff</span>(DatumZeit1, DatumZeit2, ZeitEinheit)</pre> <h2 id="Parameters">Parameter</h2> <dl> <dt>DatumZeit1, DatumZeit2</dt> <dd> <p>Typ: <a href="../Concepts.htm#strings">Zeichenkette</a></p> <p>Zeitstempel im <a href="FileSetTime.htm#YYYYMMDD">YYYYMMDDHH24MISS</a>-Format.</p> <p>Wenn einer der Parameter eine leere Zeichenkette ist, wird die aktuelle Ortszeit (<a href="../Variables.htm#Now">A_Now</a>) verwendet.</p> </dd> <dt>ZeitEinheit</dt> <dd> <p>Typ: <a href="../Concepts.htm#strings">Zeichenkette</a></p> <p>Die Einheit, in der die Differenz gemessen werden soll. <em>ZeitEinheit</em> kann eine der folgenden Zeichenketten sein (oder jeweils nur der erste Buchstabe davon): Seconds, Minutes, Hours oder Days.</p> </dd> </dl> <h2 id="Return_Value">Rückgabewert</h2> <p>Typ: <a href="../Concepts.htm#numbers">Integer</a></p> <p>Diese Funktion gibt die Differenz zwischen zwei Zeitstempeln in der angegebenen <em>ZeitEinheit</em> zurück. Wenn <em>DatumZeit1</em> älter als <em>DatumZeit2</em> ist, wird eine negative Zahl zurückgegeben.</p> <p>Das Ergebnis wird immer auf die nächste ganze Zahl <u>abgerundet</u>. Wenn z.B. die tatsächliche Differenz zwischen zwei Zeitstempeln 1.999 Tage beträgt, wäre das gemeldete Ergebnis 1 Tag. Um eine höhere Genauigkeit zu erzielen, geben Sie für <em>ZeitEinheit</em> das Wort Seconds an und teilen Sie das Ergebnis durch 60.0, 3600.0 oder 86400.0.</p> <h2 id="Remarks">Bemerkungen</h2> <p>Die interne Variable <strong>A_Now</strong> enthält die aktuelle Ortszeit im <a href="FileSetTime.htm#YYYYMMDD">YYYYMMDDHH24MISS</a>-Format.</p> <p>Um die verstrichene Zeit zwischen zwei Ereignissen genau zu bestimmen, verwenden Sie die <a href="../Variables.htm#TickCount">A_TickCount-Methode</a>, weil sie eine Präzision im Millisekundenbereich ermöglicht.</p> <p>Mit <a href="DateAdd.htm">DateAdd</a> können Sekunden, Minuten, Stunden oder Tage zu einem Zeitstempel addiert oder davon subtrahiert werden (mit einer negativen Zahl wird eine Subtraktion erreicht).</p> <p>Enthält <em>DatumZeit</em> einen ungültigen Zeitstempel oder ein Jahr älter als 1601, wird ein <a href="Error.htm#ValueError">ValueError</a> ausgelöst.</p> <h2 id="Related">Siehe auch</h2> <p><a href="DateAdd.htm">DateAdd</a>, <a href="FileGetTime.htm">FileGetTime</a>, <a href="FormatTime.htm">FormatTime</a></p> <h2 id="Examples">Beispiele</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> Berechnet die Anzahl der Tage zwischen zwei Zeitstempeln und meldet das Ergebnis.</p> <pre>var1 := "20050126" var2 := "20040126" MsgBox DateDiff(var1, var2, "d") <em>; Das Ergebnis ist 366, weil 2004 ein Schaltjahr ist.</em> </pre> </div> </body> </html>