feedback: datetime_object | Tarantool

[TarantoolBot]

<…>

|datetime_object|

object datetime_object
Since 2.10.0.

datetime_object:totab<…>

https://www.tarantool.io/en/doc/latest/reference/reference_lua/datetime/datetime_object/#datetime-obj

Incomplete documentation. missing .timestamp field, and comparission methods

[ligurio]

Tarantool version: commit hash 93fb2363cb45dc47a94eb221d5904b8b823e614d

Regarding timestamp field

timestamp field is missed in a table produced by :totable:

tarantool> datetime.new(v):totable()
---
- sec: 0
  min: 0
  yday: 214
  day: 1
  nsec: 0
  isdst: false
  wday: 5
  tzoffset: 0
  month: 8
  year: 2024
  hour: 0
...

tarantool> datetime.new(v).timestamp
---
- 1722470400
...

However, this field is available as a property of datetime object. Before fixing doc this should be fixed (or not) in Tarantool itself (see tarantool/tarantool#10374).

Regarding comparison operators

it is possible to use comparison operators with datetime objects:

tarantool> d1 = datetime.new(v)
---
...

tarantool> d2 = datetime.new(v)
---
...

tarantool> d1 == d2
---
- true
...

tarantool> d1 ~= d2
---
- false
...

tarantool> d1 >= d2
---
- true
...

tarantool> d1 < d2
---
- false
...

tarantool> 

These operators were supported from the beginning (see commit tarantool/tarantool@43e10ed) and documented in scope of issue #2411. However, comparison operators were missed in a doc request. Let's fix this here.

Updated (06.08.2024): add a reference to tarantool/tarantool#10374

[ligurio]

Incomplete documentation. missing .timestamp field, and comparission methods

• timestamp in :totable() will be documented in scope of separate doc request after fixing Field timestamp is missed in a table produced by <datetetime>:totable() tarantool#10374
• this PR datetime: describe relational operators #4413 will fix comparison operators