net.java.truevfs.comp.zip

Enum DateTimeConverter

java.lang.Object

java.lang.Enum<DateTimeConverter>

net.java.truevfs.comp.zip.DateTimeConverter

All Implemented Interfaces:

Serializable, Comparable<DateTimeConverter>

@ThreadSafe
public enum DateTimeConverter
extends Enum<DateTimeConverter>

Converts Java time values to DOS date/time values and vice versa. This class has been introduced in order to enhance interoperability between different flavours of the ZIP file format specification when converting date/time from the serialized DOS format in a ZIP file to the local system time, which is represented by a UNIX-like encoding by the Java API.

Author:

Christian Schlichtherle

Enum Constant Summary

Enum Constants

Enum Constant and Description
JAR This instance applies the schedule for Daylight Saving Time (DST), i.e.
ZIP This instance ignores the schedule for Daylight Saving Time (DST), i.e.

Method Summary

Modifier and Type	Method and Description
static DateTimeConverter	valueOf(String name) Returns the enum constant of this type with the specified name.
static DateTimeConverter[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

JAR

public static final DateTimeConverter JAR

This instance applies the schedule for Daylight Saving Time (DST), i.e. all time conversions will apply DST where appropriate to a particular date.

This behaviour provides best interoperability with:

• Java SE: jar utility and java.util.zip package
• Info-ZIP: unzip

ZIP

public static final DateTimeConverter ZIP

This instance ignores the schedule for Daylight Saving Time (DST), i.e. all time conversions will use the same raw offset and current DST savings, regardless of whether DST savings should be applied to a particular date or not.

This behavior provides best interoperability with:

• Windows Vista Explorer (as of June 30^th, 2009)
• WinZip 12.0
• 7-Zip 4.65

Method Detail

valueOf

public static DateTimeConverter valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

values

public static DateTimeConverter[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (DateTimeConverter c : DateTimeConverter.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared