RU/getRealTime: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "{{Translate}} __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 ret...")
 
No edit summary
 
(11 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Translate}}
__NOTOC__
__NOTOC__
{{Server client function}}
{{RU/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]].
Эта функция получает реальное время клиента либо сервера (Если используется на клиентской стороне, то он возвращает время, установленное на компьютере клиента) и возвращает его в таблицу. Если вы хотите получить внутриигровое время (Показанное на часах в GTA) используйте [[getTime]].


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


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


===Returns===
===Возвращаемые значения===
Returns a ''table'' of substrings with different time format or ''false'' if the '''seconds''' argument is out of range.
Возвращает ''таблицу'' подстрок в различных форматах, либо булев ''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%;"
{| border="2" cellpadding="2" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 95%;"
Line 22: Line 21:
|-
|-
|second
|second
|seconds after the minute
|секунда внутри минуты
|0-61*
|0-61*
|-
|-
|minute
|minute
|minutes after the hour
|минута внутри часа
|0-59
|0-59
|-
|-
|hour
|hour
|hours since midnight
|час с полуночи
|0-23
|0-23
|-
|-
|monthday
|monthday
|day of the month
|день в месяце
|1-31
|1-31
|-
|-
|month
|month
|months since January
|месяцы, начиная с Января (который 0)
|0-11
|0-11
|-
|-
|year
|year
|years since 1900
|годы начиная с 1900
|-
|-
|weekday
|weekday
|days since Sunday
|дни, начиная с Воскресенья
|0-6
|0-6
|-
|-
|yearday
|yearday
|days since January 1
|дни, начиная с 1 января (которое 0)
|0-365
|0-365
|-
|-
Line 56: Line 55:
|-
|-
|timestamp
|timestamp
|seconds since 1970 (MTA 1.1 +)
|секунды с 1 января 1970 (MTA 1.1 +)
|
|
|}
|}
Line 62: Line 61:


==Example==
==Example==
This example outputs local time (server or client, where ever it was triggered) as hours and minutes
Этот пример выведет локальное время (сервера или клиента в зависимости, откуда будет вызвано) в часах и минутах.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function showtime ()
function showtime ()
local time = getRealTime()
local time = getRealTime() -- в таблице time записываем реальное время
local hours = time.hour
local hours = time.hour -- в переменную hours записываем количество часов
local minutes = time.minute
local minutes = time.minute -- а в minutes минут
outputChatBox ( "Local Time: "..hours..":"..minutes )
outputChatBox ( "Local Time: "..hours..":"..minutes ) -- и выводим игроку
end
end
</syntaxhighlight>
</syntaxhighlight>
Line 74: Line 73:
==See Also==
==See Also==
{{Utility functions}}
{{Utility functions}}
[[ru:GetRealTime]]

Latest revision as of 21:20, 14 June 2021

Эта функция получает реальное время клиента либо сервера (Если используется на клиентской стороне, то он возвращает время, установленное на компьютере клиента) и возвращает его в таблицу. Если вы хотите получить внутриигровое время (Показанное на часах в GTA) используйте getTime.

Синтаксис

table getRealTime( [int seconds = current] )

Необязательные аргументы

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.


  • seconds: Количество секунд от 1 января 1970 года (начала Unix эпохи). Полезен для использования в getBanTime. Правильные значения: от 0 до 32,000,000,000

Возвращаемые значения

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

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

Этот пример выведет локальное время (сервера или клиента в зависимости, откуда будет вызвано) в часах и минутах.

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

See Also