```
public class KmgDateTimeConverter
extends Object
```
Collection of methods for the conversion between a double value containing decimal seconds since 01-Jan-1970 00:00:00 UTC and a date time String. A negative double value represents a date time before 1-Jan-1970.

Field Summary

Fields
Modifier and Type Field Description

static double INVALID
Value returned for unparseable date time String.

Constructor Summary

Constructors
Constructor	Description
`KmgDateTimeConverter()`	Creates a `KmgDateTimeConverter` instance.
`KmgDateTimeConverter(String defaultDateTimeFormatPattern)`	Abbreviation of `@KmgDateTimeConverter( @SimpleDateFormat( defaultDateTimeFormatPattern ) )`
`KmgDateTimeConverter(DateFormat df)`	Creates a `KmgDateTimeConverter` instance using `df`.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`static double`	`forDate(Date d)`	Returns decimal seconds since 01-Jan-1970 00:00:00 UTC for `d`.
`String`	`format(double z)`	Formats `z` as a date time string using the internally stored `DateFormat` instance.
`static String`	`format(double z, DateFormat df)`	Formats `z` as a date time string using `df`.
`static String`	`formatDate(double z)`	Formats `z` as a date string ( e.g. `dd.MM.yy` using `DateFormat.getDateInstance( DateFormat.SHORT )`).
`static String`	`formatDateTime(double z)`	Formats `z` as a date time string (e.g. `dd.MM.yyyy HH:mm:ss z` using `getDateTimeInstance( DateFormat.MEDIUM, DateFormat.LONG )`).
`static String`	`formatDateTime(double z, double dz)`	Formats `z` as a date time string with precision `dz` in seconds.
`static String`	`formatDateTime(double z, DateFormat df)`	Formats `z` as a date time string using `df`.
`static String`	`formatTime(double z)`	Formats `z` as a time string ( e.g. `HH:mm:ss` using `DateFormat.getTimeInstance( DateFormat.MEDIUM )`).
`DateFormat`	`getDateFormat()`	Returns the internally stored `DateFormat` instance.
`static DateFormat`	`getDateTimeInstance(int dateStyle, int timeStyle)`	Restores the jdk8 behaviour of `DateFormat.getDateTimeInstance(int, int)` to avoid the verbose date time format introduced with jdk9.
`static DateFormat`	`getDateTimeInstance(int dateStyle, int timeStyle, Locale aLocale)`	Restores the jdk8 behaviour of `DateFormat.getDateTimeInstance(int, int, Locale)` to avoid the verbose date time format introduced with jdk9.
`double`	`parse(String text)`	Parses text as a date time string.
`static double`	`parseDateTime(String text)`	Parses text as a date time string using `parse`.
`static double`	`parseDateTime(String text, DateFormat df)`	Parses text as a date time string using `df` and `parse`.
`double`	`parseDouble(String text)`	Returns `Double.parseDouble(java.lang.String)`, but (if necessary) returns `Double.NaN` instead of throwing a `NumberFormatException`.
`protected Date`	`parseHilf(String text, ParsePosition pos)`	Used internally.
`static Date`	`toDate(double z)`	Returns `java.util.Date` for decimal seconds since 01-Jan-1970 00:00:00 UTC.
`String`	`toPattern()`	Returns a pattern string describing the internally stored `DateFormat` instance.
`static String`	`toPattern(DateFormat df)`	Returns a pattern string describing `df`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail
- INVALID
```
public static final double INVALID
```
  Value returned for unparseable date time String.
  
  See Also:
  
  Constant Field Values

Constructor Detail
- KmgDateTimeConverter
```
public KmgDateTimeConverter()
```
  Creates a KmgDateTimeConverter instance.
- KmgDateTimeConverter
```
public KmgDateTimeConverter(DateFormat df)
```
  Creates a KmgDateTimeConverter instance using df. If the DateFormat does not match for parse(…), df is adjusted internally.
- KmgDateTimeConverter
```
public KmgDateTimeConverter(String defaultDateTimeFormatPattern)
```
  Abbreviation of @KmgDateTimeConverter( @SimpleDateFormat( defaultDateTimeFormatPattern ) )

Method Detail

getDateFormat
```
public DateFormat getDateFormat()
```
Returns the internally stored DateFormat instance.

toPattern
```
public String toPattern()
```
Returns a pattern string describing the internally stored DateFormat instance.

toPattern

public static String toPattern(DateFormat df)

Returns a pattern string describing df.

getDateTimeInstance
```
public static DateFormat getDateTimeInstance(int dateStyle,
                                             int timeStyle)
```
Restores the jdk8 behaviour of DateFormat.getDateTimeInstance(int, int) to avoid the verbose date time format introduced with jdk9. Workaround for Bug ID: → JDK-8194735 (section Comments).

See Also:

DateFormat.getDateTimeInstance(int, int)

getDateTimeInstance
```
public static DateFormat getDateTimeInstance(int dateStyle,
                                             int timeStyle,
                                             Locale aLocale)
```
Restores the jdk8 behaviour of DateFormat.getDateTimeInstance(int, int, Locale) to avoid the verbose date time format introduced with jdk9. Workaround for Bug ID: → JDK-8194735 (section Comments).

See Also:

DateFormat.getDateTimeInstance(int, int, Locale)

formatDateTime

public static String formatDateTime(double z,
                                    DateFormat df)

Formats z as a date time string using df.

Returns:: format( z, df ).

formatDateTime
```
public static String formatDateTime(double z)
```
Formats z as a date time string (e.g. dd.MM.yyyy HH:mm:ss z using getDateTimeInstance( DateFormat.MEDIUM, DateFormat.LONG )).

formatDateTime

public static String formatDateTime(double z,
                                    double dz)

Formats z as a date time string with precision dz in seconds.

formatDate
```
public static String formatDate(double z)
```
Formats z as a date string ( e.g. dd.MM.yy using DateFormat.getDateInstance( DateFormat.SHORT )).

formatTime
```
public static String formatTime(double z)
```
Formats z as a time string ( e.g. HH:mm:ss using DateFormat.getTimeInstance( DateFormat.MEDIUM )).

format

public static String format(double z,
                            DateFormat df)

Formats z as a date time string using df.

format
```
public String format(double z)
```
Formats z as a date time string using the internally stored DateFormat instance.

parseDateTime
```
public static double parseDateTime(String text)
```
Parses text as a date time string using parse.

parseDateTime

public static double parseDateTime(String text,
                                   DateFormat df)

Parses text as a date time string using df and parse.

parse

public double parse(String text)

Parses text as a date time string. Tries various date time patterns to find a matching DateFormat starting with the internally stored instance.

The patterns are tested in the sequence given in the following table until a matching format is found:

pattern	text (example)	comment
`yyyy-MM-dd'T'HH:mm:ssXX yyyy-MM-dd'T'HH:mm:ssX`	`2013-12-31T23:59:59+0100 2013-12-31T23:59:59Z`	explicit `TimeZone` e.g. GMT`+01:00` explicit UTC = GMT`+0000`
`yyyy-MM-dd'T'HH:mm:ss`	`2013-12-31T23:59:59`	default `TimeZone`
`yyyy-MM-dd'T'HH:mm`	`2013-12-31T23:59`	default `TimeZone`
`yyyy-MM-dd HH:mm:ss`	`2013-12-31 23:59:59`	default `TimeZone`
`yyyy-MM-dd HH:mm`	`2013-12-31 23:59`	default `TimeZone`
`yyyy-MM-dd`	`2013-12-31`	default `TimeZone`
`dateStyle: SHORT timeStyle: MEDIUM`	e.g. `31.12.13 23:59:59` or `31.12.2013 23:59:59`	default `DateTimeInstance` for the `Locale` of the Java Virtual Machine
`dateStyle: SHORT timeStyle: SHORT`	e.g. `31.12.13 23:59` or `31.12.2013 23:59`	default `DateTimeInstance` for the `Locale` of the Java Virtual Machine
`dateStyle: SHORT`	e.g. `31.12.13` or `31.12.2013`	default `DateInstance` for the `Locale` of the Java Virtual Machine
`timeStyle: MEDIUM`	e.g. `23:59:59`	default `TimeInstance` for `Locale`
`timeStyle: SHORT`	e.g. `23:59`	default `TimeInstance` for `Locale`
`yyyyMMddHHmmss.SSS`	`20131231235959.123`	with ms, default `TimeZone`
`yyyyMMddHHmmssXX yyyyMMddHHmmssX`	`20131231235959+0100 20131231235959Z`	explicit `TimeZone` e.g. GMT`+01:00` explicit UTC = GMT`+0000`
`yyyyMMddHHmmss`	`20131231235959`	default `TimeZone`
`yyyyMMddHHmm`	`201312312359`	default `TimeZone`
`yyyyMMdd`	`20131231`	default `TimeZone`
`M/d/yyyy H:mm:ss`	`12/31/2013 23:59:59`	MS-Excel csv-export, default `TimeZone`
`M/d/yyyy H:mm`	`12/31/2013 23:59`	MS-Excel csv-export, default `TimeZone`
`M/d/yyyy`	`12/31/2013`	MS-Excel csv-export, default `TimeZone`

If the TimeZone is not given in text and has not been changed for the DateFormat df using df.setTimeZone(…), parse uses the default TimeZone of the Java Virtual Machine. The default can be changed using TimeZone.setDefault(java.util.TimeZone).

The patterns with dateStyle and timeStyle use a DateTimeInstance for the default Locale of the Java Virtual Machine.

parseHilf

protected Date parseHilf(String text,
                         ParsePosition pos)

Used internally.

forDate
```
public static double forDate(Date d)
```
Returns decimal seconds since 01-Jan-1970 00:00:00 UTC for d.

Returns:

0.001 * d.getTime()

toDate
```
public static Date toDate(double z)
```
Returns java.util.Date for decimal seconds since 01-Jan-1970 00:00:00 UTC.

Returns:

new Date( Math.round( 1000 * z ) )

parseDouble
```
public double parseDouble(String text)
```
Returns Double.parseDouble(java.lang.String), but (if necessary) returns Double.NaN instead of throwing a NumberFormatException.

Class KmgDateTimeConverter

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

INVALID

Constructor Detail

KmgDateTimeConverter

KmgDateTimeConverter

KmgDateTimeConverter

Method Detail

getDateFormat

toPattern

toPattern

getDateTimeInstance

getDateTimeInstance

formatDateTime

formatDateTime

formatDateTime

formatDate

formatTime

format

format

parseDateTime

parseDateTime

parse

parseHilf

forDate

toDate

parseDouble