com.google.api.client.util
Class DateTime

java.lang.Object
  com.google.api.client.util.DateTime

All Implemented Interfaces:

Serializable

public class DateTime
extends Object
implements Serializable

Immutable representation of a date with an optional time and an optional time zone based on RFC 3339.

Since:

1.0

Author:

Yaniv Inbar

See Also:

Serialized Form

Field Summary

boolean	dateOnly Specifies whether this is a date-only value.
Integer	tzShift Time zone shift from UTC in minutes.
long	value Date/time value expressed as the number of ms since the Unix epoch.

Constructor Summary

DateTime(boolean dateOnly, long value, Integer tzShift)

DateTime(Date value)

DateTime(Date date, TimeZone zone)

DateTime(long value)

DateTime(long value, Integer tzShift)

Method Summary

boolean	equals(Object o)
static DateTime	parseRfc3339(String str) Parses an RFC 3339 date/time value.
String	toString()
String	toStringRfc3339() Formats the value as an RFC 3339 date/time string.

Methods inherited from class java.lang.Object

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

Field Detail

value

public final long value

Date/time value expressed as the number of ms since the Unix epoch. If the time zone is specified, this value is normalized to UTC, so to format this date/time value, the time zone shift has to be applied.

dateOnly

public final boolean dateOnly

Specifies whether this is a date-only value.

tzShift

public final Integer tzShift

Time zone shift from UTC in minutes. If null, no time zone is set, and the time is always interpreted as local time.

Constructor Detail

DateTime

public DateTime(Date date,
                TimeZone zone)

DateTime

public DateTime(long value)

DateTime

public DateTime(Date value)

DateTime

public DateTime(long value,
                Integer tzShift)

DateTime

public DateTime(boolean dateOnly,
                long value,
                Integer tzShift)

Method Detail

toStringRfc3339

public String toStringRfc3339()

Formats the value as an RFC 3339 date/time string.

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

parseRfc3339

public static DateTime parseRfc3339(String str)
                             throws NumberFormatException

Parses an RFC 3339 date/time value.

Throws:

NumberFormatException