Class OffsetDateTime

Offset datetime object
  • Represents date and time with timezone.
  • Timezone is specified with offset from UTC in seconds. This offset can be negative or positive.
  • This class internally stores a LocalDateTime and offset number.

Hierarchy

  • OffsetDateTime

Constructors

constructor

Properties

localDateTime offsetSeconds

Methods

asDate toString from fromDate fromString

Constructors

constructor

Properties

Readonly localDateTime

localDateTime: LocalDateTime

LocalDateTime object

Readonly offsetSeconds

offsetSeconds: number

timezone offset in seconds. Must be in [-64800, 64800] range.

Methods

asDate

  • Returns this offset datetime as Date. Note that the timezone information is not stored in Date objects and you effectively get a timestamp.(an instance in time without timezone)

    Returns Date

toString

  • Returns ISO 8601 string with timezone of this instance.

    Returns

    A string in the format yyyy-mm-ddTHH-mm-ss.SSS(Z | (+|-)HH:mm) Timezone is denoted either with Z or timezone string like +-HH:mm

    Returns string

Static from

  • Static constructor for convenient construction.

    Throws

    TypeError if passed arguments are of wrong type

    Throws

    RangeError if value of any of the arguments are invalid

    Parameters

    • year: number

      Must be between -999999999-999999999

    • month: number

      Must be between 1-12

    • date: number

      Must be between 1-31 depending on year and month

    • hour: number

      The hour-of-day to represent, from 0 to 23

    • minute: number

      The minute-of-hour to represent, from 0 to 59

    • second: number

      The second-of-minute to represent, from 0 to 59

    • nano: number

      The nano-of-second to represent, from 0 to 999,999,999

    • offsetSeconds: number

      timezone offset in seconds. Must be in [-64800, 64800] range.

    Returns OffsetDateTime

Static fromDate

  • Constructs a new instance from Date and offset seconds.

    Throws

    TypeError if a wrong type is passed as argument

    Throws

    RangeError if an invalid argument value is passed

    Parameters

    • date: Date

      must be a valid Date. date.getTime() should be not NaN

    • offsetSeconds: number

      Offset in seconds, must be between [-64800, 64800]

    Returns OffsetDateTime

Static fromString

  • Constructs a new instance from ISO 8601 string. The string format is yyyy-mm-ddTHH-mm-ss.SSS(Z | (+|-)HH:mm).

    Throws

    TypeError if passed value is not a string

    Throws

    RangeError if passed string is invalid

    Parameters

    • isoString: string

      ISO 8601 string with timezone. If timezone is omitted, UTC is assumed

    Returns OffsetDateTime

Settings

Member Visibility

Theme

Generated using TypeDoc