JulianDate (CesiumJS GWT Wrapper 1.59.4 API)

java.lang.Object
- org.cesiumjs.cs.core.JulianDate

@JsType(isNative=true,
        namespace="Cesium",
        name="JulianDate")
public class JulianDate
extends Object

Author:: Serge Silaev aka iSergio

Field Summary

Fields
Modifier and Type	Field and Description
`int`	`dayNumber` Gets or sets the list of leap seconds used throughout Cesium.
`LeapSecond[]`	`leapSeconds` Gets or sets the list of leap seconds used throughout Cesium.
`int`	`secondsOfDay` Gets or sets the number of seconds into the current day.

Constructor Summary

Constructors
Constructor and Description
`JulianDate()` Represents an astronomical Julian date, which is the number of days since noon on January 1, -4712 (4713 BC).
`JulianDate(double julianDayNumber)` Represents an astronomical Julian date, which is the number of days since noon on January 1, -4712 (4713 BC).
`JulianDate(double julianDayNumber, double secondsOfDay)` Represents an astronomical Julian date, which is the number of days since noon on January 1, -4712 (4713 BC).
`JulianDate(double julianDayNumber, double secondsOfDay, Integer timeStandard)` Represents an astronomical Julian date, which is the number of days since noon on January 1, -4712 (4713 BC).

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static JulianDate`	`addDays(JulianDate julianDate, int days, JulianDate result)` Adds the provided number of days to the provided date instance.
`static JulianDate`	`addHours(JulianDate julianDate, int hours, JulianDate result)` Adds the provided number of hours to the provided date instance.
`static JulianDate`	`addMinutes(JulianDate julianDate, int minutes, JulianDate result)` Adds the provided number of minutes to the provided date instance.
`static JulianDate`	`addSeconds(JulianDate julianDate, int seconds, JulianDate result)` Adds the provided number of seconds to the provided date instance.
`JulianDate`	`clone()` Duplicates this instance.
`static JulianDate`	`clone(JulianDate julianDate)` Duplicates a JulianDate instance.
`static JulianDate`	`clone(JulianDate julianDate, JulianDate result)` Duplicates a JulianDate instance.
`static int`	`compare(JulianDate left, JulianDate right)` Compares two instances.
`static int`	`computeTaiMinusUtc(JulianDate julianDate)` Computes the number of seconds the provided instance is ahead of UTC.
`static int`	`daysDifference(JulianDate left, JulianDate right)` Computes the difference in days between the provided instance.
`boolean`	`equals(JulianDate right)` Compares this and the provided instance and returns true if they are equal, false otherwise.
`static boolean`	`equals(JulianDate left, JulianDate right)` Compares two instances and returns true if they are equal, false otherwise.
`boolean`	`equalsEpsilon(JulianDate right, int epsilon)` Compares this and the provided instance and returns true if they are within epsilon seconds of each other.
`static boolean`	`equalsEpsilon(JulianDate left, JulianDate right, int epsilon)` Compares two instances and returns true if they are within epsilon seconds of each other.
`static JulianDate`	`fromDate(JsDate date)` Creates a new instance from a JavaScript Date.
`static JulianDate`	`fromDate(JsDate date, JulianDate result)` Creates a new instance from a JavaScript Date.
`static JulianDate`	`fromIso8601(String iso8601String)` Creates a new instance from a from an ISO 8601 date.
`static JulianDate`	`fromIso8601(String iso8601String, JulianDate result)` Creates a new instance from a from an ISO 8601 date.
`static boolean`	`greaterThan(JulianDate left, JulianDate right)` Compares the provided instances and returns true if left is later than right, false otherwise.
`static boolean`	`greaterThanOrEquals(JulianDate left, JulianDate right)` Compares the provided instances and returns true if left is later than or equal to right, false otherwise.
`static boolean`	`lessThan(JulianDate left, JulianDate right)` Compares the provided instances and returns true if left is earlier than right, false otherwise.
`static boolean`	`lessThanOrEquals(JulianDate left, JulianDate right)` Compares the provided instances and returns true if left is earlier than or equal to right, false otherwise.
`static JulianDate`	`now()` Creates a new instance that represents the current system time.
`static JulianDate`	`now(JulianDate result)` Creates a new instance that represents the current system time.
`static int`	`secondsDifference(JulianDate left, JulianDate right)` Computes the difference in seconds between the provided instance.
`static JsDate`	`toDate(JulianDate julianDate)` Creates a JavaScript Date from the provided instance.
`static GregorianDate`	`toGregorianDate(JulianDate julianDate)` Creates a GregorianDate from the provided instance.
`static GregorianDate`	`toGregorianDate(JulianDate julianDate, GregorianDate result)` Creates a GregorianDate from the provided instance.
`static String`	`toIso8601(JulianDate julianDate)` Creates an ISO8601 representation of the provided date.
`static String`	`toIso8601(JulianDate julianDate, int precision)` Creates an ISO8601 representation of the provided date.
`String`	`toString()` Creates a string representing this date in ISO8601 format.
`static int`	`totalDays(JulianDate julianDate)` Computes the total number of whole and fractional days represented by the provided instance.

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

- Field Detail
  - leapSeconds
```
public LeapSecond[] leapSeconds
```
    Gets or sets the list of leap seconds used throughout Cesium.
  - dayNumber
```
public int dayNumber
```
    Gets or sets the list of leap seconds used throughout Cesium.
  - secondsOfDay
```
public int secondsOfDay
```
    Gets or sets the number of seconds into the current day.
- Constructor Detail
  - JulianDate
```
@JsConstructor
public JulianDate()
```
    Represents an astronomical Julian date, which is the number of days since noon on January 1, -4712 (4713 BC). For increased precision, this class stores the whole number part of the date and the seconds part of the date in separate components. In order to be safe for arithmetic and represent leap seconds, the date is always stored in the International Atomic Time standard TimeStandard.TAI.
  - JulianDate
```
@JsConstructor
public JulianDate(double julianDayNumber)
```
    Represents an astronomical Julian date, which is the number of days since noon on January 1, -4712 (4713 BC). For increased precision, this class stores the whole number part of the date and the seconds part of the date in separate components. In order to be safe for arithmetic and represent leap seconds, the date is always stored in the International Atomic Time standard TimeStandard.TAI.
    
    Parameters:
    
    julianDayNumber - The Julian Day Number representing the number of whole days. Fractional days will also be handled correctly. Default: 0.
  - JulianDate
```
@JsConstructor
public JulianDate(double julianDayNumber,
                                 double secondsOfDay)
```
    Represents an astronomical Julian date, which is the number of days since noon on January 1, -4712 (4713 BC). For increased precision, this class stores the whole number part of the date and the seconds part of the date in separate components. In order to be safe for arithmetic and represent leap seconds, the date is always stored in the International Atomic Time standard TimeStandard.TAI.
    
    Parameters:
    
    julianDayNumber - The Julian Day Number representing the number of whole days. Fractional days will also be handled correctly. Default: 0.
    
    secondsOfDay - The number of seconds into the current Julian Day Number. Fractional seconds, negative seconds and seconds greater than a day will be handled correctly. Default: 0.
  - JulianDate
```
@JsConstructor
public JulianDate(double julianDayNumber,
                                 double secondsOfDay,
                                 Integer timeStandard)
```
    Represents an astronomical Julian date, which is the number of days since noon on January 1, -4712 (4713 BC). For increased precision, this class stores the whole number part of the date and the seconds part of the date in separate components. In order to be safe for arithmetic and represent leap seconds, the date is always stored in the International Atomic Time standard TimeStandard.TAI.
    
    Parameters:
    
    julianDayNumber - The Julian Day Number representing the number of whole days. Fractional days will also be handled correctly. Default: 0.
    
    secondsOfDay - The number of seconds into the current Julian Day Number. Fractional seconds, negative seconds and seconds greater than a day will be handled correctly. Default: 0.
    
    timeStandard - The time standard in which the first two parameters are defined. Default: TimeStandard.UTC().
- Method Detail
  - addDays
```
public static JulianDate addDays(JulianDate julianDate,
                                 int days,
                                 JulianDate result)
```
    Adds the provided number of days to the provided date instance.
    
    Parameters:
    
    julianDate - The date.
    
    days - The number of days to add or subtract.
    
    result - An existing instance to use for the result.
    
    Returns:
    
    The modified result parameter.
  - addHours
```
public static JulianDate addHours(JulianDate julianDate,
                                  int hours,
                                  JulianDate result)
```
    Adds the provided number of hours to the provided date instance.
    
    Parameters:
    
    julianDate - The date.
    
    hours - The number of hours to add or subtract.
    
    result - An existing instance to use for the result.
    
    Returns:
    
    The modified result parameter.
  - addMinutes
```
public static JulianDate addMinutes(JulianDate julianDate,
                                    int minutes,
                                    JulianDate result)
```
    Adds the provided number of minutes to the provided date instance.
    
    Parameters:
    
    julianDate - The date.
    
    minutes - The number of minutes to add or subtract.
    
    result - An existing instance to use for the result.
    
    Returns:
    
    The modified result parameter.
  - addSeconds
```
public static JulianDate addSeconds(JulianDate julianDate,
                                    int seconds,
                                    JulianDate result)
```
    Adds the provided number of seconds to the provided date instance.
    
    Parameters:
    
    julianDate - The date.
    
    seconds - The number of seconds to add or subtract.
    
    result - An existing instance to use for the result.
    
    Returns:
    
    The modified result parameter.
  - clone
```
public static JulianDate clone(JulianDate julianDate)
```
    Duplicates a JulianDate instance.
    
    Parameters:
    
    julianDate - The date to duplicate.
    
    Returns:
    
    The modified result parameter or a new instance if none was provided. Returns undefined if julianDate is undefined.
  - clone
```
public static JulianDate clone(JulianDate julianDate,
                               JulianDate result)
```
    Duplicates a JulianDate instance.
    
    Parameters:
    
    julianDate - The date to duplicate.
    
    result - An existing instance to use for the result.
    
    Returns:
    
    The modified result parameter or a new instance if none was provided. Returns undefined if julianDate is undefined.
  - compare
```
public static int compare(JulianDate left,
                          JulianDate right)
```
    Compares two instances.
    
    Parameters:
    
    left - The first instance.
    
    right - The second instance.
    
    Returns:
    
    A negative value if left is less than right, a positive value if left is greater than right, or zero if left and right are equal.
  - computeTaiMinusUtc
```
public static int computeTaiMinusUtc(JulianDate julianDate)
```
    Computes the number of seconds the provided instance is ahead of UTC.
    
    Parameters:
    
    julianDate - The date.
    
    Returns:
    
    The number of seconds the provided instance is ahead of UTC
  - daysDifference
```
public static int daysDifference(JulianDate left,
                                 JulianDate right)
```
    Computes the difference in days between the provided instance.
    
    Parameters:
    
    left - The first instance.
    
    right - The second instance.
    
    Returns:
    
    The difference, in days, when subtracting right from left.
  - equals
```
public static boolean equals(JulianDate left,
                             JulianDate right)
```
    Compares two instances and returns true if they are equal, false otherwise.
    
    Parameters:
    
    left - The first instance.
    
    right - The second instance.
    
    Returns:
    
    true if the dates are equal; otherwise, false.
  - equalsEpsilon
```
public static boolean equalsEpsilon(JulianDate left,
                                    JulianDate right,
                                    int epsilon)
```
    Compares two instances and returns true if they are within epsilon seconds of each other. That is, in order for the dates to be considered equal (and for this function to return true), the absolute value of the difference between them, in seconds, must be less than epsilon.
    
    Parameters:
    
    left - The first instance.
    
    right - The second instance.
    
    epsilon - The maximum number of seconds that should separate the two instances.
    
    Returns:
    
    true if the two dates are within epsilon seconds of each other; otherwise false.
  - fromDate
```
public static JulianDate fromDate(JsDate date)
```
    Creates a new instance from a JavaScript Date.
    
    Parameters:
    
    date - A JavaScript Date.
    
    Returns:
    
    The modified result parameter or a new instance if none was provided.
  - fromDate
```
public static JulianDate fromDate(JsDate date,
                                  JulianDate result)
```
    Creates a new instance from a JavaScript Date.
    
    Parameters:
    
    date - A JavaScript Date.
    
    result - An existing instance to use for the result.
    
    Returns:
    
    The modified result parameter or a new instance if none was provided.
  - fromIso8601
```
public static JulianDate fromIso8601(String iso8601String)
```
    Creates a new instance from a from an ISO 8601 date. This method is superior to Date.parse because it will handle all valid formats defined by the ISO 8601 specification, including leap seconds and sub-millisecond times, which discarded by most JavaScript implementations.
    
    Parameters:
    
    iso8601String - An ISO 8601 date.
    
    Returns:
    
    The modified result parameter or a new instance if none was provided.
  - fromIso8601
```
public static JulianDate fromIso8601(String iso8601String,
                                     JulianDate result)
```
    Creates a new instance from a from an ISO 8601 date. This method is superior to Date.parse because it will handle all valid formats defined by the ISO 8601 specification, including leap seconds and sub-millisecond times, which discarded by most JavaScript implementations.
    
    Parameters:
    
    iso8601String - An ISO 8601 date.
    
    result - An existing instance to use for the result.
    
    Returns:
    
    The modified result parameter or a new instance if none was provided.
  - greaterThan
```
public static boolean greaterThan(JulianDate left,
                                  JulianDate right)
```
    Compares the provided instances and returns true if left is later than right, false otherwise.
    
    Parameters:
    
    left - The first instance.
    
    right - The second instance.
    
    Returns:
    
    true if left is later than right, false otherwise.
  - greaterThanOrEquals
```
public static boolean greaterThanOrEquals(JulianDate left,
                                          JulianDate right)
```
    Compares the provided instances and returns true if left is later than or equal to right, false otherwise.
    
    Parameters:
    
    left - The first instance.
    
    right - The second instance.
    
    Returns:
    
    true if left is later than or equal to right, false otherwise.
  - lessThan
```
public static boolean lessThan(JulianDate left,
                               JulianDate right)
```
    Compares the provided instances and returns true if left is earlier than right, false otherwise.
    
    Parameters:
    
    left - The first instance.
    
    right - The second instance.
    
    Returns:
    
    true if left is earlier than right, false otherwise.
  - lessThanOrEquals
```
public static boolean lessThanOrEquals(JulianDate left,
                                       JulianDate right)
```
    Compares the provided instances and returns true if left is earlier than or equal to right, false otherwise.
    
    Parameters:
    
    left - The first instance.
    
    right - The second instance.
    
    Returns:
    
    true if left is earlier than or equal to right, false otherwise.
  - now
```
public static JulianDate now()
```
    Creates a new instance that represents the current system time. This is equivalent to calling JulianDate.fromDate(new Date());.
    
    Returns:
    
    The modified result parameter or a new instance if none was provided.
  - now
```
public static JulianDate now(JulianDate result)
```
    Creates a new instance that represents the current system time. This is equivalent to calling JulianDate.fromDate(new Date());.
    
    Parameters:
    
    result - An existing instance to use for the result.
    
    Returns:
    
    The modified result parameter or a new instance if none was provided.
  - secondsDifference
```
public static int secondsDifference(JulianDate left,
                                    JulianDate right)
```
    Computes the difference in seconds between the provided instance.
    
    Parameters:
    
    left - The first instance.
    
    right - The second instance.
    
    Returns:
    
    The difference, in seconds, when subtracting right from left.
  - toDate
```
public static JsDate toDate(JulianDate julianDate)
```
    Creates a JavaScript Date from the provided instance. Since JavaScript dates are only accurate to the nearest millisecond and cannot represent a leap second, consider using JulianDate.toGregorianDate instead. If the provided JulianDate is during a leap second, the previous second is used.
    
    Parameters:
    
    julianDate - The date to be converted.
    
    Returns:
    
    A new instance representing the provided date.
  - toGregorianDate
```
public static GregorianDate toGregorianDate(JulianDate julianDate)
```
    Creates a GregorianDate from the provided instance.
    
    Parameters:
    
    julianDate - The date to be converted.
    
    Returns:
    
    The modified result parameter or a new instance if none was provided.
  - toGregorianDate
```
public static GregorianDate toGregorianDate(JulianDate julianDate,
                                            GregorianDate result)
```
    Creates a GregorianDate from the provided instance.
    
    Parameters:
    
    julianDate - The date to be converted.
    
    result - An existing instance to use for the result.
    
    Returns:
    
    The modified result parameter or a new instance if none was provided.
  - toIso8601
```
public static String toIso8601(JulianDate julianDate)
```
    Creates an ISO8601 representation of the provided date.
    
    Parameters:
    
    julianDate - The date to be converted.
    
    Returns:
    
    The ISO8601 representation of the provided date.
  - toIso8601
```
public static String toIso8601(JulianDate julianDate,
                               int precision)
```
    Creates an ISO8601 representation of the provided date.
    
    Parameters:
    
    julianDate - The date to be converted.
    
    precision - The number of fractional digits used to represent the seconds component. By default, the most precise representation is used.
    
    Returns:
    
    The ISO8601 representation of the provided date.
  - totalDays
```
public static int totalDays(JulianDate julianDate)
```
    Computes the total number of whole and fractional days represented by the provided instance.
    
    Parameters:
    
    julianDate - The date.
    
    Returns:
    
    The Julian date as single floating point number.
  - clone
```
public JulianDate clone()
```
    Duplicates this instance.
    
    Overrides:
    
    clone in class Object
    
    Returns:
    
    The modified result parameter or a new instance if none was provided.
  - equals
```
public boolean equals(JulianDate right)
```
    Compares this and the provided instance and returns true if they are equal, false otherwise.
    
    Parameters:
    
    right - The second instance.
    
    Returns:
    
    true if the dates are equal; otherwise, false.
  - equalsEpsilon
```
public boolean equalsEpsilon(JulianDate right,
                             int epsilon)
```
    Compares this and the provided instance and returns true if they are within epsilon seconds of each other. That is, in order for the dates to be considered equal (and for this function to return true), the absolute value of the difference between them, in seconds, must be less than epsilon.
    
    Parameters:
    
    right - The second instance.
    
    epsilon - The maximum number of seconds that should separate the two instances.
    
    Returns:
    
    true if the two dates are within epsilon seconds of each other; otherwise false.
  - toString
```
public String toString()
```
    Creates a string representing this date in ISO8601 format.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    A string representing this date in ISO8601 format.

Class JulianDate

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

leapSeconds

dayNumber

secondsOfDay

Constructor Detail

JulianDate

JulianDate

JulianDate

JulianDate

Method Detail

addDays

addHours

addMinutes

addSeconds

clone

clone

compare

computeTaiMinusUtc

daysDifference

equals

equalsEpsilon

fromDate

fromDate

fromIso8601

fromIso8601

greaterThan

greaterThanOrEquals

lessThan

lessThanOrEquals

now

now

secondsDifference

toDate

toGregorianDate

toGregorianDate

toIso8601

toIso8601

totalDays

clone

equals

equalsEpsilon

toString