System.DateUtils.TryEncodeDateTime

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function TryEncodeDateTime(const AYear, AMonth, ADay, AHour, AMinute, ASecond,
AMilliSecond: Word; out AValue: TDateTime): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall TryEncodeDateTime(const System::Word AYear, const System::Word AMonth, const System::Word ADay, const System::Word AHour, const System::Word AMinute, const System::Word ASecond, const System::Word AMilliSecond, /* out */ System::TDateTime &AValue);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.DateUtils.pas
System.DateUtils.hpp
System.DateUtils System.DateUtils

Beschreibung

Berechnet den TDateTime-Wert, der die angegebenen Werte für Jahr, Monat, Tag, Stunde, Minute, Sekunde und Millisekunde repräsentiert.

TryEncodeDateTime berechnet den TDateTime-Wert zu den Werten, die mit den Parametern AYear, AMonth, ADay, AHour, AMinute, ASecond und AMilliSecond angegeben werden.

Das Jahr muss zwischen 1 und 9999 liegen.

Gültige Werte für den Monat liegen zwischen 1 und 12.

Für den Tag sind Werte zwischen 1 und 28, 29, 30 oder 31 zulässig (abhängig vom angegebenen Monat). Für den Monat 2 (Februar) sind beispielsweise die Werte 1 bis 28 zulässig bzw. 1 bis 29, wenn ein Schaltjahr als Jahr angegeben ist.

Gültige Stundenwerte liegen zwischen 0 und 24. (Wird 24 als Wert für die Stunden angegeben, müssen die Werte für Minute, Sekunde und Millisekunde Null sein, da der resultierende TDateTime-Wert Mitternacht zum Ende des angegebenen Tages und damit den Anfang des nächsten Tages repräsentiert).

Gültige Werte für die Minute liegen zwischen 0 und 59.

Gültige Werte für die Sekunde liegen zwischen 0 und 59.

Gültige Werte für die Millisekunde liegen zwischen 0 und 999.

AValue gibt das angegebene Datum und die Zeit als TDateTime-Wert zurück.

TryEncodeDateDay gibt True zurück, wenn alle Parameter im gültigen Bereich liegen. Andernfalls wird False zurückgegeben.

Siehe auch

Codebeispiele