System.DateUtils.RecodeDateTime

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

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

C++

extern DELPHI_PACKAGE System::TDateTime __fastcall RecodeDateTime(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);

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 RecodeDateTime 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 23 liegen oder den Wert RecodeLeaveFieldAsIs enthalten.

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.

Ergeben die Werte keinen gültigen Datums-/Zeitwert, löst RecodeDateTime eine EConvertError-Exception aus.

Siehe auch

Codebeispiele