Difference between revisions of "love.timer.getTime"
m (Made example a bit more practical) |
m |
||
| (6 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| − | Returns the value of a timer with an unspecified starting time. | + | {{newin|[[0.3.2]]|032|type=function}} |
| − | This function should only be used to calculate differences between points in time, as the starting time of the timer is unknown. | + | Returns the value of a precise timer with an unspecified starting time. |
| + | |||
| + | This function should only be used to calculate differences between points in time, as the starting time of the timer is unknown prior to version [[11.4]]. Beginning with 11.4, the timer is initialized to 0 when the [[love.timer]] module is first loaded (usually before main.lua is loaded). | ||
== Function == | == Function == | ||
=== Synopsis === | === Synopsis === | ||
| Line 9: | Line 11: | ||
None. | None. | ||
=== Returns === | === Returns === | ||
| − | {{param|number|time|The time in seconds.}} | + | {{param|number|time|The time in seconds. Given as a decimal, accurate to the microsecond.}} |
| + | |||
== Examples == | == Examples == | ||
=== Checking how long something takes === | === Checking how long something takes === | ||
<source lang="lua"> | <source lang="lua"> | ||
| − | + | local start = love.timer.getTime() | |
| − | local | ||
| − | for | + | -- Concatenate "bar" 1000 times. |
| + | local foo = "" | ||
| + | for _ = 1, 1000 do | ||
foo = foo .. "bar" | foo = foo .. "bar" | ||
end | end | ||
| − | local | + | -- Resulting time difference in seconds. Multiplying it by 1000 gives us the value in milliseconds. |
| − | print(string.format("It took %.3f milliseconds to concatenate 'bar' 1000 times!", 1000 | + | local result = love.timer.getTime() - start |
| + | print( string.format( "It took %.3f milliseconds to concatenate 'bar' 1000 times!", result * 1000 )) | ||
</source> | </source> | ||
== See Also == | == See Also == | ||
* [[parent::love.timer]] | * [[parent::love.timer]] | ||
| − | |||
[[Category:Functions]] | [[Category:Functions]] | ||
| − | {{#set:Description=Returns the amount of time since some time in the past.}} | + | {{#set:Description=Returns the precise amount of time since some time in the past.}} |
{{#set:Since=000}} | {{#set:Since=000}} | ||
| + | {{#set:PrettySince=0.3.2}} | ||
== Other Languages == | == Other Languages == | ||
{{i18n|love.timer.getTime}} | {{i18n|love.timer.getTime}} | ||
Latest revision as of 17:55, 30 December 2021
| Available since LÖVE 0.3.2 |
| This function is not supported in earlier versions. |
Returns the value of a precise timer with an unspecified starting time.
This function should only be used to calculate differences between points in time, as the starting time of the timer is unknown prior to version 11.4. Beginning with 11.4, the timer is initialized to 0 when the love.timer module is first loaded (usually before main.lua is loaded).
Contents
Function
Synopsis
time = love.timer.getTime( )
Arguments
None.
Returns
number time- The time in seconds. Given as a decimal, accurate to the microsecond.
Examples
Checking how long something takes
local start = love.timer.getTime()
-- Concatenate "bar" 1000 times.
local foo = ""
for _ = 1, 1000 do
foo = foo .. "bar"
end
-- Resulting time difference in seconds. Multiplying it by 1000 gives us the value in milliseconds.
local result = love.timer.getTime() - start
print( string.format( "It took %.3f milliseconds to concatenate 'bar' 1000 times!", result * 1000 ))
See Also
Other Languages
Dansk –
Deutsch –
English –
Español –
Français –
Indonesia –
Italiano –
Lietuviškai –
Magyar –
Nederlands –
Polski –
Português –
Română –
Slovenský –
Suomi –
Svenska –
Türkçe –
Česky –
Ελληνικά –
Български –
Русский –
Српски –
Українська –
עברית –
ไทย –
日本語 –
正體中文 –
简体中文 –
Tiếng Việt –
한국어
More info
