Time

A collection of functions to manipulate time (i.e timestamp)

Index

Bound

• maxValue
• minValue

Codec

• __decode__
• __encode__
• __schema__

Comparator

• !=
• ＜
• ＜=
• ==
• ＞
• ＞=
• clamp
• compare
• equals
• max
• min

Constructor

• __call__
• from
• of

Formatting

• asString

Numeric

• -
• +

Type

• __inspect__
• asInstance
• hasInstance
• unwrap
• wrap

Other

• typeName
• delay
• diff
• format
• now
• parse

Bound

readonlymaxValue

maxValue: Time

Maximum value for this type

const anyNumber: number
anyNumber < Number.maxValue // true

readonlyminValue

minValue: Time

Minimum value for this type

const anyNumber: number
anyNumber > Number.minValue // true

Codec

__decode__

• __decode__(this, input, context): Result<Time, CodecError>

• Returns the decoded input, Result.Ok or Result.Error()

  interface SomeObject {
    foo: string
  }
  const someCodec: Codec<SomeObject> = ...;
  const input: unknown = ...;
  const decoded = Codec.decode(someCodec, input);

__encode__

• __encode__(this, input): unknown

• Returns the encoded input

  interface SomeObject {
    foo: string
  }
  const someCodec: Codec<SomeObject> = ...;
  const someObject: SomeObject = { foo: "bar" }
  const encoded = Codec.decode(someCodec, someObject);

__schema__

• __schema__(this): JSONValue

• Returns the JSONSchema corresponding to the decoded type

  const someCodec: Codec<unknown> = ...;
  const jsonSchema = Codec.schema(someCodec);

Comparator

!=

• !=(this, left, right): boolean

• "Not equal to" operator

  const TEqual: Equal<T>;
  TEqual['!='](value, otherValue); // true
  TEqual['!='](value, value); // false

＜

• ＜(this, left, right): boolean

• "Less than" operator

  type T;
  const TCompare: Comparable<T>;
  const smallerT: T;
  const greaterT: T;
  TCompare['<'](smallerT, smallerT); // false
  TCompare['<'](smallerT, greaterT); // true
  TCompare['<'](greaterT, smallerT); // false

＜=

• ＜=(this, left, right): boolean

• "Less than or equal to" operator

  type T;
  const TCompare: Comparable<T>;
  const smallerT: T;
  const greaterT: T;
  TCompare['<='](smallerT, smallerT); // true
  TCompare['<='](smallerT, greaterT); // true
  TCompare['<='](greaterT, smallerT); // false

==

• ==(this, left, right): boolean

• "Equal to" operator

  type T = // ...
  const TEqual: Equal<T>;
  TEqual['=='](value, value); // true
  TEqual['=='](value, otherValue); // false

＞

• ＞(this, left, right): boolean

• "Greater than" operator

  type T;
  const TCompare: Comparable<T>;
  const smallerT: T;
  const greaterT: T;
  TCompare['>'](smallerT, smallerT); // false
  TCompare['>'](smallerT, greaterT); // false
  TCompare['>'](greaterT, smallerT); // true

＞=

• ＞=(this, left, right): boolean

• "Greater than or equal to" operator

  type T;
  const TCompare: Comparable<T>;
  const smallerT: T;
  const greaterT: T;
  TCompare['>='](smallerT, smallerT); // true
  TCompare['>='](smallerT, greaterT); // false
  TCompare['>='](greaterT, smallerT); // true

clamp

• clamp(this, value, minValue, maxValue): Time

• Clamp value between minValue and maxValue

  type T;
  const TCompare: Comparable<T>;
  TCompare.clamp(value, min, max); // min if value < min, max if value > max, otherwise value itself

compare

• compare(this, left, right): Ordering

• Return an Ordering that represents comparison result

  type T;
  const TCompare: Comparable<T>;
  const sorted = [3, 1, 1].sort(TCompare.compare);

  See more at Order

equals

• equals(this, left, right): boolean

• Alias to '=='

  type T = // ...
  const TEqual: Equal<T>;
  TEqual.equals(value, value); // true
  TEqual.equals(value, otherValue); // false

max

• max(this, left, right): Time

• "maximum" operator

  type T;
  const TCompare: Comparable<T>;
  const smallerT: T;
  const greaterT: T;
  TCompare.max(smallerT, greaterT); // greaterT

min

• min(this, left, right): Time

• "minimum" operator

  type T;
  const TCompare: Comparable<T>;
  const smallerT: T;
  const greaterT: T;
  TCompare.min(smallerT, greaterT); // smallerT

Constructor

__call__

• __call__(source): Time

• Converts a number or a TimeObject to a Time

  Time.from({ year: 2020, month: 1, day: 1, hour: 0, minute: 0, second: 0, millisecond: 0 });// new Date('2020-01-01T00:00:00.000Z').getTime()

from

• from(source): Time

• Converts a number or a TimeObject to a Time

  Time.from({ year: 2020, month: 1, day: 1, hour: 0, minute: 0, second: 0, millisecond: 0 });// new Date('2020-01-01T00:00:00.000Z').getTime()

of

• of(milliseconds): Time

• Create a new Time value

  const time = Time.of(0);

Formatting

asString

• asString(this, self): string

• Converts the given value to a String.

  Number.asString(123); // '123'

Numeric

-

• -(left, right): Time

• Subtraction operator

  type T = ...;
  const TNumeric: Numeric.Subtract<T> = ...;
  const result = Numeric['-'](left, right);// represents (left - right)

+

• +(left, right): Time

• Addition operator

  type T = ...;
  const TNumeric: Numeric.Add<T> = ...;
  const result = TNumeric['+'](left, right);// represents (left + right)

Type

__inspect__

__inspect__: Option<(anyValue, depth, options, inspect) => string>

When defined, returns a custom string representation. To be useful, it should be bound to a prototype (ex: Struct)

import { inspect } from 'node:util';

interface Foo {
  foo: boolean;
}
const Foo = Struct.define<Foo>({
  typeName: 'Foo',
  __inspect__: (self) => `Foo { ${String(self.foo)} }`,
});
const myStruct = Struct.create(Foo, { foo: true });// 'Foo { true }'
inspect(myStruct);// 'Foo { true }'

asInstance

• asInstance(this, anyValue): Option<Time>

• Try to convert anyValue to enum value or else returns Option.None

  const StringType: Type<string>;
  StringType.asInstance('foo'); // Option.Some('foo')
  StringType.asInstance(12); // Option.None

hasInstance

• hasInstance(this, anyValue): anyValue is Time

• Return true if the given value is an instance of the class.

  const StringType: Type<string>;
  StringType.hasInstance('foo'); // true
  StringType.hasInstance(42); // false

unwrap

• unwrap(value): number

• Convert a tagged value to the underlying type

wrap

• wrap(value): Time

• Convert an underlying type to a tagged type

Other

typeName

Re-exports typeName

delay

• delay(duration): Task<Time, never>

• Return a new Task that resolves the current time in milliseconds after waiting duration.

  const wait2s = Time.delay(TimeDuration({ seconds: 2 }));
  const logTime = Task.andThen(wait2s, (time) => Console.debug(time));
  Task.run(logTime);// wait 2 seconds then console.debug(Date.now())

diff

• diff(left, right): TimeDuration

• Return the difference between 2 time values

  const begin = Time.of(0);
  const end = Time.of(10);
  Time.diff(end, begin);// TimeDuration.of(10)

format

• format(self): string

• Return an ISO 8601 string representation

  const time = Time.of(0);
  Time.format(time);// '1970-01-01T00:00:00.000Z'

now

• now(): Task<Time, never>

• A task that resolves the current time in milliseconds.

  const program = () => Task.andThen(Time.now(), (currentTime) => {
    // use currentTime
  });

parse

• parse(expression): Option<Time>

• Parse an ISO 8601 string. If invalid, returns Option.None

  Time.parse('1970-01-01T00:00:00.000Z');// 0