VariantTimeToSystemTime

  • Artikel

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Konvertiert die variant Darstellung der Zeit auf System immer Werte.

INT VariantTimeToSystemTime(  
  double  vtime,              
  LPSYSTEMTIME  lpSystemTime  
);

Parameter

  • vtime
    Die variant Zeit, die konvertiert werden.

  • lpSystemTime
    Ein Zeiger auf den Speicherort, in dem die konvertierte Zeit gespeichert werden.

Rückgabewert

Der Rückgabewert aus den zurückgegebenen INT abgerufenes ist eine der folgenden.

Wert

Bedeutung

TRUE

Erfolg.

FALSE

Fehler.

Kommentare

Variant Zeit wird als 8-Byte realen Wert (doppelte), die ein Datum zwischen Januar 1, 100 und 31. Dezember 9999 darstellt gespeichert. Der Wert 2.0 stellt 01.01.1900;3.0 stellt 2 Januar 1900, und So weiter. Hinzufügen von 1 den Wert Schritten das Datum um einen Tag. Der Bruchteil der Wert stellt die Zeit des Tages die. Daher stellt 2.5 Mittag auf 01.01.1900;3,25 darstellt 6: 00 Uhr 2 Januar 1900 und so weiter. Negative Zahlen stellen die Datumsangaben vor dem 30.Dezember 1899 dar.

Die Verwendung der SYSTEMTIME-Struktur ist hilfreich da:

  • Es umfasst alle Zeit/Datum-Perioden. MS-DOS-Datum/Uhrzeit auf, die nur die Datumsangaben zwischen darstellen beschränkt ist 1, 1/1980 "und" 12/31/2107.

  • Die Datum/Uhrzeit-Elemente sind ohne alle Bit Decodierung führen alle leicht zugänglich.

  • Die National Language Support Daten und Uhrzeitformat Funktionen GetDateFormat und GetTimeFormat annehmen einen SYSTEMTIME-Wert als Eingabe.

  • Es ist das Win32-Datum und Uhrzeit Daten Standardformat von Windows NT und Windows 95 unterstützt wird.

Funktion VariantTimeToSystemTime ungültige Daten akzeptiert und versuchen, diese zu beheben, wenn zu einem Zeitpunkt VARIANT auflösen. Beispielsweise wird ein ungültiges Datum wie z. B. 2/29/2001 in 3, 1/2001 aufgelöst wird. Nur Tage werden behoben, sodass ungültige Monatswerte ein Fehler zurückgegeben wird. Tage werden überprüft, um zwischen 1 und 31 liegen. Negative Tage und größer als 31 führt zu Fehler Tage. Ein Tag kleiner als 31 jedoch größer als der maximale Tag im Monat den Tag zu der entsprechende Tag des nächsten Monat heraufgestuft wurde. Ein Tag gleich 0 (null) löst als letzten Tag des vorherigen Monats. Beispielsweise werden eine ungültige Daten wie z. B. 2, 0/2001 in 1/31/2001 aufgelöst wird.