Class: DateSet

Defined in: core/types/collections/time/DateSet.ts:28

An ordered set of distinct calendar dates.

Dates are represented as DateADT integers (days since 2000-01-01).

Example

const s = DateSet.fromString('{2020-01-01, 2020-06-15, 2020-12-31}');
console.log(s.numValues());  // 3
console.log(s.startValue()); // days since 2000-01-01
s.free();

Extends

MeosSet<DateADT>

Constructors

Constructor

new DateSet(inner): DateSet;

Defined in: core/types/collections/base/MeosSet.ts:46

Parameters

inner

number

Returns

DateSet

Inherited from

MeosSet.constructor

Accessors

inner

Get Signature

get inner(): number;

Defined in: core/types/collections/base/MeosSet.ts:58

Raw WASM heap pointer. Do not free this value directly; use free.

Returns

number

Inherited from

MeosSet.inner

Methods

[dispose]()

dispose: void;

Defined in: core/types/collections/base/MeosSet.ts:68

Implements the using resource-management protocol — calls free automatically.

Returns

void

Inherited from

MeosSet.[dispose]

asHexWKB()

asHexWKB(variant?): string;

Defined in: core/types/collections/base/MeosSet.ts:91

Serialises this set to a hex-encoded WKB string.

Parameters

variant?

number = 4

WKB encoding variant (default 4 = Extended WKB).

Returns

string

Inherited from

MeosSet.asHexWKB

contains()

contains(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:147

true if this contains every element of other.

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.contains

copy()

copy(): this;

Defined in: core/types/collections/base/MeosSet.ts:76

Returns a deep copy of this set. The caller is responsible for calling free on the returned copy.

Returns

this

Inherited from

MeosSet.copy

distance()

distance(other): number;

Defined in: core/types/collections/time/DateSet.ts:92

Returns the distance (gap) between this and other in days. Returns 0 if they share at least one date.

Parameters

other

DateSet

Returns

number

Overrides

MeosSet.distance

endValue()

endValue(): number;

Defined in: core/types/collections/time/DateSet.ts:72

Returns the latest date in this set as days since 2000-01-01.

Returns

number

Overrides

MeosSet.endValue

eq()

eq(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:232

true if this and other contain the same elements.

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.eq

free()

free(): void;

Defined in: core/types/collections/base/MeosSet.ts:63

Releases the WASM-allocated memory. Must be called when the object is no longer needed.

Returns

void

Inherited from

MeosSet.free

ge()

ge(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:257

true if this is greater than or equal to other in MEOS total ordering.

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.ge

gt()

gt(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:252

true if this is strictly greater than other in MEOS total ordering.

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.gt

hash()

hash(): number;

Defined in: core/types/collections/base/MeosSet.ts:105

32-bit integer hash of this set.

Returns

number

Inherited from

MeosSet.hash

intersection()

intersection(other): DateSet | null;

Defined in: core/types/collections/base/MeosSet.ts:205

Returns the intersection of this and other, or null if they are disjoint. The caller is responsible for calling free on the result.

Parameters

other

this

Returns

DateSet | null

Inherited from

MeosSet.intersection

isAfter()

isAfter(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:174

true if every element of this is strictly greater than every element of other.

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.isAfter

isBefore()

isBefore(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:161

true if every element of this is strictly less than every element of other.

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.isBefore

isContainedIn()

isContainedIn(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:142

true if this is entirely contained within other (every element of this is in other).

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.isContainedIn

isOverOrAfter()

isOverOrAfter(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:182

true if this does not extend to the left of other (i.e. min(this) ≥ min(other)).

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.isOverOrAfter

isOverOrBefore()

isOverOrBefore(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:169

true if this does not extend to the right of other (i.e. max(this) ≤ max(other)).

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.isOverOrBefore

le()

le(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:247

true if this is less than or equal to other in MEOS total ordering.

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.le

lt()

lt(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:242

true if this is strictly less than other in MEOS total ordering.

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.lt

minus()

minus(other): DateSet | null;

Defined in: core/types/collections/base/MeosSet.ts:214

Returns the part of this not in other, or null if the result is empty. The caller is responsible for calling free on the result.

Parameters

other

this

Returns

DateSet | null

Inherited from

MeosSet.minus

ne()

ne(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:237

true if this and other differ in at least one element.

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.ne

numValues()

numValues(): number;

Defined in: core/types/collections/base/MeosSet.ts:100

Number of elements in this set.

Returns

number

Inherited from

MeosSet.numValues

overlaps()

overlaps(other): boolean;

Defined in: core/types/collections/base/MeosSet.ts:152

true if this and other share at least one element.

Parameters

other

this

Returns

boolean

Inherited from

MeosSet.overlaps

shiftScale()

shiftScale(
   shift, 
   width, 
   hasShift?, 
   hasWidth?): DateSet;

Defined in: core/types/collections/time/DateSet.ts:115

Returns a new set shifted and/or scaled along the date axis.

Parameters

shift

number

Number of days to shift (ignored when hasShift is false).

width

number

New total width in days (ignored when hasWidth is false).

hasShift?

boolean = true

Set to false to skip shifting (default true).

hasWidth?

boolean = true

Set to false to skip scaling (default true).

Returns

DateSet

startValue()

startValue(): number;

Defined in: core/types/collections/time/DateSet.ts:67

Returns the earliest date in this set as days since 2000-01-01.

Returns

number

Overrides

MeosSet.startValue

toSpan()

toSpan(): number;

Defined in: core/types/collections/base/MeosSet.ts:113

Returns the bounding span of this set as a raw WASM pointer. Use the appropriate Span constructor to obtain a typed object.

Returns

number

Inherited from

MeosSet.toSpan

toSpanSet()

toSpanSet(): number;

Defined in: core/types/collections/base/MeosSet.ts:121

Returns this set converted to a SpanSet as a raw WASM pointer. Use the appropriate SpanSet constructor to obtain a typed object.

Returns

number

Inherited from

MeosSet.toSpanSet

toString()

toString(): string;

Defined in: core/types/collections/time/DateSet.ts:58

Returns the WKT string representation (e.g. {2020-01-01, 2020-06-15}).

Returns

string

Overrides

MeosSet.toString

toTsTzSet()

toTsTzSet(): number;

Defined in: core/types/collections/time/DateSet.ts:104

Converts each date to a timestamp at midnight UTC and returns the raw WASM pointer. Use new TsTzSet(ptr) to obtain a typed object.

Returns

number

union()

union(other): this;

Defined in: core/types/collections/base/MeosSet.ts:223

Returns the union of this and other. The caller is responsible for calling free on the result.

Parameters

other

this

Returns

this

Inherited from

MeosSet.union

valueN()

valueN(n): number;

Defined in: core/types/collections/time/DateSet.ts:80

Returns the n-th date (0-based index) as days since 2000-01-01.

Parameters

n

number

0-based index (MEOS internally uses 1-based indexing).

Returns

number

Overrides

MeosSet.valueN

fromHexWKB()

static fromHexWKB(hexwkb): DateSet;

Defined in: core/types/collections/time/DateSet.ts:49

Deserialises a DateSet from a hex-encoded WKB string produced by asHexWKB.

Parameters

hexwkb

string

Hex-encoded WKB string.

Returns

DateSet

fromString()

static fromString(str): DateSet;

Defined in: core/types/collections/time/DateSet.ts:41

Parses a DateSet from its WKT string representation.

Parameters

str

string

WKT string, e.g. "{2020-01-01, 2020-06-15, 2020-12-31}".

Returns

DateSet

Class: DateSet ​

Example ​

Extends ​

Constructors ​

Constructor ​

Parameters ​

inner ​

Returns ​

Inherited from ​

Accessors ​

inner ​

Get Signature ​

Returns ​

Inherited from ​

Methods ​

[dispose]() ​

Returns ​

Inherited from ​

asHexWKB() ​

Parameters ​

variant? ​

Returns ​

Inherited from ​

contains() ​

Parameters ​

other ​

Returns ​

Inherited from ​

copy() ​

Returns ​

Inherited from ​

distance() ​

Parameters ​

other ​

Returns ​

Overrides ​

endValue() ​

Returns ​

Overrides ​

eq() ​

Parameters ​

other ​

Returns ​

Inherited from ​

free() ​

Returns ​

Inherited from ​

ge() ​

Parameters ​

other ​

Returns ​

Inherited from ​

gt() ​

Parameters ​

other ​

Returns ​

Inherited from ​

hash() ​

Returns ​

Inherited from ​

intersection() ​

Parameters ​

other ​

Returns ​

Inherited from ​

isAfter() ​

Parameters ​

other ​

Returns ​

Inherited from ​

isBefore() ​

Parameters ​

other ​

Returns ​

Inherited from ​

isContainedIn() ​

Parameters ​

other ​

Returns ​

Inherited from ​

Class: DateSet

Example

Extends

Constructors

Constructor

Parameters

inner

Returns

Inherited from

Accessors

inner

Get Signature

Returns

Inherited from

Methods

[dispose]()

Returns

Inherited from

asHexWKB()

Parameters

variant?

Returns

Inherited from

contains()

Parameters

other

Returns

Inherited from

copy()

Returns

Inherited from

distance()

Parameters

other

Returns

Overrides

endValue()

Returns

Overrides

eq()

Parameters

other

Returns

Inherited from

free()

Returns

Inherited from

ge()

Parameters

other

Returns

Inherited from

gt()

Parameters

other

Returns

Inherited from

hash()

Returns

Inherited from

intersection()

Parameters

other

Returns

Inherited from

isAfter()

Parameters

other

Returns

Inherited from

isBefore()

Parameters

other

Returns

Inherited from

isContainedIn()

Parameters

other

Returns

Inherited from