зеркало из https://github.com/mozilla/gecko-dev.git
671 строка
29 KiB
C
671 строка
29 KiB
C
|
/*
|
||
|
|
********************************************************************************
|
||
|
|
* *
|
||
|
|
* COPYRIGHT: *
|
||
|
|
* (C) Copyright Taligent, Inc., 1997 *
|
||
|
|
* (C) Copyright International Business Machines Corporation, 1997 *
|
||
|
|
* Licensed Material - Program-Property of IBM - All Rights Reserved. *
|
||
|
|
* US Government Users Restricted Rights - Use, duplication, or disclosure *
|
||
|
|
* restricted by GSA ADP Schedule Contract with IBM Corp. *
|
||
|
|
* *
|
||
|
|
********************************************************************************
|
||
|
|
*
|
||
|
|
* File SMPDTFMT.H
|
||
|
|
*
|
||
|
|
* Modification History:
|
||
|
|
*
|
||
|
|
* Date Name Description
|
||
|
|
* 02/19/97 aliu Converted from java.
|
||
|
|
* 07/09/97 helena Make ParsePosition into a class.
|
||
|
|
********************************************************************************
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef _SMPDTFMT
|
||
|
|
#define _SMPDTFMT
|
||
|
|
|
||
|
|
#include "ptypes.h"
|
||
|
|
#include "datefmt.h"
|
||
|
|
class DateFormatSymbols;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* SimpleDateFormat is a concrete class for formatting and parsing dates in a
|
||
|
|
* language-independent manner. It allows for formatting (millis -> text),
|
||
|
|
* parsing (text -> millis), and normalization. Formats/Parses a date or time,
|
||
|
|
* which is the standard milliseconds since 24:00 GMT, Jan 1, 1970.
|
||
|
|
* <P>
|
||
|
|
* Clients are encouraged to create a date-time formatter using DateFormat::getInstance(),
|
||
|
|
* getDateInstance(), getDateInstance(), or getDateTimeInstance() rather than
|
||
|
|
* explicitly constructing an instance of SimpleDateFormat. This way, the client
|
||
|
|
* is guaranteed to get an appropriate formatting pattern for whatever locale the
|
||
|
|
* program is running in. However, if the client needs something more unusual than
|
||
|
|
* the default patterns in the locales, he can construct a SimpleDateFormat directly
|
||
|
|
* and give it an appropriate pattern (or use one of the factory methods on DateFormat
|
||
|
|
* and modify the pattern after the fact with toPattern() and applyPattern().
|
||
|
|
* <P>
|
||
|
|
* Date/Time format syntax:
|
||
|
|
* <P>
|
||
|
|
* The date/time format is specified by means of a string time pattern. In this
|
||
|
|
* pattern, all ASCII letters are reserved as pattern letters, which are defined
|
||
|
|
* as the following:
|
||
|
|
* <pre>
|
||
|
|
* . Symbol Meaning Presentation Example
|
||
|
|
* . ------ ------- ------------ -------
|
||
|
|
* . G era designator (Text) AD
|
||
|
|
* . y year (Number) 1996
|
||
|
|
* . M month in year (Text & Number) July & 07
|
||
|
|
* . d day in month (Number) 10
|
||
|
|
* . h hour in am/pm (1~12) (Number) 12
|
||
|
|
* . H hour in day (0~23) (Number) 0
|
||
|
|
* . m minute in hour (Number) 30
|
||
|
|
* . s second in minute (Number) 55
|
||
|
|
* . S millisecond (Number) 978
|
||
|
|
* . E day in week (Text) Tuesday
|
||
|
|
* . D day in year (Number) 189
|
||
|
|
* . F day of week in month (Number) 2 (2nd Wed in July)
|
||
|
|
* . w week in year (Number) 27
|
||
|
|
* . W week in month (Number) 2
|
||
|
|
* . a am/pm marker (Text) PM
|
||
|
|
* . k hour in day (1~24) (Number) 24
|
||
|
|
* . K hour in am/pm (0~11) (Number) 0
|
||
|
|
* . z time zone (Text) Pacific Standard Time
|
||
|
|
* . ' escape for text
|
||
|
|
* . '' single quote '
|
||
|
|
* </pre>
|
||
|
|
* The count of pattern letters determine the format.
|
||
|
|
* <P>
|
||
|
|
* (Text): 4 or more, use full form, <4, use short or abbreviated form if it
|
||
|
|
* exists. (e.g., "EEEE" produces "Monday", "EEE" produces "Mon")
|
||
|
|
* <P>
|
||
|
|
* (Number): the minimum number of digits. Shorter numbers are zero-padded to
|
||
|
|
* this amount (e.g. if "m" produces "6", "mm" produces "06"). Year is handled
|
||
|
|
* specially; that is, if the count of 'y' is 2, the Year will be truncated to 2 digits.
|
||
|
|
* (e.g., if "yyyy" produces "1997", "yy" produces "97".)
|
||
|
|
* <P>
|
||
|
|
* (Text & Number): 3 or over, use text, otherwise use number. (e.g., "M" produces "1",
|
||
|
|
* "MM" produces "01", "MMM" produces "Jan", and "MMMM" produces "January".)
|
||
|
|
* <P>
|
||
|
|
* Any characters in the pattern that are not in the ranges of ['a'..'z'] and
|
||
|
|
* ['A'..'Z'] will be treated as quoted text. For instance, characters
|
||
|
|
* like ':', '.', ' ', '#' and '@' will appear in the resulting time text
|
||
|
|
* even they are not embraced within single quotes.
|
||
|
|
* <P>
|
||
|
|
* A pattern containing any invalid pattern letter will result in a failing
|
||
|
|
* ErrorCode result during formatting or parsing.
|
||
|
|
* <P>
|
||
|
|
* Examples using the US locale:
|
||
|
|
* <pre>
|
||
|
|
* . Format Pattern Result
|
||
|
|
* . -------------- -------
|
||
|
|
* . "yyyy.MM.dd G 'at' HH:mm:ss z" ->> 1996.07.10 AD at 15:08:56 PDT
|
||
|
|
* . "EEE, MMM d, ''yy" ->> Wed, July 10, '96
|
||
|
|
* . "h:mm a" ->> 12:08 PM
|
||
|
|
* . "hh 'o''clock' a, zzzz" ->> 12 o'clock PM, Pacific Daylight Time
|
||
|
|
* . "K:mm a, z" ->> 0:00 PM, PST
|
||
|
|
* . "yyyyy.MMMMM.dd GGG hh:mm aaa" ->> 1996.July.10 AD 12:08 PM
|
||
|
|
* </pre>
|
||
|
|
* Code Sample:
|
||
|
|
* <pre>
|
||
|
|
* . SimpleTimeZone *pdt = new SimpleTimeZone(-8 * 60 * 60 * 1000);
|
||
|
|
* . pdt->setStartRule(DateFields.APRIL, 1, DateFields.SUNDAY, 2*60*60*1000);
|
||
|
|
* . pdt->setEndRule(DateFields.OCTOBER, -1, DateFields.SUNDAY, 2*60*60*1000);
|
||
|
|
*
|
||
|
|
* . // Format the current time.
|
||
|
|
* . SimpleDateFormat *formatter
|
||
|
|
* . = new SimpleDateFormat ("yyyy.mm.dd G 'at' hh:mm:ss a zzz");
|
||
|
|
* . Date *currentTime_1 = new Date();
|
||
|
|
* . FieldPosition pos(0);
|
||
|
|
* . String dateString;
|
||
|
|
* . formatter.format(currentTime_1, dateString, pos);
|
||
|
|
* .
|
||
|
|
* . // Parse the previous string back into a Date.
|
||
|
|
* . ParsePosition pos(0);
|
||
|
|
* . formatter.parse(currentTime_2, dateString, pos);
|
||
|
|
* </pre>
|
||
|
|
* In the above example, the time value "currentTime_2" obtained from parsing
|
||
|
|
* will be equal to currentTime_1. However, they may not be equal if the am/pm
|
||
|
|
* marker 'a' is left out from the format pattern while the "hour in am/pm"
|
||
|
|
* pattern symbol is used. This information loss can happen when formatting the
|
||
|
|
* time in PM.
|
||
|
|
* <P>
|
||
|
|
* For time zones that have no names, SimpleDateFormat uses strings GMT+hours:minutes or
|
||
|
|
* GMT-hours:minutes.
|
||
|
|
* <P>
|
||
|
|
* The calendar defines what is the first day of the week, the first week of the
|
||
|
|
* year, whether hours are zero based or not (0 vs 12 or 24), and the timezone.
|
||
|
|
* There is one common number format to handle all the numbers; the digit count
|
||
|
|
* is handled programmatically according to the pattern.
|
||
|
|
*/
|
||
|
|
#ifdef NLS_MAC
|
||
|
|
#pragma export on
|
||
|
|
#endif
|
||
|
|
class T_FORMAT_API SimpleDateFormat: public DateFormat {
|
||
|
|
public:
|
||
|
|
/**
|
||
|
|
* Construct a SimpleDateFormat using the default pattern for the default
|
||
|
|
* locale.
|
||
|
|
* <P>
|
||
|
|
* [Note:] Not all locales support SimpleDateFormat; for full generality,
|
||
|
|
* use the factory methods in the DateFormat class.
|
||
|
|
*/
|
||
|
|
SimpleDateFormat(ErrorCode& status);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Construct a SimpleDateFormat using the given pattern and the default locale.
|
||
|
|
* The locale is used to obtain the symbols used in formatting (e.g., the
|
||
|
|
* names of the months), but not to provide the pattern.
|
||
|
|
* <P>
|
||
|
|
* [Note:] Not all locales support SimpleDateFormat; for full generality,
|
||
|
|
* use the factory methods in the DateFormat class.
|
||
|
|
*/
|
||
|
|
SimpleDateFormat(const UnicodeString& pattern,
|
||
|
|
ErrorCode& status);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Construct a SimpleDateFormat using the given pattern and locale.
|
||
|
|
* The locale is used to obtain the symbols used in formatting (e.g., the
|
||
|
|
* names of the months), but not to provide the pattern.
|
||
|
|
* <P>
|
||
|
|
* [Note:] Not all locales support SimpleDateFormat; for full generality,
|
||
|
|
* use the factory methods in the DateFormat class.
|
||
|
|
*/
|
||
|
|
SimpleDateFormat(const UnicodeString& pattern,
|
||
|
|
const Locale& locale,
|
||
|
|
ErrorCode& status);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Construct a SimpleDateFormat using the given pattern and locale-specific
|
||
|
|
* symbol data. The formatter takes ownership of the DateFormatSymbols object;
|
||
|
|
* the caller is no longer responsible for deleting it.
|
||
|
|
*/
|
||
|
|
SimpleDateFormat(const UnicodeString& pattern,
|
||
|
|
DateFormatSymbols* formatDataToAdopt,
|
||
|
|
ErrorCode& status);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Construct a SimpleDateFormat using the given pattern and locale-specific
|
||
|
|
* symbol data. The DateFormatSymbols object is NOT adopted; the caller
|
||
|
|
* remains responsible for deleting it.
|
||
|
|
*/
|
||
|
|
SimpleDateFormat(const UnicodeString& pattern,
|
||
|
|
const DateFormatSymbols& formatData,
|
||
|
|
ErrorCode& status);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Copy constructor.
|
||
|
|
*/
|
||
|
|
SimpleDateFormat(const SimpleDateFormat&);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Assignment operator.
|
||
|
|
*/
|
||
|
|
SimpleDateFormat& operator=(const SimpleDateFormat&);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Destructor.
|
||
|
|
*/
|
||
|
|
virtual ~SimpleDateFormat();
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Clone this Format object polymorphically. The caller owns the result and
|
||
|
|
* should delete it when done.
|
||
|
|
*/
|
||
|
|
virtual Format* clone() const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Return true if the given Format objects are semantically equal. Objects
|
||
|
|
* of different subclasses are considered unequal.
|
||
|
|
*/
|
||
|
|
virtual t_bool operator==(const Format& other) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Format a date or time, which is the standard millis since 24:00 GMT, Jan
|
||
|
|
* 1, 1970. Overrides DateFormat pure virtual method.
|
||
|
|
* <P>
|
||
|
|
* Example: using the US locale: "yyyy.MM.dd e 'at' HH:mm:ss zzz" ->>
|
||
|
|
* 1996.07.10 AD at 15:08:56 PDT
|
||
|
|
*
|
||
|
|
* @param date The date-time value to be formatted into a date-time string.
|
||
|
|
* @param toAppendTo The result of the formatting operation is appended to this
|
||
|
|
* string.
|
||
|
|
* @param pos The formatting position. On input: an alignment field,
|
||
|
|
* if desired. On output: the offsets of the alignment field.
|
||
|
|
* @return A reference to 'toAppendTo'.
|
||
|
|
*/
|
||
|
|
virtual UnicodeString& format( Date date,
|
||
|
|
UnicodeString& toAppendTo,
|
||
|
|
FieldPosition& pos) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Format a date or time, which is the standard millis since 24:00 GMT, Jan
|
||
|
|
* 1, 1970. Overrides DateFormat pure virtual method.
|
||
|
|
* <P>
|
||
|
|
* Example: using the US locale: "yyyy.MM.dd e 'at' HH:mm:ss zzz" ->>
|
||
|
|
* 1996.07.10 AD at 15:08:56 PDT
|
||
|
|
*
|
||
|
|
* @param obj A Formattable containing the date-time value to be formatted
|
||
|
|
* into a date-time string. If the type of the Formattable
|
||
|
|
* is a numeric type, it is treated as if it were an
|
||
|
|
* instance of Date.
|
||
|
|
* @param toAppendTo The result of the formatting operation is appended to this
|
||
|
|
* string.
|
||
|
|
* @param pos The formatting position. On input: an alignment field,
|
||
|
|
* if desired. On output: the offsets of the alignment field.
|
||
|
|
* @return A reference to 'toAppendTo'.
|
||
|
|
*/
|
||
|
|
virtual UnicodeString& format( const Formattable& obj,
|
||
|
|
UnicodeString& toAppendTo,
|
||
|
|
FieldPosition& pos,
|
||
|
|
ErrorCode& status) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Parse a date/time string starting at the given parse position. For
|
||
|
|
* example, a time text "07/10/96 4:5 PM, PDT" will be parsed into a Date
|
||
|
|
* that is equivalent to Date(837039928046).
|
||
|
|
* <P>
|
||
|
|
* By default, parsing is lenient: If the input is not in the form used by
|
||
|
|
* this object's format method but can still be parsed as a date, then the
|
||
|
|
* parse succeeds. Clients may insist on strict adherence to the format by
|
||
|
|
* calling setLenient(false).
|
||
|
|
*
|
||
|
|
* @see DateFormat::setLenient(boolean)
|
||
|
|
*
|
||
|
|
* @param text The date/time string to be parsed
|
||
|
|
* @param pos On input, the position at which to start parsing; on
|
||
|
|
* output, the position at which parsing terminated, or the
|
||
|
|
* start position if the parse failed.
|
||
|
|
* @return A valid Date if the input could be parsed.
|
||
|
|
*/
|
||
|
|
virtual Date parse( const UnicodeString& text,
|
||
|
|
ParsePosition& pos) const;
|
||
|
|
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Parse a date/time string. For example, a time text "07/10/96 4:5 PM, PDT"
|
||
|
|
* will be parsed into a Date that is equivalent to Date(837039928046).
|
||
|
|
* Parsing begins at the beginning of the string and proceeds as far as
|
||
|
|
* possible. Assuming no parse errors were encountered, this function
|
||
|
|
* doesn't return any information about how much of the string was consumed
|
||
|
|
* by the parsing. If you need that information, use the version of
|
||
|
|
* parse() that takes a ParsePosition.
|
||
|
|
*
|
||
|
|
* @param text The date/time string to be parsed
|
||
|
|
* @param status Filled in with ZERO_ERROR if the parse was successful, and with
|
||
|
|
* an error value if there was a parse error.
|
||
|
|
* @return A valid Date if the input could be parsed.
|
||
|
|
*/
|
||
|
|
virtual Date parse( const UnicodeString& text,
|
||
|
|
ErrorCode& status) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Set the start Date used to interpret two-digit year strings.
|
||
|
|
* When dates are parsed having 2-digit year strings, they are placed within
|
||
|
|
* a assumed range of 100 years starting on the two digit start date. For
|
||
|
|
* example, the string "24-Jan-17" may be in the year 1817, 1917, 2017, or
|
||
|
|
* some other year. SimpleDateFormat chooses a year so that the resultant
|
||
|
|
* date is on or after the two digit start date and within 100 years of the
|
||
|
|
* two digit start date.
|
||
|
|
* <P>
|
||
|
|
* By default, the two digit start date is set to 80 years before the current
|
||
|
|
* time at which a SimpleDateFormat object is created.
|
||
|
|
*/
|
||
|
|
virtual void setTwoDigitStartDate(Date d, ErrorCode& status);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get the start Date used to interpret two-digit year strings.
|
||
|
|
* When dates are parsed having 2-digit year strings, they are placed within
|
||
|
|
* a assumed range of 100 years starting on the two digit start date. For
|
||
|
|
* example, the string "24-Jan-17" may be in the year 1817, 1917, 2017, or
|
||
|
|
* some other year. SimpleDateFormat chooses a year so that the resultant
|
||
|
|
* date is on or after the two digit start date and within 100 years of the
|
||
|
|
* two digit start date.
|
||
|
|
* <P>
|
||
|
|
* By default, the two digit start date is set to 80 years before the current
|
||
|
|
* time at which a SimpleDateFormat object is created.
|
||
|
|
*/
|
||
|
|
Date getTwoDigitStartDate(ErrorCode& status) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Return a pattern string describing this date format.
|
||
|
|
*/
|
||
|
|
virtual UnicodeString& toPattern(UnicodeString& result) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Return a localized pattern string describing this date format.
|
||
|
|
* In most cases, this will return the same thing as toPattern(),
|
||
|
|
* but a locale can specify characters to use in pattern descriptions
|
||
|
|
* in place of the ones described in this class's class documentation.
|
||
|
|
* (Presumably, letters that would be more mnemonic in that locale's
|
||
|
|
* language.) This function would produce a pattern using those
|
||
|
|
* letters.
|
||
|
|
*
|
||
|
|
* @param result Receives the localized pattern.
|
||
|
|
* @param status Output param set to success/failure code on
|
||
|
|
* exit. If the pattern is invalid, this will be
|
||
|
|
* set to a failure result.
|
||
|
|
*/
|
||
|
|
virtual UnicodeString& toLocalizedPattern(UnicodeString& result,
|
||
|
|
ErrorCode& status) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Apply the given unlocalized pattern string to this date format.
|
||
|
|
* (i.e., after this call, this formatter will format dates according to
|
||
|
|
* the new pattern)
|
||
|
|
*
|
||
|
|
* @param pattern The pattern to be applied.
|
||
|
|
*/
|
||
|
|
virtual void applyPattern(const UnicodeString& pattern);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Apply the given localized pattern string to this date format.
|
||
|
|
* (see toLocalizedPattern() for more information on localized patterns.)
|
||
|
|
*
|
||
|
|
* @param pattern The localized pattern to be applied.
|
||
|
|
* @param status Output param set to success/failure code on
|
||
|
|
* exit. If the pattern is invalid, this will be
|
||
|
|
* set to a failure result.
|
||
|
|
*/
|
||
|
|
virtual void applyLocalizedPattern(const UnicodeString& pattern,
|
||
|
|
ErrorCode& status);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Gets the date/time formatting symbols (this is an object carrying
|
||
|
|
* the various strings and other symbols used in formatting: e.g., month
|
||
|
|
* names and abbreviations, time zone names, AM/PM strings, etc.)
|
||
|
|
* @return a copy of the date-time formatting data associated
|
||
|
|
* with this date-time formatter.
|
||
|
|
*/
|
||
|
|
virtual const DateFormatSymbols* getDateFormatSymbols() const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Set the date/time formatting symbols. The caller no longer owns the
|
||
|
|
* DateFormatSymbols object and should not delete it after making this call.
|
||
|
|
* @param newFormatData the given date-time formatting data.
|
||
|
|
*/
|
||
|
|
virtual void adoptDateFormatSymbols(DateFormatSymbols* newFormatSymbols);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Set the date/time formatting data.
|
||
|
|
* @param newFormatData the given date-time formatting data.
|
||
|
|
*/
|
||
|
|
virtual void setDateFormatSymbols(const DateFormatSymbols& newFormatSymbols);
|
||
|
|
|
||
|
|
|
||
|
|
public:
|
||
|
|
/**
|
||
|
|
* Resource bundle file suffix and tag names used by this class.
|
||
|
|
*/
|
||
|
|
static const UnicodeString kErasTag; // resource bundle tag for era names
|
||
|
|
static const UnicodeString kMonthNamesTag; // resource bundle tag for month names
|
||
|
|
static const UnicodeString kMonthAbbreviationsTag; // resource bundle tag for month abbreviations
|
||
|
|
static const UnicodeString kDayNamesTag; // resource bundle tag for day names
|
||
|
|
static const UnicodeString kDayAbbreviationsTag; // resource bundle tag for day abbreviations
|
||
|
|
static const UnicodeString kAmPmMarkersTag; // resource bundle tag for AM/PM strings
|
||
|
|
static const UnicodeString kDateTimePatternsTag; // resource bundle tag for default date and time patterns
|
||
|
|
|
||
|
|
static const char* kTimeZoneDataSuffix; // filename suffix for time-zone data file
|
||
|
|
static const UnicodeString kZoneStringsTag; // resource bundle tag for time zone names
|
||
|
|
static const UnicodeString kLocalPatternCharsTag; // resource bundle tag for localized pattern characters
|
||
|
|
|
||
|
|
static const UnicodeString kDefaultPattern; // date/time pattern of last resort
|
||
|
|
|
||
|
|
public:
|
||
|
|
/**
|
||
|
|
* Return the class ID for this class. This is useful only for comparing to
|
||
|
|
* a return value from getDynamicClassID(). For example:
|
||
|
|
* <pre>
|
||
|
|
* . Base* polymorphic_pointer = createPolymorphicObject();
|
||
|
|
* . if (polymorphic_pointer->getDynamicClassID() ==
|
||
|
|
* . erived::getStaticClassID()) ...
|
||
|
|
* </pre>
|
||
|
|
* @return The class ID for all objects of this class.
|
||
|
|
*/
|
||
|
|
static ClassID getStaticClassID() { return (ClassID)&fgClassID; }
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 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.
|
||
|
|
*
|
||
|
|
* @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.
|
||
|
|
*/
|
||
|
|
virtual ClassID getDynamicClassID() const { return getStaticClassID(); }
|
||
|
|
|
||
|
|
private:
|
||
|
|
static char fgClassID;
|
||
|
|
|
||
|
|
friend class DateFormat;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Gets the index for the given time zone ID to obtain the timezone strings
|
||
|
|
* for formatting. The time zone ID is just for programmatic lookup. NOT
|
||
|
|
* LOCALIZED!!!
|
||
|
|
*
|
||
|
|
* @param DateFormatSymbols a DateFormatSymbols object contianing the time zone names
|
||
|
|
* @param ID the given time zone ID.
|
||
|
|
* @return the index of the given time zone ID. Returns -1 if
|
||
|
|
* the given time zone ID can't be located in the
|
||
|
|
* DateFormatSymbols object.
|
||
|
|
* @see SimpleTimeZone
|
||
|
|
*/
|
||
|
|
int getZoneIndex(const DateFormatSymbols&, const UnicodeString& ID) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Used by the DateFormat factory methods to construct a SimpleDateFormat.
|
||
|
|
*/
|
||
|
|
SimpleDateFormat(EStyle timeStyle, EStyle dateStyle, const Locale& locale, ErrorCode& status);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Construct a SimpleDateFormat for the given locale. If no resource data
|
||
|
|
* is available, create an object of last resort, using hard-coded strings.
|
||
|
|
* This is an internal method, called by DateFormat. It should never fail.
|
||
|
|
*/
|
||
|
|
SimpleDateFormat(const Locale& locale, ErrorCode& status); // Use default pattern
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called by format() to format a single field.
|
||
|
|
*
|
||
|
|
* @param result Filled in with the result.
|
||
|
|
* @param ch The format character we encountered in the pattern.
|
||
|
|
* @param count Number of characters in the current pattern symbol (e.g.,
|
||
|
|
* "yyyy" in the pattern would result in a call to this function
|
||
|
|
* with ch equal to 'y' and count equal to 4)
|
||
|
|
* @param beginOffset Tells where the text returned by this function will go in
|
||
|
|
* the finished string. Used when this function needs to fill
|
||
|
|
* in a FieldPosition
|
||
|
|
* @param pos The FieldPosition being filled in by the format() call. If
|
||
|
|
* this function is formatting the field specfied by pos, it
|
||
|
|
* will fill in pos will the beginning and ending offsets of the
|
||
|
|
* field.
|
||
|
|
* @param status Receives a status code, which will be ZERO_ERROR if the operation
|
||
|
|
* succeeds.
|
||
|
|
* @return A reference to "result".
|
||
|
|
*/
|
||
|
|
UnicodeString& subFormat( UnicodeString& result,
|
||
|
|
UniChar ch,
|
||
|
|
int count,
|
||
|
|
int beginOffset,
|
||
|
|
FieldPosition& pos,
|
||
|
|
ErrorCode& status) const; // in case of illegal argument
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Used by subFormat() to format a numeric value. Fills in "result" with a string
|
||
|
|
* representation of "value" having a number of digits between "minDigits" and
|
||
|
|
* "maxDigits". Uses the DateFormat's NumberFormat.
|
||
|
|
* @param result Filled in with the formatted number.
|
||
|
|
* @param value Value to format.
|
||
|
|
* @param minDigits Minimum number of digits the result should have
|
||
|
|
* @param maxDigits Maximum number of digits the result should have
|
||
|
|
* @return A reference to "result".
|
||
|
|
*/
|
||
|
|
UnicodeString& zeroPaddingNumber(UnicodeString& result,
|
||
|
|
long value,
|
||
|
|
int minDigits,
|
||
|
|
int maxDigits) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called by several of the constructors to load pattern data and formatting symbols
|
||
|
|
* out of a resource bundle and initialize the locale based on it.
|
||
|
|
* @param timeStyle The time style, as passed to DateFormat::createDateInstance().
|
||
|
|
* @param dateStyle The date style, as passed to DateFormat::createTimeInstance().
|
||
|
|
* @param locale The locale to load the patterns from.
|
||
|
|
* @param status Filled in with an error code if loading the data from the
|
||
|
|
* resources fails.
|
||
|
|
*/
|
||
|
|
void construct(EStyle timeStyle, EStyle dateStyle, const Locale& locale, ErrorCode& status);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Called by construct() and the various constructors to set up the SimpleDateFormat's
|
||
|
|
* Calendar and NumberFormat objects.
|
||
|
|
* @param locale The locale for which we want a Calendar and a NumberFormat.
|
||
|
|
* @param statuc Filled in with an error code if creating either subobject fails.
|
||
|
|
*/
|
||
|
|
void initialize(const Locale& locale, ErrorCode& status);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Private code-size reduction function used by subParse.
|
||
|
|
* @param text the time text being parsed.
|
||
|
|
* @param start where to start parsing.
|
||
|
|
* @param field the date field being parsed.
|
||
|
|
* @param data the string array to parsed.
|
||
|
|
* @return the new start position if matching succeeded; a negative number
|
||
|
|
* indicating matching failure, otherwise.
|
||
|
|
*/
|
||
|
|
int matchString(const UnicodeString& text, TextOffset start, Calendar::EDateFields field,
|
||
|
|
const UnicodeString* stringArray, t_int32 stringArrayCount) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Private member function that converts the parsed date strings into
|
||
|
|
* timeFields. Returns -start (for ParsePosition) if failed.
|
||
|
|
* @param text the time text to be parsed.
|
||
|
|
* @param start where to start parsing.
|
||
|
|
* @param ch the pattern character for the date field text to be parsed.
|
||
|
|
* @param count the count of a pattern character.
|
||
|
|
* @param obeyCount if true then the count is strictly obeyed.
|
||
|
|
* @return the new start position if matching succeeded; a negative number
|
||
|
|
* indicating matching failure, otherwise.
|
||
|
|
*/
|
||
|
|
int subParse(const UnicodeString& text, ParsePosition& start, UniChar ch, int count,
|
||
|
|
t_bool obeyCount, t_bool& ambiguousYear) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Parse the given text, at the given position, as a numeric value, using
|
||
|
|
* this object's NumberFormat. Return the corresponding long value in the
|
||
|
|
* fill-in parameter 'value'. If the parse fails, this method leaves pos
|
||
|
|
* unchanged and returns FALSE; otherwise it advances pos and
|
||
|
|
* returns TRUE.
|
||
|
|
*/
|
||
|
|
t_bool subParseLong(const UnicodeString& text, ParsePosition& pos, long& value) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Translate a pattern, mapping each character in the from string to the
|
||
|
|
* corresponding character in the to string. Return an error if the original
|
||
|
|
* pattern contains an unmapped character, or if a quote is unmatched.
|
||
|
|
* Quoted (single quotes only) material is not translated.
|
||
|
|
*/
|
||
|
|
static void translatePattern(const UnicodeString& originalPattern,
|
||
|
|
UnicodeString& translatedPattern,
|
||
|
|
const UnicodeString& from,
|
||
|
|
const UnicodeString& to,
|
||
|
|
ErrorCode& status);
|
||
|
|
/**
|
||
|
|
* Given a zone ID, try to locate it in our time zone array. Return the
|
||
|
|
* index (row index) of the found time zone, or -1 if we can't find it.
|
||
|
|
*/
|
||
|
|
int getZoneIndex(const UnicodeString& ID) const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Sets the starting date of the 100-year window that dates with 2-digit years
|
||
|
|
* are considered to fall within.
|
||
|
|
*/
|
||
|
|
void parseAmbiguousDatesAsAfter(Date startDate);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the beginning date of the 100-year window that dates with 2-digit years
|
||
|
|
* are considered to fall within.
|
||
|
|
*/
|
||
|
|
Date internalGetDefaultCenturyStart() const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Returns the first year of the 100-year window that dates with 2-digit years
|
||
|
|
* are considered to fall within.
|
||
|
|
*/
|
||
|
|
int internalGetDefaultCenturyStartYear() const;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Initializes the 100-year window that dates with 2-digit years are considered
|
||
|
|
* to fall within so that its start date is 80 years before the current time.
|
||
|
|
*/
|
||
|
|
static void initializeSystemDefaultCentury();
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Last-resort string to use for "GMT" when constructing time zone strings.
|
||
|
|
*/
|
||
|
|
static const UnicodeString GMT;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Used to map pattern characters to Calendar field identifiers.
|
||
|
|
*/
|
||
|
|
static const Calendar::EDateFields PATTERN_INDEX_TO_FIELD[];
|
||
|
|
|
||
|
|
/**
|
||
|
|
* The formatting pattern for this formatter.
|
||
|
|
*/
|
||
|
|
UnicodeString fPattern;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* A pointer to an object containing the strings to use in formatting (e.g.,
|
||
|
|
* month and day names, AM and PM strings, time zone names, etc.)
|
||
|
|
*/
|
||
|
|
DateFormatSymbols* fSymbols; // Owned
|
||
|
|
|
||
|
|
/**
|
||
|
|
* If dates have ambiguous years, we map them into the century starting
|
||
|
|
* at defaultCenturyStart, which may be any date. If defaultCenturyStart is
|
||
|
|
* set to SYSTEM_DEFAULT_CENTURY, which it is by default, then the system
|
||
|
|
* values are used. The instance values defaultCenturyStart and
|
||
|
|
* defaultCenturyStartYear are only used if explicitly set by the user
|
||
|
|
* through the API method parseAmbiguousDatesAsAfter().
|
||
|
|
*/
|
||
|
|
Date defaultCenturyStart;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* See documentation for defaultCenturyStart.
|
||
|
|
*/
|
||
|
|
/*transient*/ int defaultCenturyStartYear;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* The system maintains a static default century start date. This is initialized
|
||
|
|
* the first time it is used. Before then, it is set to SYSTEM_DEFAULT_CENTURY to
|
||
|
|
* indicate an uninitialized state. Once the system default century date and year
|
||
|
|
* are set, they do not change.
|
||
|
|
*/
|
||
|
|
static Date systemDefaultCenturyStart;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* See documentation for systemDefaultCenturyStart.
|
||
|
|
*/
|
||
|
|
static int systemDefaultCenturyStartYear;
|
||
|
|
|
||
|
|
public:
|
||
|
|
/**
|
||
|
|
* If a start date is set to this value, that indicates that the system default
|
||
|
|
* start is in effect for this instance.
|
||
|
|
*/
|
||
|
|
static const Date SYSTEM_DEFAULT_CENTURY;
|
||
|
|
};
|
||
|
|
#ifdef NLS_MAC
|
||
|
|
#pragma export off
|
||
|
|
#endif
|
||
|
|
|
||
|
|
inline Date
|
||
|
|
SimpleDateFormat::getTwoDigitStartDate(ErrorCode& status) const
|
||
|
|
{
|
||
|
|
return defaultCenturyStart;
|
||
|
|
}
|
||
|
|
|
||
|
|
#endif // _SMPDTFMT
|
||
|
|
//eof
|