System.DateUtils.EncodeDayOfWeekInMonth
Delphi
function EncodeDayOfWeekInMonth(const AYear, AMonth, ANthDayOfWeek, ADayOfWeek: Word): TDateTime;
C++
extern DELPHI_PACKAGE System::TDateTime __fastcall EncodeDayOfWeekInMonth(const System::Word AYear, const System::Word AMonth, const System::Word ANthDayOfWeek, const System::Word ADayOfWeek);
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
function | public | System.DateUtils.pas System.DateUtils.hpp |
System.DateUtils | System.DateUtils |
Description
Returns a TDateTime that represents a specified occurrence of a day of the week within a specified month and year.
EncodeDayOfWeekInMonth returns a TDateTime for the date specified by the AYear, AMonth, ANthDayOfWeek, and ADayOfWeek parameters. The time portion of the return value is 0 (Midnight at the start of the specified day).
AYear is the year. It can be any value from 1 through 9999 (inclusive).
AMonth is the month. It can be any value from 1 through 12 (inclusive).
ANthDayOfWeek indicates the occurrence for the day of the week represented by ADayOfWeek. It can be any value from 1 through 5 (inclusive), as long as this value specifies a valid date. For example, if a month does not include 5 Mondays, setting ANthDayOfWeek to 5 and ADayOfWeek to 1 causes EncodeDayOfWeekInMonth to raise an exception.
ADayOfWeek is the day of the week, where 1 is Monday and 7 is Sunday.
Note: The definition for ADayOfWeek follows the ISO 8601 standard.
Tip: To make the ADayOfWeek value more readable, use the day of week constants.
See Also