DateUtils.EncodeDayOfWeekInMonth

From RAD Studio VCL Reference
Jump to: navigation, search

Contents

Delphi Information

From DateUtils.pas

	function EncodeDayOfWeekInMonth(const AYear: Word;
		const AMonth: Word;
		const ANthDayOfWeek: Word;
		const ADayOfWeek: Word): TDateTime;


Unit: DateUtils

Type: function

Visibility: public

C++ Information

From DateUtils.hpp

	System::TDateTime __fastcall EncodeDayOfWeekInMonth(unsigned short AYear,
		unsigned short AMonth,
		unsigned short ANthDayOfWeek,
		unsigned short ADayOfWeek);


Unit: DateUtils

Type: function

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

Code Samples


Personal tools
Translations
Newest Version