/* +----------------------------------------------------------------------+ | Copyright (c) The PHP Group | +----------------------------------------------------------------------+ | This source file is subject to version 3.01 of the PHP license, | | that is bundled with this package in the file LICENSE, and is | | available through the world-wide-web at the following url: | | http://www.php.net/license/3_01.txt | | If you did not receive a copy of the PHP license and are unable to | | obtain it through the world-wide-web, please send a note to | | license@php.net so we can mail you a copy immediately. | +----------------------------------------------------------------------+ | Authors: Shane Caraveo | | Colin Viebrock | | Hartmut Holzgraefe | | Wez Furlong | +----------------------------------------------------------------------+ */ #ifdef HAVE_CONFIG_H #include "config.h" #endif #include "php.h" #include "ext/standard/info.h" #include "calendar_arginfo.h" #include "php_calendar.h" #include "sdncal.h" #include #ifdef PHP_WIN32 /* This conflicts with a define in winnls.h, but that header is needed to have GetACP(). */ #undef CAL_GREGORIAN #endif zend_module_entry calendar_module_entry = { STANDARD_MODULE_HEADER, "calendar", ext_functions, PHP_MINIT(calendar), NULL, NULL, NULL, PHP_MINFO(calendar), PHP_CALENDAR_VERSION, STANDARD_MODULE_PROPERTIES, }; #ifdef COMPILE_DL_CALENDAR ZEND_GET_MODULE(calendar) #endif /* this order must match the conversion table below */ enum cal_name_type_t { CAL_GREGORIAN = 0, CAL_JULIAN, CAL_JEWISH, CAL_FRENCH, CAL_NUM_CALS }; typedef zend_long (*cal_to_jd_func_t) (int month, int day, int year); typedef void (*cal_from_jd_func_t) (zend_long jd, int *year, int *month, int *day); typedef char *(*cal_as_string_func_t) (int year, int month, int day); struct cal_entry_t { const char *name; const char *symbol; cal_to_jd_func_t to_jd; cal_from_jd_func_t from_jd; int num_months; int max_days_in_month; const char * const * month_name_short; const char * const * month_name_long; }; static const struct cal_entry_t cal_conversion_table[CAL_NUM_CALS] = { {"Gregorian", "CAL_GREGORIAN", GregorianToSdn, SdnToGregorian, 12, 31, MonthNameShort, MonthNameLong}, {"Julian", "CAL_JULIAN", JulianToSdn, SdnToJulian, 12, 31, MonthNameShort, MonthNameLong}, {"Jewish", "CAL_JEWISH", JewishToSdn, SdnToJewish, 13, 30, JewishMonthNameLeap, JewishMonthNameLeap}, {"French", "CAL_FRENCH", FrenchToSdn, SdnToFrench, 13, 30, FrenchMonthName, FrenchMonthName} }; #define JEWISH_MONTH_NAME(year) ((monthsPerYear[((year)-1) % 19] == 13)?JewishMonthNameLeap:JewishMonthName) #define JEWISH_HEB_MONTH_NAME(year) ((monthsPerYear[((year)-1) % 19] == 13)?JewishMonthHebNameLeap:JewishMonthHebName) /* For jddayofweek */ enum { CAL_DOW_DAYNO, CAL_DOW_LONG, CAL_DOW_SHORT }; /* For jdmonthname */ enum { CAL_MONTH_GREGORIAN_SHORT, CAL_MONTH_GREGORIAN_LONG, CAL_MONTH_JULIAN_SHORT, CAL_MONTH_JULIAN_LONG, CAL_MONTH_JEWISH, CAL_MONTH_FRENCH }; /* For heb_number_to_chars escape sequences of אבגדהוזחטיכלמנסעפצקרשת ISO-8859-8 Hebrew alphabet */ static const char alef_bet[25] = "0\xE0\xE1\xE2\xE3\xE4\xE5\xE6\xE7\xE8\xE9\xEB\xEC\xEE\xF0\xF1\xF2\xF4\xF6\xF7\xF8\xF9\xFA"; #define CAL_JEWISH_ADD_ALAFIM_GERESH 0x2 #define CAL_JEWISH_ADD_ALAFIM 0x4 #define CAL_JEWISH_ADD_GERESHAYIM 0x8 PHP_MINIT_FUNCTION(calendar) { REGISTER_LONG_CONSTANT("CAL_GREGORIAN", CAL_GREGORIAN, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_JULIAN", CAL_JULIAN, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_JEWISH", CAL_JEWISH, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_FRENCH", CAL_FRENCH, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_NUM_CALS", CAL_NUM_CALS, CONST_CS | CONST_PERSISTENT); /* constants for jddayofweek */ REGISTER_LONG_CONSTANT("CAL_DOW_DAYNO", CAL_DOW_DAYNO, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_DOW_SHORT", CAL_DOW_SHORT, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_DOW_LONG", CAL_DOW_LONG, CONST_CS | CONST_PERSISTENT); /* constants for jdmonthname */ REGISTER_LONG_CONSTANT("CAL_MONTH_GREGORIAN_SHORT", CAL_MONTH_GREGORIAN_SHORT, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_MONTH_GREGORIAN_LONG", CAL_MONTH_GREGORIAN_LONG, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_MONTH_JULIAN_SHORT", CAL_MONTH_JULIAN_SHORT, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_MONTH_JULIAN_LONG", CAL_MONTH_JULIAN_LONG, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_MONTH_JEWISH", CAL_MONTH_JEWISH, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_MONTH_FRENCH", CAL_MONTH_FRENCH, CONST_CS | CONST_PERSISTENT); /* constants for easter calculation */ REGISTER_LONG_CONSTANT("CAL_EASTER_DEFAULT", CAL_EASTER_DEFAULT, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_EASTER_ROMAN", CAL_EASTER_ROMAN, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_EASTER_ALWAYS_GREGORIAN", CAL_EASTER_ALWAYS_GREGORIAN, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_EASTER_ALWAYS_JULIAN", CAL_EASTER_ALWAYS_JULIAN, CONST_CS | CONST_PERSISTENT); /* constants for Jewish date formatting */ REGISTER_LONG_CONSTANT("CAL_JEWISH_ADD_ALAFIM_GERESH", CAL_JEWISH_ADD_ALAFIM_GERESH, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_JEWISH_ADD_ALAFIM", CAL_JEWISH_ADD_ALAFIM, CONST_CS | CONST_PERSISTENT); REGISTER_LONG_CONSTANT("CAL_JEWISH_ADD_GERESHAYIM", CAL_JEWISH_ADD_GERESHAYIM, CONST_CS | CONST_PERSISTENT); return SUCCESS; } PHP_MINFO_FUNCTION(calendar) { php_info_print_table_start(); php_info_print_table_row(2, "Calendar support", "enabled"); php_info_print_table_end(); } static void _php_cal_info(int cal, zval *ret) { zval months, smonths; int i; const struct cal_entry_t *calendar; calendar = &cal_conversion_table[cal]; array_init(ret); array_init(&months); array_init(&smonths); for (i = 1; i <= calendar->num_months; i++) { add_index_string(&months, i, calendar->month_name_long[i]); add_index_string(&smonths, i, calendar->month_name_short[i]); } add_assoc_zval(ret, "months", &months); add_assoc_zval(ret, "abbrevmonths", &smonths); add_assoc_long(ret, "maxdaysinmonth", calendar->max_days_in_month); add_assoc_string(ret, "calname", calendar->name); add_assoc_string(ret, "calsymbol", calendar->symbol); } /* {{{ Returns information about a particular calendar */ PHP_FUNCTION(cal_info) { zend_long cal = -1; if (zend_parse_parameters(ZEND_NUM_ARGS(), "|l", &cal) == FAILURE) { RETURN_THROWS(); } if (cal == -1) { int i; zval val; array_init(return_value); for (i = 0; i < CAL_NUM_CALS; i++) { _php_cal_info(i, &val); add_index_zval(return_value, i, &val); } return; } if (cal < 0 || cal >= CAL_NUM_CALS) { zend_argument_value_error(1, "must be a valid calendar ID"); RETURN_THROWS(); } _php_cal_info(cal, return_value); } /* }}} */ /* {{{ Returns the number of days in a month for a given year and calendar */ PHP_FUNCTION(cal_days_in_month) { zend_long cal, month, year; const struct cal_entry_t *calendar; zend_long sdn_start, sdn_next; if (zend_parse_parameters(ZEND_NUM_ARGS(), "lll", &cal, &month, &year) == FAILURE) { RETURN_THROWS(); } if (cal < 0 || cal >= CAL_NUM_CALS) { zend_argument_value_error(1, "must be a valid calendar ID"); RETURN_THROWS(); } calendar = &cal_conversion_table[cal]; sdn_start = calendar->to_jd(year, month, 1); if (sdn_start == 0) { zend_value_error("Invalid date"); RETURN_THROWS(); } sdn_next = calendar->to_jd(year, 1 + month, 1); if (sdn_next == 0) { /* If the next month is invalid, then we need to try the first month of * the next year, bearing in mind that the next year after 1 BCE is * actually 1 AD and not 0. */ if (year == -1) { sdn_next = calendar->to_jd(1, 1, 1); } else { sdn_next = calendar->to_jd(year + 1, 1, 1); if (cal == CAL_FRENCH && sdn_next == 0) { /* The French calendar ends on 0014-13-05. */ sdn_next = 2380953; } } } RETURN_LONG(sdn_next - sdn_start); } /* }}} */ /* {{{ Converts from a supported calendar to Julian Day Count */ PHP_FUNCTION(cal_to_jd) { zend_long cal, month, day, year; if (zend_parse_parameters(ZEND_NUM_ARGS(), "llll", &cal, &month, &day, &year) != SUCCESS) { RETURN_THROWS(); } if (cal < 0 || cal >= CAL_NUM_CALS) { zend_argument_value_error(1, "must be a valid calendar ID"); RETURN_THROWS(); } RETURN_LONG(cal_conversion_table[cal].to_jd(year, month, day)); } /* }}} */ /* {{{ Converts from Julian Day Count to a supported calendar and return extended information */ PHP_FUNCTION(cal_from_jd) { zend_long jd, cal; int month, day, year, dow; const struct cal_entry_t *calendar; if (zend_parse_parameters(ZEND_NUM_ARGS(), "ll", &jd, &cal) == FAILURE) { RETURN_THROWS(); } if (cal < 0 || cal >= CAL_NUM_CALS) { zend_argument_value_error(2, "must be a valid calendar ID"); RETURN_THROWS(); } calendar = &cal_conversion_table[cal]; array_init(return_value); calendar->from_jd(jd, &year, &month, &day); add_assoc_str(return_value, "date", zend_strpprintf(0, "%i/%i/%i", month, day, year)); add_assoc_long(return_value, "month", month); add_assoc_long(return_value, "day", day); add_assoc_long(return_value, "year", year); /* day of week */ if (cal != CAL_JEWISH || year > 0) { dow = DayOfWeek(jd); add_assoc_long(return_value, "dow", dow); add_assoc_string(return_value, "abbrevdayname", DayNameShort[dow]); add_assoc_string(return_value, "dayname", DayNameLong[dow]); } else { add_assoc_null(return_value, "dow"); add_assoc_string(return_value, "abbrevdayname", ""); add_assoc_string(return_value, "dayname", ""); } /* month name */ if(cal == CAL_JEWISH) { /* special case for Jewish calendar */ add_assoc_string(return_value, "abbrevmonth", (year > 0 ? JEWISH_MONTH_NAME(year)[month] : "")); add_assoc_string(return_value, "monthname", (year > 0 ? JEWISH_MONTH_NAME(year)[month] : "")); } else { add_assoc_string(return_value, "abbrevmonth", calendar->month_name_short[month]); add_assoc_string(return_value, "monthname", calendar->month_name_long[month]); } } /* }}} */ /* {{{ Converts a julian day count to a gregorian calendar date */ PHP_FUNCTION(jdtogregorian) { zend_long julday; int year, month, day; if (zend_parse_parameters(ZEND_NUM_ARGS(), "l", &julday) == FAILURE) { RETURN_THROWS(); } SdnToGregorian(julday, &year, &month, &day); RETURN_NEW_STR(zend_strpprintf(0, "%i/%i/%i", month, day, year)); } /* }}} */ /* {{{ Converts a gregorian calendar date to julian day count */ PHP_FUNCTION(gregoriantojd) { zend_long year, month, day; if (zend_parse_parameters(ZEND_NUM_ARGS(), "lll", &month, &day, &year) == FAILURE) { RETURN_THROWS(); } RETURN_LONG(GregorianToSdn(year, month, day)); } /* }}} */ /* {{{ Convert a julian day count to a julian calendar date */ PHP_FUNCTION(jdtojulian) { zend_long julday; int year, month, day; if (zend_parse_parameters(ZEND_NUM_ARGS(), "l", &julday) == FAILURE) { RETURN_THROWS(); } SdnToJulian(julday, &year, &month, &day); RETURN_NEW_STR(zend_strpprintf(0, "%i/%i/%i", month, day, year)); } /* }}} */ /* {{{ Converts a julian calendar date to julian day count */ PHP_FUNCTION(juliantojd) { zend_long year, month, day; if (zend_parse_parameters(ZEND_NUM_ARGS(), "lll", &month, &day, &year) == FAILURE) { RETURN_THROWS(); } RETURN_LONG(JulianToSdn(year, month, day)); } /* }}} */ /* {{{ heb_number_to_chars*/ /* caution: the Hebrew format produces non unique result. for example both: year '5' and year '5000' produce 'ה'. use the numeric one for calculations. */ static char *heb_number_to_chars(int n, int fl, char **ret) { char *p, old[18], *endofalafim; p = endofalafim = old; /* prevents the option breaking the jewish beliefs, and some other critical resources ;) */ if (n > 9999 || n < 1) { *ret = NULL; return NULL; } /* alafim (thousands) case */ if (n / 1000) { *p = alef_bet[n / 1000]; p++; if (CAL_JEWISH_ADD_ALAFIM_GERESH & fl) { *p = '\''; p++; } if (CAL_JEWISH_ADD_ALAFIM & fl) { /* Escape sequences of Hebrew characters in ISO-8859-8: אלפים */ strcpy(p, " \xE0\xEC\xF4\xE9\xED "); p += 7; } endofalafim = p; n = n % 1000; } /* tav-tav (tav=400) case */ while (n >= 400) { *p = alef_bet[22]; p++; n -= 400; } /* meot (hundreads) case */ if (n >= 100) { *p = alef_bet[18 + n / 100]; p++; n = n % 100; } /* tet-vav & tet-zain case (special case for 15 and 16) */ if (n == 15 || n == 16) { *p = alef_bet[9]; p++; *p = alef_bet[n - 9]; p++; } else { /* asarot (tens) case */ if (n >= 10) { *p = alef_bet[9 + n / 10]; p++; n = n % 10; } /* yehidot (ones) case */ if (n > 0) { *p = alef_bet[n]; p++; } } if (CAL_JEWISH_ADD_GERESHAYIM & fl) { switch (p - endofalafim) { case 0: break; case 1: *p = '\''; p++; break; default: *(p) = *(p - 1); *(p - 1) = '"'; p++; } } *p = '\0'; *ret = estrndup(old, (p - old) + 1); p = *ret; return p; } /* }}} */ /* {{{ Converts a julian day count to a jewish calendar date */ PHP_FUNCTION(jdtojewish) { zend_long julday, fl = 0; bool heb = 0; int year, month, day; char *dayp, *yearp; if (zend_parse_parameters(ZEND_NUM_ARGS(), "l|bl", &julday, &heb, &fl) == FAILURE) { RETURN_THROWS(); } SdnToJewish(julday, &year, &month, &day); if (!heb) { RETURN_NEW_STR(zend_strpprintf(0, "%i/%i/%i", month, day, year)); } else { if (year <= 0 || year > 9999) { zend_value_error("Year out of range (0-9999)"); RETURN_THROWS(); } RETVAL_NEW_STR(zend_strpprintf(0, "%s %s %s", heb_number_to_chars(day, fl, &dayp), JEWISH_HEB_MONTH_NAME(year)[month], heb_number_to_chars(year, fl, &yearp))); if (dayp) { efree(dayp); } if (yearp) { efree(yearp); } } } /* }}} */ /* {{{ Converts a jewish calendar date to a julian day count */ PHP_FUNCTION(jewishtojd) { zend_long year, month, day; if (zend_parse_parameters(ZEND_NUM_ARGS(), "lll", &month, &day, &year) == FAILURE) { RETURN_THROWS(); } RETURN_LONG(JewishToSdn(year, month, day)); } /* }}} */ /* {{{ Converts a julian day count to a french republic calendar date */ PHP_FUNCTION(jdtofrench) { zend_long julday; int year, month, day; if (zend_parse_parameters(ZEND_NUM_ARGS(), "l", &julday) == FAILURE) { RETURN_THROWS(); } SdnToFrench(julday, &year, &month, &day); RETURN_NEW_STR(zend_strpprintf(0, "%i/%i/%i", month, day, year)); } /* }}} */ /* {{{ Converts a french republic calendar date to julian day count */ PHP_FUNCTION(frenchtojd) { zend_long year, month, day; if (zend_parse_parameters(ZEND_NUM_ARGS(), "lll", &month, &day, &year) == FAILURE) { RETURN_THROWS(); } RETURN_LONG(FrenchToSdn(year, month, day)); } /* }}} */ /* {{{ Returns name or number of day of week from julian day count */ PHP_FUNCTION(jddayofweek) { zend_long julday, mode = CAL_DOW_DAYNO; int day; const char *daynamel, *daynames; if (zend_parse_parameters(ZEND_NUM_ARGS(), "l|l", &julday, &mode) == FAILURE) { RETURN_THROWS(); } day = DayOfWeek(julday); daynamel = DayNameLong[day]; daynames = DayNameShort[day]; switch (mode) { case CAL_DOW_LONG: RETURN_STRING(daynamel); break; case CAL_DOW_SHORT: RETURN_STRING(daynames); break; case CAL_DOW_DAYNO: default: RETURN_LONG(day); break; } } /* }}} */ /* {{{ Returns name of month for julian day count */ PHP_FUNCTION(jdmonthname) { zend_long julday, mode; const char *monthname = NULL; int month, day, year; if (zend_parse_parameters(ZEND_NUM_ARGS(), "ll", &julday, &mode) == FAILURE) { RETURN_THROWS(); } switch (mode) { case CAL_MONTH_GREGORIAN_LONG: /* gregorian or julian month */ SdnToGregorian(julday, &year, &month, &day); monthname = MonthNameLong[month]; break; case CAL_MONTH_JULIAN_SHORT: /* gregorian or julian month */ SdnToJulian(julday, &year, &month, &day); monthname = MonthNameShort[month]; break; case CAL_MONTH_JULIAN_LONG: /* gregorian or julian month */ SdnToJulian(julday, &year, &month, &day); monthname = MonthNameLong[month]; break; case CAL_MONTH_JEWISH: /* jewish month */ SdnToJewish(julday, &year, &month, &day); monthname = (year > 0 ? JEWISH_MONTH_NAME(year)[month] : ""); break; case CAL_MONTH_FRENCH: /* french month */ SdnToFrench(julday, &year, &month, &day); monthname = FrenchMonthName[month]; break; default: /* default gregorian */ case CAL_MONTH_GREGORIAN_SHORT: /* gregorian or julian month */ SdnToGregorian(julday, &year, &month, &day); monthname = MonthNameShort[month]; break; } RETURN_STRING(monthname); } /* }}} */