Options
All
  • Public
  • Public/Protected
  • All
Menu

Class Timestamp

Represents a timestamp[1] value in an Ion stream.

[1] https://amazon-ion.github.io/ion-docs/docs/spec.html#timestamp

Hierarchy

  • __type<DateConstructor, this> & Date
    • Timestamp

Index

Constructors

Properties

Methods

Constructors

constructor

  • Constructor.

    Parameters

    • dateOrTimestamp: Timestamp | Date

      A Date or Timestamp to represent as a timestamp.

    • annotations: string[] = []

      An optional array of strings to associate with this timestamp.

    Returns Timestamp

Properties

_ionAnnotations

_ionAnnotations: string[]

_ionType

_ionType: IonType

Methods

[Symbol.toPrimitive]

  • [Symbol.toPrimitive](hint: "default"): string
  • [Symbol.toPrimitive](hint: "string"): string
  • [Symbol.toPrimitive](hint: "number"): number
  • [Symbol.toPrimitive](hint: string): PathElement

  • Converts a Date object to a string.

    Parameters

    • hint: "default"

    Returns string

  • Converts a Date object to a string.

    Parameters

    • hint: "string"

    Returns string

  • Converts a Date object to a number.

    Parameters

    • hint: "number"

    Returns number

  • Converts a Date object to a string or number.

    throws

    {TypeError} If 'hint' was given something other than "number", "string", or "default".

    Parameters

    • hint: string

      The strings "number", "string", or "default" to specify what primitive to return.

    Returns PathElement

    A number if 'hint' was "number", a string if 'hint' was "string" or "default".

_setAnnotations

  • _setAnnotations(annotations: string[]): void

  • Parameters

    • annotations: string[]

    Returns void

_unsupportedOperation

  • _unsupportedOperation<T>(functionName: string): never

  • Type parameters

    Parameters

    • functionName: string

    Returns never

_valueEquals

  • _valueEquals(other: any, options?: { epsilon?: null | number; ignoreAnnotations?: boolean; ignoreTimestampPrecision?: boolean; onlyCompareIon?: boolean }): boolean

  • Parameters

    • other: any
    • options: { epsilon?: null | number; ignoreAnnotations?: boolean; ignoreTimestampPrecision?: boolean; onlyCompareIon?: boolean } = ...
      • Optional epsilon?: null | number
      • Optional ignoreAnnotations?: boolean
      • Optional ignoreTimestampPrecision?: boolean
      • Optional onlyCompareIon?: boolean

    Returns boolean

allFields

  • allFields(): [string, Value[]][]

  • Returns [string, Value[]][]

as

bigIntValue

  • bigIntValue(): null | bigint

  • Returns null | bigint

booleanValue

  • booleanValue(): null | boolean

  • Returns null | boolean

dateValue

  • dateValue(): Date

  • Returns Date

decimalValue

deleteField

  • deleteField(name: string): boolean

  • Parameters

    • name: string

    Returns boolean

elements

equals

  • equals(other: any, options?: { epsilon?: null | number }): boolean

  • Implementation of the dom.Value interface method equals()

    Parameters

    • other: any
    • options: { epsilon?: null | number } = ...
      • Optional epsilon?: null | number

    Returns boolean

fieldNames

  • fieldNames(): string[]

  • Returns string[]

fields

  • fields(): [string, Value][]

  • Returns [string, Value][]

get

getAll

getAnnotations

  • getAnnotations(): string[]

  • Returns string[]

getDate

  • getDate(): number

  • Gets the day-of-the-month, using local time.

    Returns number

getDay

  • getDay(): number

  • Gets the day of the week, using local time.

    Returns number

getFullYear

  • getFullYear(): number

  • Gets the year, using local time.

    Returns number

getHours

  • getHours(): number

  • Gets the hours in a date, using local time.

    Returns number

getMilliseconds

  • getMilliseconds(): number

  • Gets the milliseconds of a Date, using local time.

    Returns number

getMinutes

  • getMinutes(): number

  • Gets the minutes of a Date object, using local time.

    Returns number

getMonth

  • getMonth(): number

  • Gets the month, using local time.

    Returns number

getSeconds

  • getSeconds(): number

  • Gets the seconds of a Date object, using local time.

    Returns number

getTime

  • getTime(): number

  • Gets the time value in milliseconds.

    Returns number

getTimezoneOffset

  • getTimezoneOffset(): number

  • Gets the difference in minutes between the time on the local computer and Universal Coordinated Time (UTC).

    Returns number

getType

getUTCDate

  • getUTCDate(): number

  • Gets the day-of-the-month, using Universal Coordinated Time (UTC).

    Returns number

getUTCDay

  • getUTCDay(): number

  • Gets the day of the week using Universal Coordinated Time (UTC).

    Returns number

getUTCFullYear

  • getUTCFullYear(): number

  • Gets the year using Universal Coordinated Time (UTC).

    Returns number

getUTCHours

  • getUTCHours(): number

  • Gets the hours value in a Date object using Universal Coordinated Time (UTC).

    Returns number

getUTCMilliseconds

  • getUTCMilliseconds(): number

  • Gets the milliseconds of a Date object using Universal Coordinated Time (UTC).

    Returns number

getUTCMinutes

  • getUTCMinutes(): number

  • Gets the minutes of a Date object using Universal Coordinated Time (UTC).

    Returns number

getUTCMonth

  • getUTCMonth(): number

  • Gets the month of a Date object using Universal Coordinated Time (UTC).

    Returns number

getUTCSeconds

  • getUTCSeconds(): number

  • Gets the seconds of a Date object using Universal Coordinated Time (UTC).

    Returns number

ionEquals

  • ionEquals(other: Value, options?: { epsilon?: null | number; ignoreAnnotations?: boolean; ignoreTimestampPrecision?: boolean }): boolean

  • Implementation of the dom.Value interface method ionEquals()

    Parameters

    • other: Value
    • options: { epsilon?: null | number; ignoreAnnotations?: boolean; ignoreTimestampPrecision?: boolean } = ...
      • Optional epsilon?: null | number
      • Optional ignoreAnnotations?: boolean
      • Optional ignoreTimestampPrecision?: boolean

    Returns boolean

isNull

  • isNull(): boolean

  • Returns boolean

numberValue

  • numberValue(): null | number

  • Returns null | number

setDate

  • setDate(date: number): number

  • Sets the numeric day-of-the-month value of the Date object using local time.

    Parameters

    • date: number

      A numeric value equal to the day of the month.

    Returns number

setFullYear

  • setFullYear(year: number, month?: number, date?: number): number

  • Sets the year of the Date object using local time.

    Parameters

    • year: number

      A numeric value for the year.

    • Optional month: number

      A zero-based numeric value for the month (0 for January, 11 for December). Must be specified if numDate is specified.

    • Optional date: number

      A numeric value equal for the day of the month.

    Returns number

setHours

  • setHours(hours: number, min?: number, sec?: number, ms?: number): number

  • Sets the hour value in the Date object using local time.

    Parameters

    • hours: number

      A numeric value equal to the hours value.

    • Optional min: number

      A numeric value equal to the minutes value.

    • Optional sec: number

      A numeric value equal to the seconds value.

    • Optional ms: number

      A numeric value equal to the milliseconds value.

    Returns number

setMilliseconds

  • setMilliseconds(ms: number): number

  • Sets the milliseconds value in the Date object using local time.

    Parameters

    • ms: number

      A numeric value equal to the millisecond value.

    Returns number

setMinutes

  • setMinutes(min: number, sec?: number, ms?: number): number

  • Sets the minutes value in the Date object using local time.

    Parameters

    • min: number

      A numeric value equal to the minutes value.

    • Optional sec: number

      A numeric value equal to the seconds value.

    • Optional ms: number

      A numeric value equal to the milliseconds value.

    Returns number

setMonth

  • setMonth(month: number, date?: number): number

  • Sets the month value in the Date object using local time.

    Parameters

    • month: number

      A numeric value equal to the month. The value for January is 0, and other month values follow consecutively.

    • Optional date: number

      A numeric value representing the day of the month. If this value is not supplied, the value from a call to the getDate method is used.

    Returns number

setSeconds

  • setSeconds(sec: number, ms?: number): number

  • Sets the seconds value in the Date object using local time.

    Parameters

    • sec: number

      A numeric value equal to the seconds value.

    • Optional ms: number

      A numeric value equal to the milliseconds value.

    Returns number

setTime

  • setTime(time: number): number

  • Sets the date and time value in the Date object.

    Parameters

    • time: number

      A numeric value representing the number of elapsed milliseconds since midnight, January 1, 1970 GMT.

    Returns number

setUTCDate

  • setUTCDate(date: number): number

  • Sets the numeric day of the month in the Date object using Universal Coordinated Time (UTC).

    Parameters

    • date: number

      A numeric value equal to the day of the month.

    Returns number

setUTCFullYear

  • setUTCFullYear(year: number, month?: number, date?: number): number

  • Sets the year value in the Date object using Universal Coordinated Time (UTC).

    Parameters

    • year: number

      A numeric value equal to the year.

    • Optional month: number

      A numeric value equal to the month. The value for January is 0, and other month values follow consecutively. Must be supplied if numDate is supplied.

    • Optional date: number

      A numeric value equal to the day of the month.

    Returns number

setUTCHours

  • setUTCHours(hours: number, min?: number, sec?: number, ms?: number): number

  • Sets the hours value in the Date object using Universal Coordinated Time (UTC).

    Parameters

    • hours: number

      A numeric value equal to the hours value.

    • Optional min: number

      A numeric value equal to the minutes value.

    • Optional sec: number

      A numeric value equal to the seconds value.

    • Optional ms: number

      A numeric value equal to the milliseconds value.

    Returns number

setUTCMilliseconds

  • setUTCMilliseconds(ms: number): number

  • Sets the milliseconds value in the Date object using Universal Coordinated Time (UTC).

    Parameters

    • ms: number

      A numeric value equal to the millisecond value.

    Returns number

setUTCMinutes

  • setUTCMinutes(min: number, sec?: number, ms?: number): number

  • Sets the minutes value in the Date object using Universal Coordinated Time (UTC).

    Parameters

    • min: number

      A numeric value equal to the minutes value.

    • Optional sec: number

      A numeric value equal to the seconds value.

    • Optional ms: number

      A numeric value equal to the milliseconds value.

    Returns number

setUTCMonth

  • setUTCMonth(month: number, date?: number): number

  • Sets the month value in the Date object using Universal Coordinated Time (UTC).

    Parameters

    • month: number

      A numeric value equal to the month. The value for January is 0, and other month values follow consecutively.

    • Optional date: number

      A numeric value representing the day of the month. If it is not supplied, the value from a call to the getUTCDate method is used.

    Returns number

setUTCSeconds

  • setUTCSeconds(sec: number, ms?: number): number

  • Sets the seconds value in the Date object using Universal Coordinated Time (UTC).

    Parameters

    • sec: number

      A numeric value equal to the seconds value.

    • Optional ms: number

      A numeric value equal to the milliseconds value.

    Returns number

stringValue

  • stringValue(): null | string

  • Returns null | string

timestampValue

toDateString

  • toDateString(): string

  • Returns a date as a string value.

    Returns string

toISOString

  • toISOString(): string

  • Returns a date as a string value in ISO format.

    Returns string

toJSON

  • toJSON(key?: any): string

  • Used by the JSON.stringify method to enable the transformation of an object's data for JavaScript Object Notation (JSON) serialization.

    Parameters

    • Optional key: any

    Returns string

toLocaleDateString

  • toLocaleDateString(): string
  • toLocaleDateString(locales?: string | string[], options?: DateTimeFormatOptions): string

  • Returns a date as a string value appropriate to the host environment's current locale.

    Returns string

  • Converts a date to a string by using the current or specified locale.

    Parameters

    • Optional locales: string | string[]

      A locale string or array of locale strings that contain one or more language or locale tags. If you include more than one locale string, list them in descending order of priority so that the first entry is the preferred locale. If you omit this parameter, the default locale of the JavaScript runtime is used.

    • Optional options: DateTimeFormatOptions

      An object that contains one or more properties that specify comparison options.

    Returns string

toLocaleString

  • toLocaleString(): string
  • toLocaleString(locales?: string | string[], options?: DateTimeFormatOptions): string

  • Returns a date converted to a string using the current locale.

    Returns string

  • Returns a value as a string value appropriate to the host environment's current locale.

    Parameters

    • Optional locales: string | string[]
    • Optional options: DateTimeFormatOptions

    Returns string

toLocaleTimeString

  • toLocaleTimeString(): string
  • toLocaleTimeString(locales?: string | string[], options?: DateTimeFormatOptions): string

  • Returns a time as a string value appropriate to the host environment's current locale.

    Returns string

  • Converts a time to a string by using the current or specified locale.

    Parameters

    • Optional locales: string | string[]

      A locale string or array of locale strings that contain one or more language or locale tags. If you include more than one locale string, list them in descending order of priority so that the first entry is the preferred locale. If you omit this parameter, the default locale of the JavaScript runtime is used.

    • Optional options: DateTimeFormatOptions

      An object that contains one or more properties that specify comparison options.

    Returns string

toString

  • toString(): string

  • Returns a string representation of an object.

    Returns string

toTimeString

  • toTimeString(): string

  • Returns a time as a string value.

    Returns string

toUTCString

  • toUTCString(): string

  • Returns a date converted to a string using Universal Coordinated Time (UTC).

    Returns string

uInt8ArrayValue

  • uInt8ArrayValue(): null | Uint8Array

  • Returns null | Uint8Array

valueOf

  • valueOf(): Object
  • valueOf(): number

  • Returns the primitive value of the specified object.

    Returns Object

  • Returns the stored time value in milliseconds since midnight, January 1, 1970 UTC.

    Returns number

writeTo

  • writeTo(writer: Writer): void

Static UTC

  • UTC(year: number, month: number, date?: number, hours?: number, minutes?: number, seconds?: number, ms?: number): number

  • Returns the number of milliseconds between midnight, January 1, 1970 Universal Coordinated Time (UTC) (or GMT) and the specified date.

    Parameters

    • year: number

      The full year designation is required for cross-century date accuracy. If year is between 0 and 99 is used, then year is assumed to be 1900 + year.

    • month: number

      The month as a number between 0 and 11 (January to December).

    • Optional date: number

      The date as a number between 1 and 31.

    • Optional hours: number

      Must be supplied if minutes is supplied. A number from 0 to 23 (midnight to 11pm) that specifies the hour.

    • Optional minutes: number

      Must be supplied if seconds is supplied. A number from 0 to 59 that specifies the minutes.

    • Optional seconds: number

      Must be supplied if milliseconds is supplied. A number from 0 to 59 that specifies the seconds.

    • Optional ms: number

      A number from 0 to 999 that specifies the milliseconds.

    Returns number

Static _fromJsValue

  • _fromJsValue(jsValue: any, annotations: string[]): Value

  • Parameters

    • jsValue: any
    • annotations: string[]

    Returns Value

Static _getIonType

Static now

  • now(): number

  • Returns number

Static parse

  • parse(s: string): number

  • Parses a string containing a date, and returns the number of milliseconds between that date and midnight, January 1, 1970.

    Parameters

    • s: string

      A date string

    Returns number