Skip to content

Most visited

Recently visited

navigation
Added in API level 1

DateFormatSymbols

public class DateFormatSymbols
extends Object implements Serializable, Cloneable

java.lang.Object
   ↳ java.text.DateFormatSymbols


Encapsulates localized date-time formatting data, such as the names of the months, the names of the days of the week, and the time zone data. DateFormat and SimpleDateFormat both use DateFormatSymbols to encapsulate this information.

Typically you shouldn't use DateFormatSymbols directly. Rather, you are encouraged to create a date/time formatter with the DateFormat class's factory methods: getTimeInstance, getDateInstance, or getDateTimeInstance. These methods automatically create a DateFormatSymbols for the formatter so that you don't have to. After the formatter is created, you may modify its format pattern using the setPattern method. For more information about creating formatters using DateFormat's factory methods, see DateFormat.

Direct use of DateFormatSymbols is likely to be less efficient because the implementation cannot make assumptions about user-supplied/user-modifiable data to the same extent that it can with its own built-in data.

See also:

Summary

Public constructors

DateFormatSymbols()

Constructs a new DateFormatSymbols instance containing the symbols for the user's default locale.

DateFormatSymbols(Locale locale)

Constructs a new DateFormatSymbols instance containing the symbols for the specified locale.

Public methods

Object clone()

Creates and returns a copy of this Object.

boolean equals(Object object)

Compares this object with the specified object and indicates if they are equal.

String[] getAmPmStrings()

Returns the array of strings which represent AM and PM.

static Locale[] getAvailableLocales()

Returns an array of locales for which custom DateFormatSymbols instances are available.

String[] getEras()

Returns the array of strings which represent BC and AD.

final static DateFormatSymbols getInstance()

Returns a new DateFormatSymbols instance for the user's default locale.

final static DateFormatSymbols getInstance(Locale locale)

Returns a new DateFormatSymbols for the given locale.

String getLocalPatternChars()

Returns the pattern characters used by SimpleDateFormat to specify date and time fields.

String[] getMonths()

Returns the array of strings containing the full names of the months.

String[] getShortMonths()

Returns the array of strings containing the abbreviated names of the months.

String[] getShortWeekdays()

Returns the array of strings containing the abbreviated names of the days of the week.

String[] getWeekdays()

Returns the array of strings containing the full names of the days of the week.

String[][] getZoneStrings()

Returns the two-dimensional array of strings containing localized names for time zones.

int hashCode()

Returns an integer hash code for this object.

void setAmPmStrings(String[] data)

Sets the array of strings which represent AM and PM.

void setEras(String[] data)

Sets the array of Strings which represent BC and AD.

void setLocalPatternChars(String data)

Sets the pattern characters used by SimpleDateFormat to specify date and time fields.

void setMonths(String[] data)

Sets the array of strings containing the full names of the months.

void setShortMonths(String[] data)

Sets the array of strings containing the abbreviated names of the months.

void setShortWeekdays(String[] data)

Sets the array of strings containing the abbreviated names of the days of the week.

void setWeekdays(String[] data)

Sets the array of strings containing the full names of the days of the week.

void setZoneStrings(String[][] zoneStrings)

Sets the two-dimensional array of strings containing localized names for time zones.

String toString()

Returns a string containing a concise, human-readable description of this object.

Inherited methods

From class java.lang.Object

Public constructors

DateFormatSymbols

Added in API level 1
DateFormatSymbols ()

Constructs a new DateFormatSymbols instance containing the symbols for the user's default locale. See "Be wary of the default locale".

DateFormatSymbols

Added in API level 1
DateFormatSymbols (Locale locale)

Constructs a new DateFormatSymbols instance containing the symbols for the specified locale.

Parameters
locale Locale: the locale.

Public methods

clone

Added in API level 1
Object clone ()

Creates and returns a copy of this Object. The default implementation returns a so-called "shallow" copy: It creates a new instance of the same class and then copies the field values (including object references) from this instance to the new instance. A "deep" copy, in contrast, would also recursively clone nested objects. A subclass that needs to implement this kind of cloning should call super.clone() to create the new instance and then create deep copies of the nested, mutable objects.

Returns
Object a copy of this object.

equals

Added in API level 1
boolean equals (Object object)

Compares this object with the specified object and indicates if they are equal.

Parameters
object Object: the object to compare with this object.
Returns
boolean true if object is an instance of DateFormatSymbols and has the same symbols as this object, false otherwise.

See also:

getAmPmStrings

Added in API level 1
String[] getAmPmStrings ()

Returns the array of strings which represent AM and PM. Use the Calendar constants Calendar.AM and Calendar.PM as indices for the array.

Returns
String[] an array of strings.

getAvailableLocales

Added in API level 9
Locale[] getAvailableLocales ()

Returns an array of locales for which custom DateFormatSymbols instances are available.

Note that Android does not support user-supplied locale service providers.

Returns
Locale[]

getEras

Added in API level 1
String[] getEras ()

Returns the array of strings which represent BC and AD. Use the Calendar constants GregorianCalendar.BC and GregorianCalendar.AD as indices for the array.

Returns
String[] an array of strings.

getInstance

Added in API level 9
DateFormatSymbols getInstance ()

Returns a new DateFormatSymbols instance for the user's default locale. See "Be wary of the default locale".

Returns
DateFormatSymbols an instance of DateFormatSymbols

getInstance

Added in API level 9
DateFormatSymbols getInstance (Locale locale)

Returns a new DateFormatSymbols for the given locale.

Parameters
locale Locale: the locale
Returns
DateFormatSymbols an instance of DateFormatSymbols
Throws
NullPointerException if locale == null

getLocalPatternChars

Added in API level 1
String getLocalPatternChars ()

Returns the pattern characters used by SimpleDateFormat to specify date and time fields.

Returns
String

getMonths

Added in API level 1
String[] getMonths ()

Returns the array of strings containing the full names of the months. Use the Calendar constants Calendar.JANUARY etc. as indices for the array.

Returns
String[] an array of strings.

getShortMonths

Added in API level 1
String[] getShortMonths ()

Returns the array of strings containing the abbreviated names of the months. Use the Calendar constants Calendar.JANUARY etc. as indices for the array.

Returns
String[] an array of strings.

getShortWeekdays

Added in API level 1
String[] getShortWeekdays ()

Returns the array of strings containing the abbreviated names of the days of the week. Use the Calendar constants Calendar.SUNDAY etc. as indices for the array.

Returns
String[] an array of strings.

getWeekdays

Added in API level 1
String[] getWeekdays ()

Returns the array of strings containing the full names of the days of the week. Use the Calendar constants Calendar.SUNDAY etc. as indices for the array.

Returns
String[] an array of strings.

getZoneStrings

Added in API level 1
String[][] getZoneStrings ()

Returns the two-dimensional array of strings containing localized names for time zones. Each row is an array of five strings:

  • The time zone ID, for example "America/Los_Angeles". This is not localized, and is used as a key into the table.
  • The long display name, for example "Pacific Standard Time".
  • The short display name, for example "PST".
  • The long display name for DST, for example "Pacific Daylight Time". This is the non-DST long name for zones that have never had DST, for example "Central Standard Time" for "Canada/Saskatchewan".
  • The short display name for DST, for example "PDT". This is the non-DST short name for zones that have never had DST, for example "CST" for "Canada/Saskatchewan".

Returns
String[][]

hashCode

Added in API level 1
int hashCode ()

Returns an integer hash code for this object. By contract, any two objects for which equals(Object) returns true must return the same hash code value. This means that subclasses of Object usually override both methods or neither method.

Note that hash values must not change over time unless information used in equals comparisons also changes.

See Writing a correct hashCode method if you intend implementing your own hashCode method.

Returns
int this object's hash code.

setAmPmStrings

Added in API level 1
void setAmPmStrings (String[] data)

Sets the array of strings which represent AM and PM. Use the Calendar constants Calendar.AM and Calendar.PM as indices for the array.

Parameters
data String: the array of strings for AM and PM.

setEras

Added in API level 1
void setEras (String[] data)

Sets the array of Strings which represent BC and AD. Use the Calendar constants GregorianCalendar.BC and GregorianCalendar.AD as indices for the array.

Parameters
data String: the array of strings for BC and AD.

setLocalPatternChars

Added in API level 1
void setLocalPatternChars (String data)

Sets the pattern characters used by SimpleDateFormat to specify date and time fields.

Parameters
data String: the string containing the pattern characters.
Throws
NullPointerException if data is null

setMonths

Added in API level 1
void setMonths (String[] data)

Sets the array of strings containing the full names of the months. Use the Calendar constants Calendar.JANUARY etc. as indices for the array.

Parameters
data String: the array of strings.

setShortMonths

Added in API level 1
void setShortMonths (String[] data)

Sets the array of strings containing the abbreviated names of the months. Use the Calendar constants Calendar.JANUARY etc. as indices for the array.

Parameters
data String: the array of strings.

setShortWeekdays

Added in API level 1
void setShortWeekdays (String[] data)

Sets the array of strings containing the abbreviated names of the days of the week. Use the Calendar constants Calendar.SUNDAY etc. as indices for the array.

Parameters
data String: the array of strings.

setWeekdays

Added in API level 1
void setWeekdays (String[] data)

Sets the array of strings containing the full names of the days of the week. Use the Calendar constants Calendar.SUNDAY etc. as indices for the array.

Parameters
data String: the array of strings.

setZoneStrings

Added in API level 1
void setZoneStrings (String[][] zoneStrings)

Sets the two-dimensional array of strings containing localized names for time zones. See getZoneStrings() for details.

Parameters
zoneStrings String
Throws
IllegalArgumentException if any row has fewer than 5 elements.
NullPointerException if zoneStrings == null.

toString

Added in API level 1
String toString ()

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

   getClass().getName() + '@' + Integer.toHexString(hashCode())

See Writing a useful toString method if you intend implementing your own toString method.

Returns
String a printable representation of this object.
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.