Skip navigation links

oracle.adf.view.rich.util
Class DateTimeUtils

java.lang.Object
oracle.adf.view.rich.util.DateTimeUtils

public final class DateTimeUtils

extends Object

Provides utilities for processing Date objects. Contains a list of commonly used timezones supplied by globalization, and methods to retrieve the translated timezone names for a timezone.

Method Summary

static TimeZone	getActualTimeZone(TimeZone tz) The entire time zone repository contains 500+ time zones.
static List<javax.faces.model.SelectItem>	getCommonTimeZoneSelectItems() Returns a list of commonly used timezones, sorted by the timezone's raw offset.
static List<javax.faces.model.SelectItem>	getCommonTimeZoneSelectItems(Locale loc, TimeZone addTimeZone) Returns a list of commonly used timezones, sorted by the timezone's raw offset.
static List<javax.faces.model.SelectItem>	getCommonTimeZoneSelectItems(String timeZoneId) Returns a list of commonly used timezones, sorted by the timezone's raw offset.
static String	getTimeZoneDisplayName(Locale loc, String timezoneID)
static List<javax.faces.model.SelectItem>	getTimeZoneSelectItems(Locale translationLocale, TimeZone addTimeZone, List<String> timezones) Returns a list of SelectItems for the timezones passed in.
static List<javax.faces.model.SelectItem>	getTimeZoneSelectItems(String addTimeZoneId, List<String> timezones) Returns a list of SelectItems for the timezones passed in.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getCommonTimeZoneSelectItems

public static List<javax.faces.model.SelectItem> getCommonTimeZoneSelectItems()

Returns a list of commonly used timezones, sorted by the timezone's raw offset. The SelectItems have id=timezoneId, value= translated timezone name using the view root locale.

getCommonTimeZoneSelectItems

public static List<javax.faces.model.SelectItem> getCommonTimeZoneSelectItems(String timeZoneId)

Returns a list of commonly used timezones, sorted by the timezone's raw offset. The SelectItems have id=timezoneId, value= translated timezone name, using the view root locale.

Parameters:

timeZoneId - If the specified timezone with this id is not present in the common list, it will be inserted in raw offset order after the common timezones with the same raw offset.

getCommonTimeZoneSelectItems

public static List<javax.faces.model.SelectItem> getCommonTimeZoneSelectItems(Locale loc,
                                                                              TimeZone addTimeZone)

Returns a list of commonly used timezones, sorted by the timezone's raw offset. The SelectItems have id=timezoneId, value= translated timezone name

Parameters:

loc - Determines the locale/translations for the timezone names

addTimeZone - If the specified timezone is not present in the common list, it will be inserted in raw offset order.

getTimeZoneSelectItems

public static List<javax.faces.model.SelectItem> getTimeZoneSelectItems(String addTimeZoneId,
                                                                        List<String> timezones)

Returns a list of SelectItems for the timezones passed in. The SelectItems have id=timezoneId, value = translated timezone name using the view root locale.

Parameters:

addTimeZoneId - If the specified timezone is not present in the timezones list, it will be inserted in raw offset order after existing timezones with the same raw offset.

timezones - A List of TimeZone ids, sorted by increasing raw offset order

Returns:

SelectItems for timezones

getTimeZoneSelectItems

public static List<javax.faces.model.SelectItem> getTimeZoneSelectItems(Locale translationLocale,
                                                                        TimeZone addTimeZone,
                                                                        List<String> timezones)

Returns a list of SelectItems for the timezones passed in. The SelectItems have id=timezoneId, value = translated timezone name

Parameters:

addTimeZone - If the specified timezone is not present in the timezones list, it will be inserted in raw offset order after existing timezones with the same raw offset.

timezones - A List of TimeZone ids, sorted by increasing raw offset order

Returns:

SelectItems for timezones

getActualTimeZone

public static TimeZone getActualTimeZone(TimeZone tz)

The entire time zone repository contains 500+ time zones. Around half of them are "Aliases". For example, "US/Pacific" is an alias of "America/Los_Angeles". Internally, aliases shares time zone definitions with the corresponding actual timezone. In theory, by referring to time zone definitions, we can tell if a time zone id is an actual timezone or an alias. However, JRE java.util.TimeZone implementation does not expose this information thru its API. Hence, this helper method to determine if a timezone has an alias. Checks if a timezone is an alias, and returns its actual timezone instead. The Common timezone map only contains actual timezones.

Parameters:

tz - Timezone to check

Returns:

Timezone alias

getTimeZoneDisplayName

public static String getTimeZoneDisplayName(Locale loc,
                                            String timezoneID)

Parameters:

loc - Locale for display name of requested timezone

timezoneID - Requested TimeZone, should be one of Java's 500+ Timezones

Returns:

the Display Name (translated) of a timezone The timezoneID does not need to be a "common" timezoneID, i.e. one of the 139 timezones returned by getTimeZoneDisplayItemes(). Both common and full list of timezone displaynames are maintained by globalization.

Skip navigation links