/*
-**********************************************************************
-* Copyright (c) 2003-2004, International Business Machines
-* Corporation and others. All Rights Reserved.
-**********************************************************************
-* Author: Alan Liu
-* Created: September 2 2003
-* Since: ICU 2.8
-**********************************************************************
-*/
+ **********************************************************************
+ * Copyright (c) 2003-2008, International Business Machines
+ * Corporation and others. All Rights Reserved.
+ **********************************************************************
+ * Author: Alan Liu
+ * Created: September 2 2003
+ * Since: ICU 2.8
+ **********************************************************************
+ */
+
#ifndef GREGOIMP_H
#define GREGOIMP_H
#include "unicode/utypes.h"
/**
* A utility class providing mathematical functions used by time zone
- * and calendar code. Do not instantiate.
+ * and calendar code. Do not instantiate. Formerly just named 'Math'.
+ * @internal
*/
-class U_I18N_API Math {
+class ClockMath {
public:
/**
* Divide two integers, returning the floor of the quotient.
* Note: Unlike GregorianCalendar, all computations performed by this
* class occur in the pure proleptic GregorianCalendar.
*/
-class U_I18N_API Grego {
+class Grego {
public:
/**
* Return TRUE if the given year is a leap year.
static inline void dayToFields(double day, int32_t& year, int32_t& month,
int32_t& dom, int32_t& dow);
+ /**
+ * Convert a 1970-epoch milliseconds to proleptic Gregorian year,
+ * month, day-of-month, and day-of-week, day of year and millis-in-day.
+ * @param time 1970-epoch milliseconds
+ * @param year output parameter to receive year
+ * @param month output parameter to receive month (0-based, 0==Jan)
+ * @param dom output parameter to receive day-of-month (1-based)
+ * @param dow output parameter to receive day-of-week (1-based, 1==Sun)
+ * @param doy output parameter to receive day-of-year (1-based)
+ * @param mid output parameter to recieve millis-in-day
+ */
+ static void timeToFields(UDate time, int32_t& year, int32_t& month,
+ int32_t& dom, int32_t& dow, int32_t& doy, int32_t& mid);
+
+ /**
+ * Return the day of week on the 1970-epoch day
+ * @param day the 1970-epoch day (integral value)
+ * @return the day of week
+ */
+ static int32_t dayOfWeek(double day);
+
+ /**
+ * Returns the ordinal number for the specified day of week within the month.
+ * The valid return value is 1, 2, 3, 4 or -1.
+ * @param year Gregorian year, with 0 == 1 BCE, -1 == 2 BCE, etc.
+ * @param month 0-based month, with 0==Jan
+ * @param dom 1-based day of month
+ * @return The ordinal number for the specified day of week within the month
+ */
+ static int32_t dayOfWeekInMonth(int32_t year, int32_t month, int32_t dom);
+
/**
* Converts Julian day to time as milliseconds.
* @param julian the given Julian day number.
static const int8_t MONTH_LENGTH[24];
};
-inline double Math::floorDivide(double numerator, double denominator) {
+inline double ClockMath::floorDivide(double numerator, double denominator) {
return uprv_floor(numerator / denominator);
}
inline int8_t
Grego::monthLength(int32_t year, int32_t month) {
- return MONTH_LENGTH[month + isLeapYear(year)?12:0];
+ return MONTH_LENGTH[month + (isLeapYear(year) ? 12 : 0)];
}
inline int8_t
}
inline int32_t Grego::millisToJulianDay(double millis) {
- return (int32_t) (kEpochStartAsJulianDay + Math::floorDivide(millis, (double)kOneDay));
+ return (int32_t) (kEpochStartAsJulianDay + ClockMath::floorDivide(millis, (double)kOneDay));
}
inline int32_t Grego::gregorianShift(int32_t eyear) {
int32_t y = eyear-1;
- int32_t gregShift = Math::floorDivide(y, 400) - Math::floorDivide(y, 100) + 2;
+ int32_t gregShift = ClockMath::floorDivide(y, 400) - ClockMath::floorDivide(y, 100) + 2;
return gregShift;
}
/**
- * This class provides convenient access to the data needed for a calendar.
+ * This utility class provides convenient access to the data needed for a calendar.
* @internal ICU 3.0
*/
-class U_I18N_API CalendarData : public UObject {
+class CalendarData : public UMemory {
public:
/**
* Construct a CalendarData from the given locale.
*/
UResourceBundle* getByKey2(const char *key, const char *subKey, UErrorCode& status);
- ~CalendarData();
-
/**
- * Override Calendar Returns a unique class ID POLYMORPHICALLY. Pure virtual
- * override. This method is to implement a simple version of RTTI, since not all C++
- * compilers support genuine RTTI. Polymorphic operator==() and clone() methods call
- * this method.
+ * Load data for calendar. Note, this object owns the resources, do NOT call ures_close()!
+ * data is located in: "calendar/key/contextKey/subKey"
+ * for example, calendar/dayNames/standalone/narrow
+ * The ResourceBundle C++ API should NOT be used because it is too slow for a low level API.
*
- * @return The class ID for this object. All objects of a given class have the
- * same class ID. Objects of other classes have different class IDs.
- * @stable ICU 2.0
+ * @param key Resource key to data
+ * @param contextKey Resource key to data
+ * @param subKey Resource key to data
+ * @param status Error Status
+ * @internal
*/
- virtual UClassID getDynamicClassID(void) const;
+ UResourceBundle* getByKey3(const char *key, const char *contextKey, const char *subKey, UErrorCode& status);
- /**
- * Return the class ID for this class. This is useful only for comparing to a return
- * value from getDynamicClassID(). For example:
- *
- * Base* polymorphic_pointer = createPolymorphicObject();
- * if (polymorphic_pointer->getDynamicClassID() ==
- * Derived::getStaticClassID()) ...
- *
- * @return The class ID for all objects of this class.
- * @stable ICU 2.0
- */
- static UClassID U_EXPORT2 getStaticClassID(void);
+ ~CalendarData();
private:
void initData(const char *locale, const char *type, UErrorCode& status);
projects / apple / icu.git / blobdiff