System.DateUtils.TryRecodeDateTime

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

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

C++

extern DELPHI_PACKAGE bool __fastcall TryRecodeDateTime(const System::TDateTime AValue, 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 &AResult);

Eigenschaften

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

Beschreibung

Tauscht die einzelnen Teile eines TDateTime-Wertes selektiv aus.

Mit TryRecodeDateTime können Sie den mit AValue angegebenen Datums-/Zeitwert ändern, indem als Jahr der Wert in AYear, als Monat der Wert in AMonth, als Tag der Wert in ADay, als Stunde der Wert in AHour, als Minute der Wert in AMinute, als Sekunde der Wert in ASecond und als Millisekunde der Wert in AMilliSecond zugewiesen wird. Jedem dieser Parameter kann die Konstante RecodeLeaveFieldAsIs zugewiesen werden, wenn der betreffende Teil des TDateTime-Wertes nicht geändert werden soll.

AYear kann im Bereich zwischen 1 und 9999 liegen oder den Wert RecodeLeaveFieldAsIs enthalten.

AMonth kann im Bereich zwischen 1 und 12 liegen oder den Wert RecodeLeaveFieldAsIs enthalten.

Die für ADay gültigen Werte sind vom Monat abhängig, der mit AMonth angegeben wird. (Ist AMonth beispielsweise 1, kann ADay im Bereich zwischen 1 und 31 liegen. Ist AMonth 2, liegen gültige Werte für ADay zwischen 1 und 28 bzw. 1 und 29, wenn ein Schaltjahr vorliegt usw.) ADay kann auch RecodeLeaveFieldAsIs sein.

AHour kann im Bereich zwischen 0 und 24 liegen oder den Wert RecodeLeaveFieldAsIs enthalten. Ist AHour 24, müssen AMinute, ASecond und AMilliSecond 0 sein.

AMinute kann im Bereich zwischen 0 und 59 liegen oder den Wert RecodeLeaveFieldAsIs enthalten.

ASecond kann im Bereich zwischen 0 und 59 liegen oder den Wert RecodeLeaveFieldAsIs enthalten.

AMilliSecond kann im Bereich zwischen 0 und 999 liegen oder den Wert RecodeLeaveFieldAsIs enthalten.

AResult gibt das Ergebnis der an AValue vorgenommenen Änderungen zurück.

TryRecodeDateTime gibt true zurück, wenn alle Parameter im gültigen Bereich liegen. Andernfalls wird false zurückgegeben.

Siehe auch

Codebeispiele