DateTime (Google Data Java Client Library 1.47.1 API)

java.lang.Object
- com.google.gdata.data.DateTime

All Implemented Interfaces:

Comparable<Object>
```
public class DateTime
extends Object
implements Comparable<Object>
```
Represents a date/time, or a date without a time. Optionally includes a time zone.

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`dateOnly` Specifies whether this is a date-only value.
`static Pattern`	`datePattern` XML date pattern.
`static Pattern`	`dateTimeChoicePattern` XML date/time or date pattern.
`static Pattern`	`dateTimePattern` XML date/time pattern.
`protected Integer`	`tzShift` Time zone shift from UTC in minutes.
`protected long`	`value` Date/time value expressed as the number of ms since the Unix epoch.

Constructor Summary

Constructors
Constructor and Description
`DateTime()`
`DateTime(Date value)`
`DateTime(Date value, TimeZone zone)`
`DateTime(long value)`
`DateTime(long value, int tzShift)`

Method Summary

Methods
Modifier and Type	Method and Description
`int`	`compareTo(Object o)`
`boolean`	`equals(Object o)` Compares instance with DateTime or Date objects.
`Integer`	`getTzShift()`
`long`	`getValue()`
`int`	`hashCode()`
`boolean`	`isDateOnly()`
`static DateTime`	`now()`
`static DateTime`	`parseDate(String str)` Parses an xs:date string.
`static DateTime`	`parseDateTime(String str)` Parses an xs:dateTime string.
`static DateTime`	`parseDateTimeChoice(String value)` Parses an XML value that's either an xs:date or xs:dateTime string.
`static DateTime`	`parseRfc822(String str)` Parses the value as an RFC 822 date/time.
`void`	`setDateOnly(boolean v)`
`void`	`setTzShift(Integer v)`
`void`	`setValue(long v)`
`String`	`toString()` Formats the value as an xs:date or xs:dateTime string.
`String`	`toStringRfc822()` Formats the value as an RFC 822 date/time.
`String`	`toUiString()` Formats the value as a human-readable string.

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

- Field Detail
  - value
```
protected 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
```
protected boolean dateOnly
```
    Specifies whether this is a date-only value.
  - tzShift
```
protected 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.
  - dateTimePattern
```
public static final Pattern dateTimePattern
```
    XML date/time pattern.
  - datePattern
```
public static final Pattern datePattern
```
    XML date pattern.
  - dateTimeChoicePattern
```
public static final Pattern dateTimeChoicePattern
```
    XML date/time or date pattern.
- Constructor Detail
  - DateTime
```
public DateTime()
```
  - DateTime
```
public DateTime(long value)
```
  - DateTime
```
public DateTime(Date value)
```
  - DateTime
```
public DateTime(long value,
        int tzShift)
```
  - DateTime
```
public DateTime(Date value,
        TimeZone zone)
```
- Method Detail
  - now
```
public static DateTime now()
```
  - getValue
```
public long getValue()
```
  - setValue
```
public void setValue(long v)
```
  - isDateOnly
```
public boolean isDateOnly()
```
  - setDateOnly
```
public void setDateOnly(boolean v)
```
  - getTzShift
```
public Integer getTzShift()
```
  - setTzShift
```
public void setTzShift(Integer v)
```
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object o)
```
    Compares instance with DateTime or Date objects. Does not take the tzShift value into account. Therefore, two DateTime objects are equal independent to the time zone they refer to. Equals with a instance of java.util.Date is asymmetric.
    
    Overrides:
    
    equals in class Object
  - compareTo
```
public int compareTo(Object o)
```
    Specified by:
    
    compareTo in interface Comparable<Object>
  - toString
```
public String toString()
```
    Formats the value as an xs:date or xs:dateTime string.
    
    Overrides:
    
    toString in class Object
  - toStringRfc822
```
public String toStringRfc822()
```
    Formats the value as an RFC 822 date/time.
  - parseRfc822
```
public static DateTime parseRfc822(String str)
                            throws ParseException
```
    Parses the value as an RFC 822 date/time.
    
    Throws:
    
    ParseException
  - toUiString
```
public String toUiString()
```
    Formats the value as a human-readable string.
  - parseDateTime
```
public static DateTime parseDateTime(String str)
                              throws NumberFormatException
```
    Parses an xs:dateTime string.
    
    Throws:
    
    NumberFormatException
  - parseDate
```
public static DateTime parseDate(String str)
                          throws NumberFormatException
```
    Parses an xs:date string.
    
    Throws:
    
    NumberFormatException
  - parseDateTimeChoice
```
public static DateTime parseDateTimeChoice(String value)
                                    throws NumberFormatException
```
    Parses an XML value that's either an xs:date or xs:dateTime string.
    
    Throws:
    
    NumberFormatException - Invalid RFC 3339 date or date/time string.

Class DateTime

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

value

dateOnly

tzShift

dateTimePattern

datePattern

dateTimeChoicePattern

Constructor Detail

DateTime

DateTime

DateTime

DateTime

DateTime

Method Detail

now

getValue

setValue

isDateOnly

setDateOnly

getTzShift

setTzShift

hashCode

equals

compareTo

toString

toStringRfc822

parseRfc822

toUiString

parseDateTime

parseDate

parseDateTimeChoice