Zen

Source string Source string

1105/10000 · 1105
English Actions
Day number. Value range: 1 - 31. The special value ``-1`` generates the last day of a particular month (see :ref:`example below <datetime-new-example>`).
1
month
Month number. Value range: 1 - 12.
year
Year.
1970
timestamp
Timestamp, in seconds. Similar to the Unix timestamp, but can have a fractional part which is converted in nanoseconds in the resulting ``datetime`` object. If the fractional part for the last second is set via the ``nsec``, ``usec``, or ``msec`` units, the timestamp value should be integer otherwise an error occurs. Timestamp is not allowed if you already set time and/or date via specific units, namely, ``sec``, ``min``, ``hour``, ``day``, ``month``, and ``year``.
tzoffset
Time zone offset from UTC, in minutes. If both ``tzoffset`` and ``tz`` are specified, ``tz`` has the preference and the ``tzoffset`` value is ignored.
tz
Time zone name according to the `tz database <https://en.wikipedia.org/wiki/Tz_database>`__.
string
**Examples:**
tarantool> datetime.new {
nsec = 123456789,

sec = 20,
min = 25,
hour = 18,

day = 20,
month = 8,
year = 2021,

tzoffset = 180
}
---
- 2021-08-20T18:25:20.123456789+0300
...

tarantool> datetime.new {
nsec = 123456789,

sec = 20,
min = 25,
hour = 18,

day = 20,
month = 8,
year = 2021,

tzoffset = 60,
tz = 'Europe/Moscow'
}
---
- 2021-08-20T18:25:20.123456789 Europe/Moscow
...

tarantool> datetime.new {
day = -1,
month = 2,
year = 2021,
}
---
- 2021-02-28T00:00:00Z
...

tarantool> datetime.new {
timestamp = 1656664205.123,
tz = 'Europe/Moscow'
}
---
- 2022-07-01T08:30:05.122999906 Europe/Moscow
...

tarantool> datetime.new {
nsec = 123,
timestamp = 1656664205,
tz = 'Europe/Moscow'
}
---
- 2022-07-01T08:30:05.000000123 Europe/Moscow
...

Loading…

User avatar None

New source string

testing_project / Documentation: reference/reference_lua/datetime/new — English

tarantool> datetime.new {
nsec = 123456789,

sec = 20,
min = 25,
hour = 18,

day = 20,
month = 8,
year = 2021,

tzoffset = 180
}
---
- 2021-08-20T18:25:20.123456789+0300
...

tarantool> datetime.new {
nsec = 123456789,

sec = 20,
min = 25,
hour = 18,

day = 20,
month = 8,
year = 2021,

tzoffset = 60,
tz = 'Europe/Moscow'
}
---
- 2021-08-20T18:25:20.123456789 Europe/Moscow
...

tarantool> datetime.new {
day = -1,
month = 2,
year = 2021,
}
---
- 2021-02-28T00:00:00Z
...

tarantool> datetime.new {
timestamp = 1656664205.123,
tz = 'Europe/Moscow'
}
---
- 2022-07-01T08:30:05.122999906 Europe/Moscow
...

tarantool> datetime.new {
nsec = 123,
timestamp = 1656664205,
tz = 'Europe/Moscow'
}
---
- 2022-07-01T08:30:05.000000123 Europe/Moscow
...
a year ago
Browse all string changes

Things to check

Ellipsis

The string uses three dots (...) instead of an ellipsis character (…)

Reset

Glossary

English English
No related strings found in the glossary.

String information

Flags
read-only
String age
a year ago
Last updated
a year ago
Source string age
a year ago
Translation file
string 41