public class DateFormatUtils
extends java.lang.Object
Date and time formatting utilities and constants.
Formatting is performed using the thread-safe
FastDateFormat
class.
Note that the JDK has a bug wherein calling Calendar.get(int) will override any previously called Calendar.clear() calls. See LANG-755.
Modifier and Type | Field and Description |
---|---|
static FastDateFormat |
ISO_8601_EXTENDED_DATE_FORMAT
ISO 8601 formatter for date without time zone.
|
static FastDateFormat |
ISO_8601_EXTENDED_DATETIME_FORMAT
ISO 8601 formatter for date-time without time zone.
|
static FastDateFormat |
ISO_8601_EXTENDED_DATETIME_TIME_ZONE_FORMAT
ISO 8601 formatter for date-time with time zone.
|
static FastDateFormat |
ISO_8601_EXTENDED_TIME_FORMAT
ISO 8601 formatter for time without time zone.
|
static FastDateFormat |
ISO_8601_EXTENDED_TIME_TIME_ZONE_FORMAT
ISO 8601 formatter for time with time zone.
|
static FastDateFormat |
ISO_DATE_FORMAT
Deprecated.
- as of 4.0, ISO_DATE_FORMAT will be replaced by ISO_8601_EXTENDED_DATE_FORMAT.
|
static FastDateFormat |
ISO_DATE_TIME_ZONE_FORMAT
Deprecated.
- as of 4.0, ISO_DATE_TIME_ZONE_FORMAT will be removed.
|
static FastDateFormat |
ISO_DATETIME_FORMAT
Deprecated.
- as of 4.0, ISO_DATETIME_FORMAT will be replaced by ISO_8601_EXTENDED_DATETIME_FORMAT.
|
static FastDateFormat |
ISO_DATETIME_TIME_ZONE_FORMAT
Deprecated.
- as of 4.0, ISO_DATETIME_TIME_ZONE_FORMAT will be replaced by ISO_8601_EXTENDED_DATETIME_TIME_ZONE_FORMAT.
|
static FastDateFormat |
ISO_TIME_FORMAT
Deprecated.
- as of 4.0, ISO_TIME_FORMAT will be removed.
|
static FastDateFormat |
ISO_TIME_NO_T_FORMAT
Deprecated.
- as of 4.0, ISO_TIME_NO_T_FORMAT will be replaced by ISO_8601_EXTENDED_TIME_FORMAT.
|
static FastDateFormat |
ISO_TIME_NO_T_TIME_ZONE_FORMAT
Deprecated.
- as of 4.0, ISO_TIME_NO_T_TIME_ZONE_FORMAT will be replaced by ISO_8601_EXTENDED_TIME_TIME_ZONE_FORMAT.
|
static FastDateFormat |
ISO_TIME_TIME_ZONE_FORMAT
Deprecated.
- as of 4.0, ISO_TIME_TIME_ZONE_FORMAT will be removed.
|
static FastDateFormat |
SMTP_DATETIME_FORMAT
SMTP (and probably other) date headers.
|
Constructor and Description |
---|
DateFormatUtils()
DateFormatUtils instances should NOT be constructed in standard programming.
|
Modifier and Type | Method and Description |
---|---|
static java.lang.String |
format(java.util.Calendar calendar,
java.lang.String pattern)
Formats a calendar into a specific pattern.
|
static java.lang.String |
format(java.util.Calendar calendar,
java.lang.String pattern,
java.util.Locale locale)
Formats a calendar into a specific pattern in a locale.
|
static java.lang.String |
format(java.util.Calendar calendar,
java.lang.String pattern,
java.util.TimeZone timeZone)
Formats a calendar into a specific pattern in a time zone.
|
static java.lang.String |
format(java.util.Calendar calendar,
java.lang.String pattern,
java.util.TimeZone timeZone,
java.util.Locale locale)
Formats a calendar into a specific pattern in a time zone and locale.
|
static java.lang.String |
format(java.util.Date date,
java.lang.String pattern)
Formats a date/time into a specific pattern.
|
static java.lang.String |
format(java.util.Date date,
java.lang.String pattern,
java.util.Locale locale)
Formats a date/time into a specific pattern in a locale.
|
static java.lang.String |
format(java.util.Date date,
java.lang.String pattern,
java.util.TimeZone timeZone)
Formats a date/time into a specific pattern in a time zone.
|
static java.lang.String |
format(java.util.Date date,
java.lang.String pattern,
java.util.TimeZone timeZone,
java.util.Locale locale)
Formats a date/time into a specific pattern in a time zone and locale.
|
static java.lang.String |
format(long millis,
java.lang.String pattern)
Formats a date/time into a specific pattern.
|
static java.lang.String |
format(long millis,
java.lang.String pattern,
java.util.Locale locale)
Formats a date/time into a specific pattern in a locale.
|
static java.lang.String |
format(long millis,
java.lang.String pattern,
java.util.TimeZone timeZone)
Formats a date/time into a specific pattern in a time zone.
|
static java.lang.String |
format(long millis,
java.lang.String pattern,
java.util.TimeZone timeZone,
java.util.Locale locale)
Formats a date/time into a specific pattern in a time zone and locale.
|
static java.lang.String |
formatUTC(java.util.Date date,
java.lang.String pattern)
Formats a date/time into a specific pattern using the UTC time zone.
|
static java.lang.String |
formatUTC(java.util.Date date,
java.lang.String pattern,
java.util.Locale locale)
Formats a date/time into a specific pattern using the UTC time zone.
|
static java.lang.String |
formatUTC(long millis,
java.lang.String pattern)
Formats a date/time into a specific pattern using the UTC time zone.
|
static java.lang.String |
formatUTC(long millis,
java.lang.String pattern,
java.util.Locale locale)
Formats a date/time into a specific pattern using the UTC time zone.
|
public static final FastDateFormat ISO_8601_EXTENDED_DATETIME_FORMAT
The format used is yyyy-MM-dd'T'HH:mm:ss
. This format uses the
default TimeZone in effect at the time of loading DateFormatUtils class.
@Deprecated public static final FastDateFormat ISO_DATETIME_FORMAT
public static final FastDateFormat ISO_8601_EXTENDED_DATETIME_TIME_ZONE_FORMAT
The format used is yyyy-MM-dd'T'HH:mm:ssZZ
. This format uses the
default TimeZone in effect at the time of loading DateFormatUtils class.
@Deprecated public static final FastDateFormat ISO_DATETIME_TIME_ZONE_FORMAT
public static final FastDateFormat ISO_8601_EXTENDED_DATE_FORMAT
The format used is yyyy-MM-dd
. This format uses the
default TimeZone in effect at the time of loading DateFormatUtils class.
@Deprecated public static final FastDateFormat ISO_DATE_FORMAT
@Deprecated public static final FastDateFormat ISO_DATE_TIME_ZONE_FORMAT
The format used is yyyy-MM-ddZZ
. This pattern does not comply
with the formal ISO 8601 specification as the standard does not allow
a time zone without a time. This format uses the default TimeZone in
effect at the time of loading DateFormatUtils class.
@Deprecated public static final FastDateFormat ISO_TIME_FORMAT
The format used is 'T'HH:mm:ss
. This format uses the default
TimeZone in effect at the time of loading DateFormatUtils class.
@Deprecated public static final FastDateFormat ISO_TIME_TIME_ZONE_FORMAT
The format used is 'T'HH:mm:ssZZ
. This format uses the default
TimeZone in effect at the time of loading DateFormatUtils class.
public static final FastDateFormat ISO_8601_EXTENDED_TIME_FORMAT
The format used is HH:mm:ss
. This format uses the default
TimeZone in effect at the time of loading DateFormatUtils class.
@Deprecated public static final FastDateFormat ISO_TIME_NO_T_FORMAT
public static final FastDateFormat ISO_8601_EXTENDED_TIME_TIME_ZONE_FORMAT
The format used is HH:mm:ssZZ
. This format uses the default
TimeZone in effect at the time of loading DateFormatUtils class.
@Deprecated public static final FastDateFormat ISO_TIME_NO_T_TIME_ZONE_FORMAT
public static final FastDateFormat SMTP_DATETIME_FORMAT
The format used is EEE, dd MMM yyyy HH:mm:ss Z
in US locale.
This format uses the default TimeZone in effect at the time of loading
DateFormatUtils class.
public DateFormatUtils()
DateFormatUtils instances should NOT be constructed in standard programming.
This constructor is public to permit tools that require a JavaBean instance to operate.
public static java.lang.String formatUTC(long millis, java.lang.String pattern)
Formats a date/time into a specific pattern using the UTC time zone.
millis
- the date to format expressed in millisecondspattern
- the pattern to use to format the date, not nullpublic static java.lang.String formatUTC(java.util.Date date, java.lang.String pattern)
Formats a date/time into a specific pattern using the UTC time zone.
date
- the date to format, not nullpattern
- the pattern to use to format the date, not nullpublic static java.lang.String formatUTC(long millis, java.lang.String pattern, java.util.Locale locale)
Formats a date/time into a specific pattern using the UTC time zone.
millis
- the date to format expressed in millisecondspattern
- the pattern to use to format the date, not nulllocale
- the locale to use, may be null
public static java.lang.String formatUTC(java.util.Date date, java.lang.String pattern, java.util.Locale locale)
Formats a date/time into a specific pattern using the UTC time zone.
date
- the date to format, not nullpattern
- the pattern to use to format the date, not nulllocale
- the locale to use, may be null
public static java.lang.String format(long millis, java.lang.String pattern)
Formats a date/time into a specific pattern.
millis
- the date to format expressed in millisecondspattern
- the pattern to use to format the date, not nullpublic static java.lang.String format(java.util.Date date, java.lang.String pattern)
Formats a date/time into a specific pattern.
date
- the date to format, not nullpattern
- the pattern to use to format the date, not nullpublic static java.lang.String format(java.util.Calendar calendar, java.lang.String pattern)
Formats a calendar into a specific pattern.
calendar
- the calendar to format, not nullpattern
- the pattern to use to format the calendar, not nullFastDateFormat.format(Calendar)
public static java.lang.String format(long millis, java.lang.String pattern, java.util.TimeZone timeZone)
Formats a date/time into a specific pattern in a time zone.
millis
- the time expressed in millisecondspattern
- the pattern to use to format the date, not nulltimeZone
- the time zone to use, may be null
public static java.lang.String format(java.util.Date date, java.lang.String pattern, java.util.TimeZone timeZone)
Formats a date/time into a specific pattern in a time zone.
date
- the date to format, not nullpattern
- the pattern to use to format the date, not nulltimeZone
- the time zone to use, may be null
public static java.lang.String format(java.util.Calendar calendar, java.lang.String pattern, java.util.TimeZone timeZone)
Formats a calendar into a specific pattern in a time zone.
calendar
- the calendar to format, not nullpattern
- the pattern to use to format the calendar, not nulltimeZone
- the time zone to use, may be null
FastDateFormat.format(Calendar)
public static java.lang.String format(long millis, java.lang.String pattern, java.util.Locale locale)
Formats a date/time into a specific pattern in a locale.
millis
- the date to format expressed in millisecondspattern
- the pattern to use to format the date, not nulllocale
- the locale to use, may be null
public static java.lang.String format(java.util.Date date, java.lang.String pattern, java.util.Locale locale)
Formats a date/time into a specific pattern in a locale.
date
- the date to format, not nullpattern
- the pattern to use to format the date, not nulllocale
- the locale to use, may be null
public static java.lang.String format(java.util.Calendar calendar, java.lang.String pattern, java.util.Locale locale)
Formats a calendar into a specific pattern in a locale.
calendar
- the calendar to format, not nullpattern
- the pattern to use to format the calendar, not nulllocale
- the locale to use, may be null
FastDateFormat.format(Calendar)
public static java.lang.String format(long millis, java.lang.String pattern, java.util.TimeZone timeZone, java.util.Locale locale)
Formats a date/time into a specific pattern in a time zone and locale.
millis
- the date to format expressed in millisecondspattern
- the pattern to use to format the date, not nulltimeZone
- the time zone to use, may be null
locale
- the locale to use, may be null
public static java.lang.String format(java.util.Date date, java.lang.String pattern, java.util.TimeZone timeZone, java.util.Locale locale)
Formats a date/time into a specific pattern in a time zone and locale.
date
- the date to format, not nullpattern
- the pattern to use to format the date, not null, not nulltimeZone
- the time zone to use, may be null
locale
- the locale to use, may be null
public static java.lang.String format(java.util.Calendar calendar, java.lang.String pattern, java.util.TimeZone timeZone, java.util.Locale locale)
Formats a calendar into a specific pattern in a time zone and locale.
calendar
- the calendar to format, not nullpattern
- the pattern to use to format the calendar, not nulltimeZone
- the time zone to use, may be null
locale
- the locale to use, may be null
FastDateFormat.format(Calendar)
Copyright © 2010 - 2020 Adobe. All Rights Reserved