JEWCALGETHOLIDAYINFO

The JEWCALGETHOLIDAYINFO structure contains the data structure which must be passed to the JewcalGetHolidayNameEx function

typedef struct tagJEWCALGETHOLIDAYINFO
{
  DWORD cbSize; /* must be set to sizeof(JEWCALGETHOLIDAYINFO) */

  LPJEWCALDATE lpGregorianDate;
  BOOL fDiaspora;
  BOOL fPostponeShushanPurim;
  LPTSTR lpString;
  UINT cbMax;
  LPTSTR lpLanguage;
  LPTSTR lpNameFile;

  /* New in version 1.1 */
  int iDayOfHoliday;
  int iWeekdayOfHoliday;
} JEWCALGETHOLIDAYINFO;
typedef JEWCALGETHOLIDAYINFO FAR* LPJEWCALGETHOLIDAYINFO;

Members

cbSize
Must contain the size of the structure: sizeof(JEWCALGETHOLIDAYINFO)

lpGregorianDate
If it is not NULL, it must point to a JEWCALDATE structure which specifies the Gregorian date for which the Jewish holiday must be determined.
If it is NULL, the current date is used.

fDiaspora
If it is TRUE, calculation for Diaspora is used.
If it is FALSE, calculation for Israel is used.

fPostponeShushanPurim
If it is TRUE and when the 15th of Adar in a non-leap year or the 15th of Adar II in a leap year falls on a Saturday, Shushan Purim is postponed to Sunday.
If it is FALSE, Shushan Purim is always calculated on the 15th of Adar in a non-leap year or the 15th of Adar II in a leap year.

lpString
Must point to a string buffer which will contain the name of the Jewish holiday after execution of this function. If no Jewish holiday falls on the given Gregorian date, an empty string is returned.

cbMax
Must contain the size of the buffer lpString in characters.

lpLanguage
If it is not NULL, it must point to a language defined in NAMES.TXT.
If it is NULL, the entry with no language, that means without a dot, is retrieved if present (by default, not).

lpNameFile
If it is not NULL, it must point to the filename with full path of the NAMES.TXT file.
If it is NULL, the NAMES.TXT file is assumed to have its original name and present in the same directory where JEWCAL.DLL is located.
File format of NAMES.TXT

iDayOfHoliday
On return, it can contain one of the following values:
  • 0: The holiday is not Rosh HaShanah and does not have a second day in the Diaspora
  • 1: The retrieved holiday is the first day
  • 2: The retrieved holiday is the second day

iWeekdayOfHoliday
On return, it contains the weekday of the returned holiday.

Remarks

This structure is new in version 1.1

The weekday in iWeekdayOfHoliday can have the following values:

Weekday valueMeaning
JEWCAL_WEEKDAY_SUNDAYSunday
JEWCAL_WEEKDAY_MONDAYMonday
JEWCAL_WEEKDAY_TUESDAYTuesday
JEWCAL_WEEKDAY_WEDNESDAYWednesday
JEWCAL_WEEKDAY_THURSDAYThursday
JEWCAL_WEEKDAY_FRIDAYFriday
JEWCAL_WEEKDAY_SATURDAYSaturday

See also

JEWCALDATE, JewcalGetJewishHolidayNameEx