com.google.api.ads.dfp.axis.utils.v201508

Class DateTimes

java.lang.Object

com.google.api.ads.dfp.axis.utils.v201508.DateTimes

public final class DateTimes
extends Object

A utility class for handling DateTime objects.

Method Summary

Modifier and Type	Method and Description
static Calendar	toCalendar(com.google.api.ads.dfp.axis.v201508.DateTime dateTime) Gets a calendar for a DateTime using the default locale, i.e.
static Calendar	toCalendar(com.google.api.ads.dfp.axis.v201508.DateTime dateTime, Locale locale) Gets a calendar for a DateTime in the supplied locale.
static com.google.api.ads.dfp.axis.v201508.DateTime	toDateTime(Calendar calendar) Converts a Calendar object to an API date time preserving the time zone.
static com.google.api.ads.dfp.axis.v201508.DateTime	toDateTime(org.joda.time.DateTime dateTime) Converts a DateTime object to an API date time preserving the time zone.
static org.joda.time.DateTime	toDateTime(com.google.api.ads.dfp.axis.v201508.DateTime dateTime) Converts an API date time to a DateTime preserving the time zone.
static com.google.api.ads.dfp.axis.v201508.DateTime	toDateTime(org.joda.time.Instant instant, String timeZoneId) Converts an Instant object to an API date time in the time zone supplied.
static com.google.api.ads.dfp.axis.v201508.DateTime	toDateTime(String dateTime, String timeZoneId) Converts a string in the form of yyyy-MM-dd'T'HH:mm:ss to an API date time in the time zone supplied.
static com.google.api.ads.dfp.axis.v201508.DateTime	toDateTimeWithTimeZone(String dateTime) Converts a string in the form of yyyy-MM-dd'T'HH:mm:ss±HH:mm, or yyyy-MM-dd'T'HH:mm:ssZ for Etc/GMT, to an API date time in the time zone supplied.
static String	toString(com.google.api.ads.dfp.axis.v201508.Date date) Returns string representation of this date.
static String	toString(com.google.api.ads.dfp.axis.v201508.DateTime dateTime) Returns string representation of this date time.
static String	toStringForTimeZone(com.google.api.ads.dfp.axis.v201508.DateTime dateTime, String newZoneId) Returns string representation of this date time with a different time zone, preserving the millisecond instant.
static String	toStringWithTimeZone(com.google.api.ads.dfp.axis.v201508.DateTime dateTime) Returns string representation of this date time with time zone.

Methods inherited from class java.lang.Object

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

Method Detail

toDateTime

public static com.google.api.ads.dfp.axis.v201508.DateTime toDateTime(Calendar calendar)

Converts a Calendar object to an API date time preserving the time zone.

toDateTime

public static com.google.api.ads.dfp.axis.v201508.DateTime toDateTime(org.joda.time.Instant instant,
                                                                      String timeZoneId)

Converts an Instant object to an API date time in the time zone supplied.

toDateTime

public static com.google.api.ads.dfp.axis.v201508.DateTime toDateTime(org.joda.time.DateTime dateTime)

Converts a DateTime object to an API date time preserving the time zone.

toDateTime

public static com.google.api.ads.dfp.axis.v201508.DateTime toDateTime(String dateTime,
                                                                      String timeZoneId)

Converts a string in the form of yyyy-MM-dd'T'HH:mm:ss to an API date time in the time zone supplied.

toDateTimeWithTimeZone

public static com.google.api.ads.dfp.axis.v201508.DateTime toDateTimeWithTimeZone(String dateTime)

Converts a string in the form of yyyy-MM-dd'T'HH:mm:ss±HH:mm, or yyyy-MM-dd'T'HH:mm:ssZ for Etc/GMT, to an API date time in the time zone supplied.

toDateTime

public static org.joda.time.DateTime toDateTime(com.google.api.ads.dfp.axis.v201508.DateTime dateTime)

Converts an API date time to a DateTime preserving the time zone.

toCalendar

public static Calendar toCalendar(com.google.api.ads.dfp.axis.v201508.DateTime dateTime)

Gets a calendar for a DateTime using the default locale, i.e. Locale.getDefault().

toCalendar

public static Calendar toCalendar(com.google.api.ads.dfp.axis.v201508.DateTime dateTime,
                                  Locale locale)

Gets a calendar for a DateTime in the supplied locale.

toString

public static String toString(com.google.api.ads.dfp.axis.v201508.Date date)

Returns string representation of this date.

Parameters:

date - the date to stringify

Returns:

a string representation of the Date in yyyy-MM-dd

toString

public static String toString(com.google.api.ads.dfp.axis.v201508.DateTime dateTime)

Returns string representation of this date time. The string representation does not include the time zone since using date times for filtering does not use the time zone. If you need to convert the date time into another time zone before filtering on it, please use toStringForTimeZone(DateTime, String) instead.

Parameters:

dateTime - the date time to stringify

Returns:

a string representation of the DateTime in yyyy-MM-dd'T'HH:mm:ss

toStringWithTimeZone

public static String toStringWithTimeZone(com.google.api.ads.dfp.axis.v201508.DateTime dateTime)

Returns string representation of this date time with time zone. If you need to convert the date time into another time zone before filtering on it, please use toStringForTimeZone(DateTime, String) instead.

Parameters:

dateTime - the date time to stringify

Returns:

a string representation of the DateTime in yyyy-MM-dd'T'HH:mm:ss±HH:mm, i.e. 2013-09-013T12:02:03+08:00 or 2013-09-013T12:02:03Z for Etc/GMT.

toStringForTimeZone

public static String toStringForTimeZone(com.google.api.ads.dfp.axis.v201508.DateTime dateTime,
                                         String newZoneId)

Returns string representation of this date time with a different time zone, preserving the millisecond instant.

This method is useful for finding the local time in another time zone, especially for filtering.

For example, if this date time holds 12:30 in Europe/London, the result from this method with Europe/Paris would be 13:30. You may also want to use this with your network's time zone, i.e.

 String timeZoneId = networkService.getCurrentNetwork().getTimeZone();
 String statementPart =
     "startDateTime > "
         + DateTimes.toString(apiDateTime, timeZoneId);
 //...
 statementBuilder.where(statementPart);
 

This method is in the same style of DateTime.withZone(org.joda.time.DateTimeZone).

Parameters:

dateTime - the date time to stringify into a new time zone

newZoneId - the time zone ID of the new zone

Returns:

a string representation of the DateTime in yyyy-MM-dd'T'HH:mm:ss