os

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

이 라이브러리는 현재 UTC 형식으로 시스템 시간에 대한 정보를 제공하는 목적을 수행합니다.표준 Lua os 라이브러리에서 크게 샌드박스화되었으며 시스템 변경 작업을 수행할 수 없습니다.

요약

함수

  • 마이크로초 단위의 임의 기준선으로부터 초과된 시간을 초 단위로 반환합니다. Returns elapsed time in seconds since an arbitrary baseline with sub-microsecond precision.

  • date(formatString : string,time : number):Dictionary

    지정된 시간에 따라 지정된 문자열을 날짜/시간 정보로 형식화합니다.

  • 하나의 시간에서 다른 시간까지의 초 수를 반환합니다.

  • time(time : table):number

    현재 UTC 시간에서 Unix 시대(1970년 1월 1일 00:00:00) 이후 지난 시간(초)을 반환합니다.

함수

clock

마이크로초 단위의 임의 기준선으로부터 초과된 시간을 초 단위로 반환합니다. Returns elapsed time in seconds since an arbitrary baseline with sub-microsecond precision.이 함수는 동일한 컴퓨터에서 발생하는 두 이벤트의 지속 시간을 비교하는 데 유용하며 벤치마킹에 가장 적합한 옵션입니다.

함수 os.time() 또는 DateTime.now()와 같은 것과는 달리, 시스템 시계(사용자 또는 NTP에 의해)에 대한 조정은 시간을 앞으로 또는 뒤로 이동시키지 않습니다.


-- 초기 시간 기록:
local startTime = os.clock()
-- 성능을 측정하려는 것을 수행하십시오:
local a, b = 0, 1
for _ = 1, 5000000 do
a, b = b, a
end
-- 이에 소요된 시간 측정:
local deltaTime = os.clock() - startTime
print("Elapsed time: " .. deltaTime)
--> Elapsed time: 0.044425600033719 (actual number may vary)

반환

지정된 시간에 따라 제공된 날짜/시간 정보로 지정된 formatString 를 형식화하거나, 제공되지 않으면 os.time() 에서 반환된 값을 사용합니다.

이 함수는 새로운 작업에서 피해야 합니다. 대신 지역화된 형식을 지원하는 DateTime를 사용하십시오.

다음 지정자(C 함수 strftime 기반)가 지원됩니다:


<th>의미</th>
<th>예제 <sup>†</sup></th>
</tr>
</thead>
<tbody>
<tr>
<td>%a</td>
<td>약식 주간 이름 *</td>
<td>월</td>
</tr>
<tr>
<td>%A</td>
<td>전체 주간 이름 *</td>
<td>월요일</td>
</tr>
<tr>
<td>%b</td>
<td>약식 월 이름*</td>
<td>2월</td>
</tr>
<tr>
<td>%B</td>
<td>전체 월 이름 *</td>
<td>2월</td>
</tr>
<tr>
<td>%c</td>
<td>날짜 및 시간 *</td>
<td>월 12일 오후 14:14:35 2024</td>
</tr>
<tr>
<td>%d</td>
<td>월의 날짜</td>
<td>12</td>
</tr>
<tr>
<td>%H</td>
<td>24시간 시계를 사용하여 시간 표현하기</td>
<td>14</td>
</tr>
<tr>
<td>%I</td>
<td>12시간 시계를 사용하여 시간 표현하기</td>
<td>02</td>
</tr>
<tr>
<td>%j</td>
<td>연도의 날</td>
<td>043</td>
</tr>
<tr>
<td>%m</td>
<td>달</td>
<td>02</td>
</tr>
<tr>
<td>%M</td>
<td>분</td>
<td>14</td>
</tr>
<tr>
<td>%p</td>
<td>AM 또는 PM</td>
<td>PM</td>
</tr>
<tr>
<td>%S</td>
<td>2번째</td>
<td>35</td>
</tr>
<tr>
<td>%U</td>
<td>주 번호(첫 번째 일요일을 첫 번째 주의 첫 날로 지정)</td>
<td>06</td>
</tr>
<tr>
<td>%w</td>
<td>평일</td>
<td>1</td>
</tr>
<tr>
<td>%W</td>
<td>주 번호(첫 번째 월요일을 첫 번째 주의 첫 날로 지정)</td>
<td>07</td>
</tr>
<tr>
<td>%x</td>
<td>날짜 *</td>
<td>02/12/24</td>
</tr>
<tr>
<td>%X</td>
<td>시간 *</td>
<td>14:14:35</td>
</tr>
<tr>
<td>%y</td>
<td>2자리 연도</td>
<td>24</td>
</tr>
<tr>
<td>%Y</td>
<td>전년도</td>
<td>2024</td>
</tr>
<tr>
<td>%z</td>
<td>표준 시간대에서 UTC에서 ISO 8601 오프셋(1분 = 1, 1시간 = 100)</td>
<td>-0800</td>
</tr>
<tr>
<td>%Z</td>
<td>표준 시간대 이름 또는 약어 *</td>
<td>태평양 표준 시간</td>
</tr>
<tr>
<td>%%</td>
<td>% 문자</td>
<td>%</td>
</tr>
</tbody>
지정자

※ 이 값은 현재 로캘에 따라 달라질 수 있습니다.

† 제공된 예제는 2024년 2월 12일(월) 오후 2:14:35(14:14:35)에 로캘 "en-us"를 사용하여 태평양 표준시(PST)에서 실행됩니다.

제공된 formatString 가 정확히 "*t" (지역 시간)이거나 "!*t" (UTC 시간)인 경우, 이 함수는 일반적으로 위의 지정자에 포함된 다음 구성 요소를 포함하는 사전을 반환합니다.


<th>유형</th>
<th>설명</th>
</tr>
</thead>
<tbody>
<tr>
<td>연도</td>
<td>정수 int</td>
<td>현재 시대의 현재 연도를 설명하는 정수(예: 2017)</td>
</tr>
<tr>
<td>달</td>
<td>정수 int</td>
<td>1에서 12 사이의 정수(1월부터 시작)로 현재 달을 설명합니다.</td>
</tr>
<tr>
<td>웨이 데이</td>
<td>정수 int</td>
<td>일요일부터 시작하여 17 사이의 정수 값으로 현재 주 요일을 설명합니다.</td>
</tr>
<tr>
<td>요일</td>
<td>정수 int</td>
<td>1에서 366 사이의 정수는 연도에 몇 일인지 설명합니다.만약 윤년이면 366일이 될 수 있습니다.</td>
</tr>
<tr>
<td>일</td>
<td>정수 int</td>
<td>131 사이의 정수로 월의 현재 날을 설명합니다.</td>
</tr>
<tr>
<td>시간</td>
<td>정수 int</td>
<td>124 사이의 정수로 현재 하루의 시간을 설명합니다.</td>
</tr>
<tr>
<td>분</td>
<td>정수 int</td>
<td>059 사이의 정수로 시간의 현재 분을 설명합니다.</td>
</tr>
<tr>
<td>초</td>
<td>정수 int</td>
<td>시간의 현재 초를 설명하는 060 사이의 정수입니다.(60 함수가 점프 초를 나타내도록 설명되었지만 실제로는 아닐 수 있음)</td>
</tr>
<tr>
<td>이스트</td>
<td>부울</td>
<td>일광 절약 시간이 현재 활성인지 설명하는 부울입니다.</td>
</tr>
</tbody>
필드

매개 변수

formatString: string

Must be either "*t" 또는 "!*t" 이어야 합니다.

time: number

형식화할 시간 값.

difftime

반환 기간은 t1에서 t2까지의 초 수입니다.차이는 t1t2 가 올바르게 캐스팅되어 time_t 형식으로 계산됩니다.

매개 변수

t2: number
t1: number

반환

time

현재 UTC 시간에 Unix 시대(1970년 1월 1일 00:00:00) 이후 지난 시간(초)을 반환합니다.테이블이 os.date()에서 반환된 것과 유사하게 형식화되면 대신 해당 시점부터의 초 수를 반환합니다.

반환된 시간은 기기로컬 시간을 사용합니다.대부분의 운영 체제는 온라인 시간 서버에 로컬 시간을 자동으로 동기화하므로 몇 백밀리초 내에 있어야 합니다.그러나 사용자는 쉽게 동기화 행동을 비활성화하고 시스템 시간을 원하는 대로 설정할 수 있습니다; 클라이언트와 서버 간의 동기화된 시간의 경우 Workspace:GetServerTimeNow() 대신 사용하십시오.

이 함수는 새로운 작업에서 피해야 합니다. 대신 지역화된 형식을 지원하는 DateTime를 사용하십시오.

이행테스트와 같이 시간 간격을 정확하게 측정해야 하는 경우 os.clock() 대신 사용하십시오.

매개 변수

time: table

특정 시간을 설명하는 사전 테이블, os.date()에서 반환된 것과 유사합니다. 제공되지 않으면 현재 UTC 시간을 사용합니다.

기본값: UTC time

반환