com.google.api.client.util
Class DateTime

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

public class DateTime
extends Object

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

Since:
1.0
Author:
Yaniv Inbar

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


Copyright © 2010 Google. All Rights Reserved.