Previous | Next | Trail Map | Internationalization | Contents

Date and Time Formatting

Date objects represent dates and times. You cannot display or print a Date object without first converting it to a String which is in the proper format. Just what is the "proper" format? First, the format should conform to the conventions of the end-user's Locale. For example, Germans will recognize 9.4.98 as a valid date, but Americans will expect the same date to appear as 4/9/98. Second, the format should include the necessary information. For instance, a program that measures network performance may report on elapsed milliseconds. An online appointment calendar probably won't display milliseconds, but it will show us the days of the week.

This lesson explains how to format dates and times in different ways, and in a locale-sensitive manner. If you follow the techniques described in this lesson, your programs will display dates and times in the appropriate Locale, but your source code will remain independent of any specific Locale.

Using Predefined Formats

The DateFormat class provides predefined formatting styles that are locale-specific and easy to use.

Formatting with Patterns

With the SimpleDateFormat class, you can create customized, locale-specific formats.

Changing Date Format Symbols

Using the DateFormatSymbols class, you can change the symbols that represent the names of months, days of the week, and other formatting elements.


Previous | Next | Trail Map | Internationalization | Contents