GlobalDateTime

java.lang.Object
- com.sap.client.odata.v4.DataValue
- - com.sap.client.odata.v4.GlobalDateTime

```
public class GlobalDateTime
extends DataValue
```
Represents the XML Schema dateTime type with zone offset.

Field Summary
- Fields inherited from class com.sap.client.odata.v4.DataValue
  undefined

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static GlobalDateTime`	`castOptional(DataValue value)` For internal use only.
`static GlobalDateTime`	`castRequired(DataValue value)` For internal use only.
`static int`	`compare(GlobalDateTime left, GlobalDateTime right)` Compare two dateTime values.
`int`	`compareTo(GlobalDateTime value)` Compare this dateTime with another dateTime.
`static boolean`	`equal(GlobalDateTime left, GlobalDateTime right)` Compare two dateTime values.
`boolean`	`equals(java.lang.Object value)` Compare this dateTime value with another dateTime value.
`DataType`	`getDataType()` Data type of the wrapped value.
`LocalDate`	`getDate()` Local date component of dateTime.
`int`	`getDay()` Day field of date (1 to 31).
`int`	`getDayOfWeek()` Day of week (1 to 7).
`int`	`getDayOfYear()` Day of year (1 to 366).
`int`	`getHour()` Hour field of time (0 to 23).
`int`	`getMinute()` Minute field of time (0 to 59).
`int`	`getMonth()` Month field of date (1 to 12).
`int`	`getNano()` Nanosecond field of time (0 to 999999999).
`int`	`getOffset()` Time zone offset in minutes (-840 to 840).
`int`	`getSecond()` Second field of time (0 to 59).
`LocalTime`	`getTime()` Local time component of dateTime.
`int`	`getYear()` Year field of date.
`boolean`	`greaterEqual(GlobalDateTime value)` Compare this dateTime value with another dateTime value.
`boolean`	`greaterThan(GlobalDateTime value)` Compare this dateTime value with another dateTime value.
`int`	`hashCode()` Hash this data value to a number.
`boolean`	`lessEqual(GlobalDateTime value)` Compare this dateTime value with another dateTime value.
`boolean`	`lessThan(GlobalDateTime value)` Compare this dateTime value with another dateTime value.
`static long`	`millisBetween(GlobalDateTime a, GlobalDateTime b)` Return the difference in milliseconds between two dateTime values `a` and `b`, calculated as `b - a`.
`double`	`minus(GlobalDateTime value)` Return the difference `this - value`, measured in days.
`GlobalDateTime`	`normalize()` Normalize this dateTime value to UTC.
`boolean`	`notEqual(GlobalDateTime value)` Compare this dateTime value with another dateTime value.
`static GlobalDateTime`	`now()` Return the current global dateTime.
`static GlobalDateTime`	`of(int year, int month, int day, int hour, int minute, int second)` See of(int, int, int, int, int, int, int).
`static GlobalDateTime`	`of(int year, int month, int day, int hour, int minute, int second, int nano)` Return a new dateTime value.
`static GlobalDateTime`	`ofMillis(long ms)` Convert a Java 'millis' time value to a GlobalDateTime.
`static GlobalDateTime`	`parse(java.lang.String text)` Return (nullable) Value parsed from XML Schema format, or `null` if `text` has invalid dateTime format.
`GlobalDateTime`	`plusDays(int days)` Return a new dateTime which is the specified number of days ahead of this dateTime.
`GlobalDateTime`	`plusHours(long hours)` Return a new dateTime which is the specified number of hours ahead of this dateTime.
`GlobalDateTime`	`plusMicros(long micros)` Return a new dateTime which is the specified number of microseconds ahead of this dateTime.
`GlobalDateTime`	`plusMillis(long millis)` Return a new dateTime which is the specified number of milliseconds ahead of this dateTime.
`GlobalDateTime`	`plusMinutes(long minutes)` Return a new dateTime which is the specified number of minutes ahead of this dateTime.
`GlobalDateTime`	`plusMonths(int months)` Return a new dateTime/time which is the specified number of months ahead of this dateTime.
`GlobalDateTime`	`plusNanos(long nanos)` Return a new dateTime which is the specified number of nanoseconds ahead of this dateTime.
`GlobalDateTime`	`plusSeconds(long seconds)` Return a new dateTime which is the specified number of seconds ahead of this dateTime.
`GlobalDateTime`	`plusWeeks(int weeks)` Return a new dateTime which is the specified number of weeks ahead of this dateTime.
`GlobalDateTime`	`plusYears(int years)` Return a new dateTime which is the specified number of years ahead of this dateTime.
`static boolean`	`static_greaterEqual(GlobalDateTime left, GlobalDateTime right)` Compare two dateTime values.
`static boolean`	`static_greaterThan(GlobalDateTime left, GlobalDateTime right)` Compare two dateTime values.
`static boolean`	`static_lessEqual(GlobalDateTime left, GlobalDateTime right)` Compare two dateTime values.
`static boolean`	`static_lessThan(GlobalDateTime left, GlobalDateTime right)` Compare two dateTime values.
`static boolean`	`static_notEqual(GlobalDateTime left, GlobalDateTime right)` Compare two dateTime values.
`LocalDateTime`	`toLocal()` Return this local date and time portion of this value, without zone offset.
`static long`	`toMillis(GlobalDateTime dt)` Convert a GlobalDateTime to a Java 'millis' time value.
`java.lang.String`	`toString()` Convert this data value to a string.
`GlobalDateTime`	`zone(int offset)` Return a new dateTime value, with all fields the same as the current dateTime value except for the zone offset.

Methods inherited from class com.sap.client.odata.v4.DataValue
cloneMutable, getTypeCode

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

- Method Detail
  - castOptional
```
public static GlobalDateTime castOptional(DataValue value)
```
    For internal use only.
  - castRequired
```
public static GlobalDateTime castRequired(DataValue value)
```
    For internal use only.
  - compare
```
public static int compare(GlobalDateTime left,
                          GlobalDateTime right)
```
    Compare two dateTime values.
    
    Parameters:
    
    left - The first dateTime for comparison.
    
    right - The second dateTime for comparison.
    
    Returns:
    
    -1 if left < right, 0 if left == right, or 1 if left > right.
  - compareTo
```
public int compareTo(GlobalDateTime value)
```
    Compare this dateTime with another dateTime.
    
    Parameters:
    
    value - The other dateTime.
    
    Returns:
    
    -1 if this dateTime is less than the value dateTime, 0 if they are equal, 1 if this dateTime is greater than the value dateTime.
  - equal
```
public static boolean equal(GlobalDateTime left,
                            GlobalDateTime right)
```
    Compare two dateTime values.
    
    Parameters:
    
    left - (nullable) The first dateTime for comparison.
    
    right - (nullable) The second dateTime for comparison.
    
    Returns:
    
    true if left is equal to right, otherwise false.
  - equals
```
public boolean equals(java.lang.Object value)
```
    Compare this dateTime value with another dateTime value.
    
    Overrides:
    
    equals in class DataValue
    
    Parameters:
    
    value - (nullable) The other dateTime value.
    
    Returns:
    
    True, if this dateTime value is equal to the value dateTime value. Otherwise false.
  - getDataType
```
public DataType getDataType()
```
    Data type of the wrapped value.
    
    Specified by:
    
    getDataType in class DataValue
  - getDate
```
public LocalDate getDate()
```
    Local date component of dateTime.
  - getDay
```
public int getDay()
```
    Day field of date (1 to 31).
  - getDayOfWeek
```
public int getDayOfWeek()
```
    Day of week (1 to 7).
    
    See Also:
    
    DayOfWeek.
  - getDayOfYear
```
public int getDayOfYear()
```
    Day of year (1 to 366).
  - getHour
```
public int getHour()
```
    Hour field of time (0 to 23).
  - getMinute
```
public int getMinute()
```
    Minute field of time (0 to 59).
  - getMonth
```
public int getMonth()
```
    Month field of date (1 to 12).
    
    See Also:
    
    MonthOfYear.
  - getNano
```
public int getNano()
```
    Nanosecond field of time (0 to 999999999).
  - getOffset
```
public int getOffset()
```
    Time zone offset in minutes (-840 to 840).
  - getSecond
```
public int getSecond()
```
    Second field of time (0 to 59).
  - getTime
```
public LocalTime getTime()
```
    Local time component of dateTime.
  - getYear
```
public int getYear()
```
    Year field of date.
  - greaterEqual
```
public boolean greaterEqual(GlobalDateTime value)
```
    Compare this dateTime value with another dateTime value.
    
    Parameters:
    
    value - The other dateTime value.
    
    Returns:
    
    true if this dateTime value is greater than or equal to the value dateTime value. Oherwise false.
  - greaterThan
```
public boolean greaterThan(GlobalDateTime value)
```
    Compare this dateTime value with another dateTime value.
    
    Parameters:
    
    value - The other dateTime value.
    
    Returns:
    
    true if this dateTime value is greater than the value dateTime value. Oherwise false.
  - hashCode
```
public int hashCode()
```
    Hash this data value to a number.
    
    Overrides:
    
    hashCode in class DataValue
    
    Returns:
    
    Any value in the range of type int.
  - lessEqual
```
public boolean lessEqual(GlobalDateTime value)
```
    Compare this dateTime value with another dateTime value.
    
    Parameters:
    
    value - The other dateTime value.
    
    Returns:
    
    true if this dateTime value is less than or equal to the value dateTime value. Oherwise false.
  - lessThan
```
public boolean lessThan(GlobalDateTime value)
```
    Compare this dateTime value with another dateTime value.
    
    Parameters:
    
    value - The other dateTime value.
    
    Returns:
    
    true if this dateTime value is less than the value dateTime value. Oherwise false.
  - millisBetween
```
public static long millisBetween(GlobalDateTime a,
                                 GlobalDateTime b)
```
    Return the difference in milliseconds between two dateTime values a and b, calculated as b - a.
    
    Parameters:
    
    a - The first dateTime value.
    
    b - The second dateTime value.
    
    Returns:
    
    The difference in milliseconds between two dateTime values a and b, calculated as b - a.
  - minus
```
public double minus(GlobalDateTime value)
```
    Return the difference this - value, measured in days.
    
    Parameters:
    
    value - The other dateTime.
    
    Returns:
    
    The difference this - value, measured in days.
  - normalize
```
public GlobalDateTime normalize()
```
    Normalize this dateTime value to UTC. For example "2000-01-01T14:00:00+12:00" would normalize to "2000-01-01T02:00:00Z"
    
    Returns:
    
    An equivalent value with all fields normalized (adjusted) to UTC, such that GlobalDateTime.offset is zero.
  - notEqual
```
public boolean notEqual(GlobalDateTime value)
```
    Compare this dateTime value with another dateTime value.
    
    Parameters:
    
    value - The other dateTime value.
    
    Returns:
    
    true if this dateTime value is not equal to the value dateTime value. Oherwise false.
  - now
```
public static GlobalDateTime now()
```
    Return the current global dateTime.
    
    Returns:
    
    The current global dateTime.
  - of
```
public static GlobalDateTime of(int year,
                                int month,
                                int day,
                                int hour,
                                int minute,
                                int second)
```
    See of(int, int, int, int, int, int, int).
  - of
```
public static GlobalDateTime of(int year,
                                int month,
                                int day,
                                int hour,
                                int minute,
                                int second,
                                int nano)
```
    Return a new dateTime value.
    
    Parameters:
    
    year - The year field.
    
    month - The month field (1 to 12).
    
    day - The day field (1 to 31).
    
    hour - The hour field (0 to 23).
    
    minute - The minute field (0 to 59).
    
    second - The second field (0 to 59).
    
    nano - The nano field (0 to 999999999).
    
    Returns:
    
    A new dateTime value.
  - ofMillis
```
public static GlobalDateTime ofMillis(long ms)
```
    Convert a Java 'millis' time value to a GlobalDateTime.
    
    Parameters:
    
    ms - Milliseconds since 1970-01-01T00:00:00Z (UTC).
    
    Returns:
    
    Global date/time.
  - parse
```
public static GlobalDateTime parse(java.lang.String text)
```
    Return (nullable) Value parsed from XML Schema format, or null if text has invalid dateTime format.
    
    Parameters:
    
    text - Value in XML Schema format.
    
    Returns:
    
    (nullable) Value parsed from XML Schema format, or null if text has invalid dateTime format.
  - plusDays
```
public GlobalDateTime plusDays(int days)
```
    Return a new dateTime which is the specified number of days ahead of this dateTime.
    
    Parameters:
    
    days - Number of days to add. Can be negative, zero or positive.
    
    Returns:
    
    A new dateTime which is the specified number of days ahead of this dateTime.
  - plusHours
```
public GlobalDateTime plusHours(long hours)
```
    Return a new dateTime which is the specified number of hours ahead of this dateTime.
    
    Parameters:
    
    hours - Number of hours to add. Can be negative, zero or positive.
    
    Returns:
    
    A new dateTime which is the specified number of hours ahead of this dateTime.
  - plusMicros
```
public GlobalDateTime plusMicros(long micros)
```
    Return a new dateTime which is the specified number of microseconds ahead of this dateTime.
    
    Parameters:
    
    micros - Number of microseconds to add. Can be negative, zero or positive.
    
    Returns:
    
    A new dateTime which is the specified number of microseconds ahead of this dateTime.
  - plusMillis
```
public GlobalDateTime plusMillis(long millis)
```
    Return a new dateTime which is the specified number of milliseconds ahead of this dateTime.
    
    Parameters:
    
    millis - Number of milliseconds to add. Can be negative, zero or positive.
    
    Returns:
    
    A new dateTime which is the specified number of milliseconds ahead of this dateTime.
  - plusMinutes
```
public GlobalDateTime plusMinutes(long minutes)
```
    Return a new dateTime which is the specified number of minutes ahead of this dateTime.
    
    Parameters:
    
    minutes - Number of minutes to add. Can be negative, zero or positive.
    
    Returns:
    
    A new dateTime which is the specified number of minutes ahead of this dateTime.
  - plusMonths
```
public GlobalDateTime plusMonths(int months)
```
    Return a new dateTime/time which is the specified number of months ahead of this dateTime.
    
    Parameters:
    
    months - Number of months to add. Can be negative, zero or positive.
    
    Returns:
    
    A new dateTime/time which is the specified number of months ahead of this dateTime.
  - plusNanos
```
public GlobalDateTime plusNanos(long nanos)
```
    Return a new dateTime which is the specified number of nanoseconds ahead of this dateTime.
    
    Parameters:
    
    nanos - Number of nanoseconds to add. Can be negative, zero or positive.
    
    Returns:
    
    A new dateTime which is the specified number of nanoseconds ahead of this dateTime.
  - plusSeconds
```
public GlobalDateTime plusSeconds(long seconds)
```
    Return a new dateTime which is the specified number of seconds ahead of this dateTime.
    
    Parameters:
    
    seconds - Number of seconds to add. Can be negative, zero or positive.
    
    Returns:
    
    A new dateTime which is the specified number of seconds ahead of this dateTime.
  - plusWeeks
```
public GlobalDateTime plusWeeks(int weeks)
```
    Return a new dateTime which is the specified number of weeks ahead of this dateTime.
    
    Parameters:
    
    weeks - Number of weeks to add. Can be negative, zero or positive.
    
    Returns:
    
    A new dateTime which is the specified number of weeks ahead of this dateTime.
  - plusYears
```
public GlobalDateTime plusYears(int years)
```
    Return a new dateTime which is the specified number of years ahead of this dateTime.
    
    Parameters:
    
    years - Number of years to add. Can be negative, zero or positive.
    
    Returns:
    
    A new dateTime which is the specified number of years ahead of this dateTime.
  - static_greaterEqual
```
public static boolean static_greaterEqual(GlobalDateTime left,
                                          GlobalDateTime right)
```
    Compare two dateTime values.
    
    Parameters:
    
    left - The first dateTime for comparison.
    
    right - The second dateTime for comparison.
    
    Returns:
    
    true if left is greater than or equal to right, otherwise false.
  - static_greaterThan
```
public static boolean static_greaterThan(GlobalDateTime left,
                                         GlobalDateTime right)
```
    Compare two dateTime values.
    
    Parameters:
    
    left - The first dateTime for comparison.
    
    right - The second dateTime for comparison.
    
    Returns:
    
    true if left is greater than right, otherwise false.
  - static_lessEqual
```
public static boolean static_lessEqual(GlobalDateTime left,
                                       GlobalDateTime right)
```
    Compare two dateTime values.
    
    Parameters:
    
    left - The first dateTime for comparison.
    
    right - The second dateTime for comparison.
    
    Returns:
    
    true if left is less than or equal to right, otherwise false.
  - static_lessThan
```
public static boolean static_lessThan(GlobalDateTime left,
                                      GlobalDateTime right)
```
    Compare two dateTime values.
    
    Parameters:
    
    left - The first dateTime for comparison.
    
    right - The second dateTime for comparison.
    
    Returns:
    
    true if left is less than right, otherwise false.
  - static_notEqual
```
public static boolean static_notEqual(GlobalDateTime left,
                                      GlobalDateTime right)
```
    Compare two dateTime values.
    
    Parameters:
    
    left - (nullable) The first dateTime for comparison.
    
    right - (nullable) The second dateTime for comparison.
    
    Returns:
    
    true if left is not equal to right, otherwise false.
  - toLocal
```
public LocalDateTime toLocal()
```
    Return this local date and time portion of this value, without zone offset.
    
    See Also:
    
    GlobalDateTime.normalize.
    
    Returns:
    
    This local date and time portion of this value, without zone offset.
  - toMillis
```
public static long toMillis(GlobalDateTime dt)
```
    Convert a GlobalDateTime to a Java 'millis' time value.
    
    Parameters:
    
    dt - Global date/time.
    
    Returns:
    
    Java 'millis' time value: milliseconds since 1970-01-01T00:00:00Z (UTC).
  - toString
```
public java.lang.String toString()
```
    Convert this data value to a string. If the GlobalDateTime.dataType is defined by XML Schema Part 2: Datatypes, then the corresponding lexical format is used. JSON format is used for structured values (arrays and objects).
    
    Specified by:
    
    toString in class DataValue
    
    Returns:
    
    Lexical representation of this data value.
  - zone
```
public GlobalDateTime zone(int offset)
```
    Return a new dateTime value, with all fields the same as the current dateTime value except for the zone offset.
    
    Parameters:
    
    offset - Zone offset in minutes (-840 to 840).
    
    Returns:
    
    A new dateTime value, with all fields the same as the current dateTime value except for the zone offset.

Class GlobalDateTime

Field Summary

Fields inherited from class com.sap.client.odata.v4.DataValue

Method Summary

Methods inherited from class com.sap.client.odata.v4.DataValue

Methods inherited from class java.lang.Object

Method Detail

castOptional

castRequired

compare

compareTo

equal

equals

getDataType

getDate

getDay

getDayOfWeek

getDayOfYear

getHour

getMinute

getMonth

getNano

getOffset

getSecond

getTime

getYear

greaterEqual

greaterThan

hashCode

lessEqual

lessThan

millisBetween

minus

normalize

notEqual

now

of

of

ofMillis

parse

plusDays

plusHours

plusMicros

plusMillis

plusMinutes

plusMonths

plusNanos

plusSeconds

plusWeeks

plusYears

static_greaterEqual

static_greaterThan

static_lessEqual

static_lessThan

static_notEqual

toLocal

toMillis

toString

zone