com.sap.netweaver.bc.serialize.util

Class DateTimeFormat

java.lang.Object

com.sap.netweaver.bc.serialize.util.DateTimeFormat

public final class DateTimeFormat
extends Object

Integrates the date and time formats defined in the ICE specification. This format is the Extended Format of calendar date and time of day as described in [ISO8601] section 5.4.1 clause (a). Actually, it's based on a selected profile of options from ISO8601:1988 (with Technical Corrigendum 1 applied).

When a date and time need to be specified in a single string, the ICE Date and Time Format is: CCYY-MM-DDThh:mm:ss,s where "T" (upper case letter T) is a literal character ([ISO8601] designator).

Copyright 2004 SAP AG

Constructor Summary

Constructors

Constructor and Description
DateTimeFormat()

Method Summary

Modifier and Type	Method and Description
static String	format(Date date) Formats the specified java.util.Date object as a string adhering to the ICE Date and Time Format.
static Date	parse(String str) Parses the specified string (which must be in ICE Date and TIME Format) and returns it as a java.util.Date object.

Methods inherited from class java.lang.Object

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

Constructor Detail

DateTimeFormat

public DateTimeFormat()

Method Detail

format

public static String format(Date date)

Formats the specified java.util.Date object as a string adhering to the ICE Date and Time Format.

Note, that the date will be converted to UTC (if not already in UTC) prior formatting it to the ICE Date and Time Format. For example, the date July 1st 2002 01:00:00 AM (GMT+2) will be converted to June 30th 2002 11:00:00 PM (UTC) and returned as "2002-06-30T23:00:00".

Parameters:

date - the date to be formatted

Returns:

a string representation in ICE Date and Time Format

parse

public static Date parse(String str)
                  throws ParseException

Parses the specified string (which must be in ICE Date and TIME Format) and returns it as a java.util.Date object.

Note, that the parsed date will be interpreted as UTC and converted into the local time. For example, on a machine with local timezone GMT+2, the string "2002-06-30T23:00:00" will be interpreted as June 30th 2002 11:00:00 PM (UTC) and converted to July 1st 2002 01:00:00 AM (GMT+2).

To conclude, this method is the exact inverse of the method format.

Parameters:

str - the string to be parsed

Returns:

a java.util.Date object containing the parsed date

Throws:

ParseException - when specifying an illegally formatted string