Date/Time

sections in this chapter:
[ Moment ] wait: [ Number ]
[ Moment ] zone: [ String ]
[ Moment ] zone
[ Moment ] year: [ Number ]
[ Moment ] month: [ Number ]
[ Moment ] day: [ Number ]
[ Moment ] hour: [ Number ]
[ Moment ] minute: [ Number ]
[ Moment ] second: [ Number ]
[ Moment ] year
[ Moment ] month
[ Moment ] day
[ Moment ] hour
[ Moment ] minute
[ Moment ] second
[ Moment ] yearday
[ Moment ] weekday
[ Moment ] time
[ Moment ] copy
[ Moment ] = [ Moment ]
[ Moment ] ≠ [ Moment ]
[ Moment ] week
[ Moment ] format: [ String ]
[ Moment ] string
[ Moment ] iso-datetime
[ Moment ] number
[ Moment ] add: [ Number ]
[ Moment ] subtract: [ Number ]
[ Moment ] new

For a structured representation of time and date, Xoscript uses the Moment object. In case a new Moment object is printed on screen, the current date and time are shown:

Out write: Moment new, stop.

Might result in something like:

2020-10-10 12:16:39

It is also easy to read out the individual time components. So, for instance, if it is only necessary to know the current year, the message year can be sent to the moment and, in turn, the reply will be a Number object containing solely the year:

>> m := Moment new.
Out write: m year, stop.

[ Moment ] wait: [ Number ]

Example:

>> time := Moment new time.
Moment wait: 1.
>> time2 := Moment new time.
(time2 > time) true: { Out write: ['T1 < T2']. }.

Result:

T1 < T2

[ Moment ] zone: [ String ]

Example:

#Linux
>> t := Moment new.
t zone: ['Europe/Amsterdam'].
t year: 2020, month: 8, day: 2, hour: 21, minute: 2, second: 1.
>> a := t hour.
>> ams := t zone.
t zone: ['US/Hawaii'].
>> b := t hour.
>> hw := t zone.
Out
write: (
['It's diff in zone2 than in zone1']
zone1: ams,
zone2: hw,
diff: (
(b > a)
either: ['later'] or: ['earlier']
)
),
stop.

Result:

It's earlier in US/Hawaii than in Europe/Amsterdam

[ Moment ] zone

Example:

# Linux
Out write: Moment zone, stop.

Result:

UTC

[ Moment ] year: [ Number ]

Example:

>> x := Moment new.
x zone: ['UTC'].
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] month: [ Number ]

Example:

>> x := Moment new.
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] day: [ Number ]

Example:

>> x := Moment new.
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] hour: [ Number ]

Example:

>> x := Moment new.
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] minute: [ Number ]

Example:

>> x := Moment new.
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] second: [ Number ]

Example:

>> x := Moment new.
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] year

Example:

>> x := Moment new.
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] month

Example:

>> x := Moment new.
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] day

Example:

>> x := Moment new.
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] hour

Example:

>> x := Moment new.
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] minute

Example:

>> x := Moment new.
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] second

Example:

>> x := Moment new.
x year: 2020.
x month: 8.
x day: 12.
x hour: 10.
x minute: 2.
x second: 1.
Out write: x year.
Out write: x month.
Out write: x day.
Out write: x hour.
Out write: x minute.
Out write: x second.

Result:

20208121021

[ Moment ] yearday

Example:

>> t := Moment new
year: 2020,
month: 1,
day: 2.
Out write: t yearday, stop.

Result:

1

[ Moment ] weekday

Example:

>> t := Moment new
year: 2020,
month: 1,
day: 2.
Out write: t weekday, stop.

Result:

5

[ Moment ] time

Example:

>> t := Moment new
year: 2020,
month: 1,
day: 2.
Out write: t time, stop.

Result:

1577923200

[ Moment ] copy

Example:

>> t := Moment new
year: 2020,
month: 1,
day: 2,
hour: 10,
minute: 0,
second: 1.
Out write: t, stop.
>> t2 := t copy.
Out write: t2, stop.

Result:

2020-01-02 10:00:01
2020-01-02 10:00:01

[ Moment ] = [ Moment ]

Example:

>> m := Moment new year: 2070, month: 11, day: 1.
>> n := m copy.
Out write: (m = n), stop.
Out write: (m ≠ n), stop.
Out write: (m equals: m), stop.
Out write: (m equals: n), stop.
n month: 12.
Out write: (m ≠ n), stop.
Out write: (m = n), stop.

Result:

True
False
True
False
True
False

[ Moment ] ≠ [ Moment ]

Example:

>> m := Moment new year: 2070, month: 11, day: 1.
>> n := m copy.
Out write: (m = n), stop.
Out write: (m ≠ n), stop.
Out write: (m equals: m), stop.
Out write: (m equals: n), stop.
n month: 12.
Out write: (m ≠ n), stop.
Out write: (m = n), stop.

Result:

True
False
True
False
True
False

[ Moment ] week

Example:

>> t := Moment new
year: 2020,
month: 1,
day: 2,
hour: 10,
minute: 0,
second: 1.
Out write: t, stop.
Out write: t week, stop.

Result:

2020-01-02 10:00:01
0

[ Moment ] format: [ String ]

Example:

>> x := Moment new
year: 1981,
month: 1,
day: 5.
Out write: (x  format: ['%a, %d %b %Y %H:%M:%S']), stop.

Result:

Mon, 05 Jan 1981 00:00:00

[ Moment ] string

Example:

>> t := Moment new
year: 2020,
month: 1,
day: 2,
hour: 10,
minute: 0,
second: 1.
Out write: t, stop.
Out write: t string, stop.

Result:

2020-01-02 10:00:01
2020-01-02 10:00:01

[ Moment ] iso-datetime

Example:

# build a moment
>> t := Moment new
zone: ['CET'],
year: 1990,
month: 1,
day: 2,
hour: 10,
minute: 11,
second: 12.
# print the moment as YYYY-MM-DD HH:II:SS
Out write: t iso-datetime, stop.

Result:

1990-01-02 10:11:12

[ Moment ] number

Example:

>> t := Moment new
year: 2020,
month: 1,
day: 2,
hour: 10,
minute: 0,
second: 1.
Out write: t, stop.
Out write: t number, stop.

Result:

2020-01-02 10:00:01
1577959201

[ Moment ] add: [ Number ]

Example:

 >> x := Moment new
year: 2020,
month: 1,
day: 2,
hour: 10,
minute: 0,
second: 1.
Out write: x, stop.
x add: 6 second.
Out write: x, stop.
x add: 5 minute.
Out write: x, stop.
x add: 4 hour.
Out write: x, stop.
x add: 3 day.
Out write: x, stop.
x add: 2 month.
Out write: x, stop.
x add: 1 year.
Out write: x, stop.

Result:

2020-01-02 10:00:01
2020-01-02 10:00:07
2020-01-02 10:05:07
2020-01-02 14:05:07
2020-01-05 14:05:07
2020-03-05 14:05:07
2021-03-05 14:05:07

[ Moment ] subtract: [ Number ]

Example:

 >> x := Moment new
year: 2020,
month: 1,
day: 2,
hour: 10,
minute: 0,
second: 1.
Out write: x, stop.
x subtract: 6 second.
Out write: x, stop.
x subtract: 5 minute.
Out write: x, stop.
x subtract: 4 hour.
Out write: x, stop.
x subtract: 3 day.
Out write: x, stop.
x subtract: 2 month.
Out write: x, stop.
x subtract: 1 year.
Out write: x, stop.

Result:

2020-01-02 10:00:01
2020-01-02 09:59:55
2020-01-02 09:54:55
2020-01-02 05:54:55
2019-12-30 05:54:55
2019-10-30 05:54:55
2018-10-30 05:54:55

[ Moment ] new

Example:

>> t := None.
# you can control the time zone for
# parsing like this:
Moment zone: ['CET'].
t := Moment from: ['1981-02-03 04:05:06'].
Out write: t, stop.
# now using CEST time zone:
Moment zone: ['CEST'].
t := Moment from: ['1981-02-03 04:05:06'].
Out write: t, stop.
# error if string cannot be parsed
{ Moment from: ['1900']. } except: { None. }, start.

Result:

1981-02-03 03:05:06
1981-02-03 04:05:06