Multi Theft Auto: Wiki - User contributions [en]

GetRealTime

2021-04-16T17:11:56Z

RIGZI: /* Example */

__NOTOC__
{{Server client function}}
This function gets the server or client (if used client sided it returns time as set on client's computer) real time and returns it in a table. If you want to get the in-game time (shown on GTA's clock) use [[getTime]].

==Syntax==
<syntaxhighlight lang="lua">table getRealTime( [ int seconds = current, bool localTime = true ] )</syntaxhighlight>

===Optional Arguments===
*'''seconds:''' A count in seconds from the year 1970. Useful for storing points in time, or for retrieving time information for [[getBanTime]]. The valid range of this argument is 0 to 32,000,000,000
{{New feature/item|3.0141|1.4.1|6976|
*'''localTime:''' Set to ''true'' to adjust for the locally set timezone.
}}

===Returns===
Returns a ''table'' of substrings with different time format or ''false'' if the '''seconds''' argument is out of range.

{| border="2" cellpadding="2" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 95%;"
|'''Member'''
|'''Meaning'''
|'''Range'''
|-
|second
|seconds after the minute
|0-61*
|-
|minute
|minutes after the hour
|0-59
|-
|hour
|hours since midnight
|0-23
|-
|monthday
|day of the month
|1-31
|-
|month
|months since January
|0-11
|-
|year
|years since 1900
|-
|weekday
|days since Sunday
|0-6
|-
|yearday
|days since January 1
|0-365
|-
|isdst
|Daylight Saving Time flag
|-
|timestamp
|seconds since 1970 (Ignoring set timezone)
|
|}
''* second'' is generally 0-59. Extra range to accommodate for leap seconds in certain systems.

==Example==
This example adds 'showtime' like the default MTA 'time' command:
<syntaxhighlight lang="lua">
function showtime ()
local time = getRealTime()
local hours = time.hour
local minutes = time.minute
local seconds = time.second
-- Make sure to add a 0 to the front of single digits.
if (hours < 10) then
hours = "0"..hours
end
if (minutes < 10) then
minutes = "0"..minutes
end
if (seconds < 10) then
seconds = "0"..seconds
end
outputChatBox ( "Local Time: "..hours..":"..minutes..":"..seconds )
end
addCommandHandler("showtime", showtime)
</syntaxhighlight>

Example with year, month, monthday using string.format:
<syntaxhighlight lang="lua">
function showtime ()
local time = getRealTime()
local hours = time.hour
local minutes = time.minute
local seconds = time.second

local monthday = time.monthday
local month = time.month
local year = time.year

local formattedTime = string.format("%04d-%02d-%02d %02d:%02d:%02d", year + 1900, month + 1, monthday, hours, minutes, seconds)
outputChatBox ( "Local Time: ".. formattedTime )
end
addCommandHandler("showtime", showtime)
</syntaxhighlight>

==Example==
Time report from 2020
<syntaxhighlight lang="lua">
function func_get_timestamp_server()
local second = getRealTime().timestamp
local day = math.ceil(tonumber((second / 86400) - 18250))
local hour = math.ceil(tonumber(day * 24))
return day, hour
end
</syntaxhighlight>

By RIGZI

==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.4.0-9.06976|Added localTime argument}}

==See Also==
{{Utility functions}}
[[ru:getRealTime]]

GetRealTime

2021-04-16T17:10:55Z

RIGZI: /* Example */

GetRealTime

2021-04-16T17:09:41Z

RIGZI: /* Example */

RU/getRealTime

2021-04-16T17:06:30Z

RIGZI: /* Пример */

__NOTOC__
{{RU/Server client function}}
Эта функция получает реальное время клиента либо сервера (Если используется на клиентской стороне, то он возвращает время, установленное на компьютере клиента) и возвращает его в таблицу. Если вы хотите получить внутриигровое время (Показанное на часах в GTA) используйте [[getTime]].

==Синтаксис==
<syntaxhighlight lang="lua">table getRealTime( [int seconds = current] )</syntaxhighlight>

===Необязательные аргументы===
{{OptionalArg}}
{{New feature/item|3|1.0||
*'''seconds:''' Количество секунд от 1 января 1970 года (начала Unix эпохи). Полезен для использования в [[getBanTime]]. Правильные значения: от 0 до 32,000,000,000
}}

===Возвращаемые значения===
Возвращает ''таблицу'' подстрок в различных форматах, либо булев ''false'' если параметр '''seconds''' имеет неправильное значение.

{| border="2" cellpadding="2" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 95%;"
|'''Member'''
|'''Meaning'''
|'''Range'''
|-
|second
|секунда внутри минуты
|0-61*
|-
|minute
|минута внутри часа
|0-59
|-
|hour
|час с полуночи
|0-23
|-
|monthday
|день в месяце
|1-31
|-
|month
|месяцы, начиная с Января (который 0)
|0-11
|-
|year
|годы начиная с 1900
|-
|weekday
|дни, начиная с Воскресенья
|0-6
|-
|yearday
|дни, начиная с 1 января (которое 0)
|0-365
|-
|isdst
|Daylight Saving Time flag
|-
|timestamp
|секунды с 1 января 1970 (MTA 1.1 +)
|
|}
* tm_sec is generally 0-59. Extra range to accommodate for leap seconds in certain systems.

==Пример==
Этот пример выведет локальное время (сервера или клиента в зависимости, откуда будет вызвано) в часах и минутах.
<syntaxhighlight lang="lua">
function showtime ()
local time = getRealTime() -- в таблице time записываем реальное время
local hours = time.hour -- в переменную hours записываем количество часов
local minutes = time.minute -- а в minutes минут
outputChatBox ( "Local Time: "..hours..":"..minutes ) -- и выводим игроку
end
</syntaxhighlight>

==Пример==
Этот пример выведет сколько дней и часов прошло с 2020 года.
<syntaxhighlight lang="lua">
function func_get_timestamp_server()
local second = getRealTime().timestamp
local day = math.ceil(tonumber((second / 86400) - 18250))
local hour = math.ceil(tonumber(day * 24))
return day, hour
end
</syntaxhighlight>
Автор - RIGZI

==See Also==
{{Utility functions}}
[[ru:GetRealTime]]

RU/getRealTime

2021-04-16T17:06:00Z

RIGZI: /* Пример */

__NOTOC__
{{RU/Server client function}}
Эта функция получает реальное время клиента либо сервера (Если используется на клиентской стороне, то он возвращает время, установленное на компьютере клиента) и возвращает его в таблицу. Если вы хотите получить внутриигровое время (Показанное на часах в GTA) используйте [[getTime]].

==Синтаксис==
<syntaxhighlight lang="lua">table getRealTime( [int seconds = current] )</syntaxhighlight>

===Необязательные аргументы===
{{OptionalArg}}
{{New feature/item|3|1.0||
*'''seconds:''' Количество секунд от 1 января 1970 года (начала Unix эпохи). Полезен для использования в [[getBanTime]]. Правильные значения: от 0 до 32,000,000,000
}}

===Возвращаемые значения===
Возвращает ''таблицу'' подстрок в различных форматах, либо булев ''false'' если параметр '''seconds''' имеет неправильное значение.

{| border="2" cellpadding="2" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 95%;"
|'''Member'''
|'''Meaning'''
|'''Range'''
|-
|second
|секунда внутри минуты
|0-61*
|-
|minute
|минута внутри часа
|0-59
|-
|hour
|час с полуночи
|0-23
|-
|monthday
|день в месяце
|1-31
|-
|month
|месяцы, начиная с Января (который 0)
|0-11
|-
|year
|годы начиная с 1900
|-
|weekday
|дни, начиная с Воскресенья
|0-6
|-
|yearday
|дни, начиная с 1 января (которое 0)
|0-365
|-
|isdst
|Daylight Saving Time flag
|-
|timestamp
|секунды с 1 января 1970 (MTA 1.1 +)
|
|}
* tm_sec is generally 0-59. Extra range to accommodate for leap seconds in certain systems.

==Example==
Этот пример выведет локальное время (сервера или клиента в зависимости, откуда будет вызвано) в часах и минутах.
<syntaxhighlight lang="lua">
function showtime ()
local time = getRealTime() -- в таблице time записываем реальное время
local hours = time.hour -- в переменную hours записываем количество часов
local minutes = time.minute -- а в minutes минут
outputChatBox ( "Local Time: "..hours..":"..minutes ) -- и выводим игроку
end
</syntaxhighlight>

==Пример==
Этот пример выведет сколько дней и часов прошло с 2020 года.
<syntaxhighlight lang="lua">
function func_get_timestamp_server()
local second = getRealTime().timestamp
local day = math.ceil(tonumber((second / 86400) - 18250))
local hour = math.ceil(tonumber(day * 24))
return day, hour
end
</syntaxhighlight>
Автор - RIGZI

==See Also==
{{Utility functions}}
[[ru:GetRealTime]]

RU/getRealTime

2021-04-16T17:03:49Z

RIGZI: /* Example */

__NOTOC__
{{RU/Server client function}}
Эта функция получает реальное время клиента либо сервера (Если используется на клиентской стороне, то он возвращает время, установленное на компьютере клиента) и возвращает его в таблицу. Если вы хотите получить внутриигровое время (Показанное на часах в GTA) используйте [[getTime]].

==Синтаксис==
<syntaxhighlight lang="lua">table getRealTime( [int seconds = current] )</syntaxhighlight>

===Необязательные аргументы===
{{OptionalArg}}
{{New feature/item|3|1.0||
*'''seconds:''' Количество секунд от 1 января 1970 года (начала Unix эпохи). Полезен для использования в [[getBanTime]]. Правильные значения: от 0 до 32,000,000,000
}}

===Возвращаемые значения===
Возвращает ''таблицу'' подстрок в различных форматах, либо булев ''false'' если параметр '''seconds''' имеет неправильное значение.

{| border="2" cellpadding="2" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 95%;"
|'''Member'''
|'''Meaning'''
|'''Range'''
|-
|second
|секунда внутри минуты
|0-61*
|-
|minute
|минута внутри часа
|0-59
|-
|hour
|час с полуночи
|0-23
|-
|monthday
|день в месяце
|1-31
|-
|month
|месяцы, начиная с Января (который 0)
|0-11
|-
|year
|годы начиная с 1900
|-
|weekday
|дни, начиная с Воскресенья
|0-6
|-
|yearday
|дни, начиная с 1 января (которое 0)
|0-365
|-
|isdst
|Daylight Saving Time flag
|-
|timestamp
|секунды с 1 января 1970 (MTA 1.1 +)
|
|}
* tm_sec is generally 0-59. Extra range to accommodate for leap seconds in certain systems.

==Example==
Этот пример выведет локальное время (сервера или клиента в зависимости, откуда будет вызвано) в часах и минутах.
<syntaxhighlight lang="lua">
function showtime ()
local time = getRealTime() -- в таблице time записываем реальное время
local hours = time.hour -- в переменную hours записываем количество часов
local minutes = time.minute -- а в minutes минут
outputChatBox ( "Local Time: "..hours..":"..minutes ) -- и выводим игроку
end
</syntaxhighlight>

==Example==
Этот пример выведет сколько дней и часов прошло с 2020 года.
<syntaxhighlight lang="lua">
function getTimestamp()
local second = getRealTime().timestamp
local day = math.ceil(tonumber((second / 86400) - 18250))
local hour = math.ceil(tonumber(day * 24))
return day, hour
end
</syntaxhighlight>
By RIGZI

==See Also==
{{Utility functions}}
[[ru:GetRealTime]]