이 라이브러리는 현재 UTC 형식으로 시스템 시간에 대한 정보를 제공하는 목적을 수행합니다.표준 Lua os 라이브러리에서 크게 샌드박스화되었으며 시스템 변경 작업을 수행할 수 없습니다.
요약
함수
마이크로초 단위의 임의 기준선으로부터 초과된 시간을 초 단위로 반환합니다. Returns elapsed time in seconds since an arbitrary baseline with sub-microsecond precision.
지정된 시간에 따라 지정된 문자열을 날짜/시간 정보로 형식화합니다.
하나의 시간에서 다른 시간까지의 초 수를 반환합니다.
현재 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, 1for _ = 1, 5000000 doa, b = b, aend-- 이에 소요된 시간 측정:local deltaTime = os.clock() - startTimeprint("Elapsed time: " .. deltaTime)--> Elapsed time: 0.044425600033719 (actual number may vary)
반환
date
지정된 시간에 따라 제공된 날짜/시간 정보로 지정된 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>일요일부터 시작하여 1과 7 사이의 정수 값으로 현재 주 요일을 설명합니다.</td></tr><tr><td>요일</td><td>정수 int</td><td>1에서 366 사이의 정수는 연도에 몇 일인지 설명합니다.만약 윤년이면 366일이 될 수 있습니다.</td></tr><tr><td>일</td><td>정수 int</td><td>1과 31 사이의 정수로 월의 현재 날을 설명합니다.</td></tr><tr><td>시간</td><td>정수 int</td><td>1과 24 사이의 정수로 현재 하루의 시간을 설명합니다.</td></tr><tr><td>분</td><td>정수 int</td><td>0과 59 사이의 정수로 시간의 현재 분을 설명합니다.</td></tr><tr><td>초</td><td>정수 int</td><td>시간의 현재 초를 설명하는 0과 60 사이의 정수입니다.(60 함수가 점프 초를 나타내도록 설명되었지만 실제로는 아닐 수 있음)</td></tr><tr><td>이스트</td><td>부울</td><td>일광 절약 시간이 현재 활성인지 설명하는 부울입니다.</td></tr></tbody>
필드 |
---|
time
현재 UTC 시간에 Unix 시대(1970년 1월 1일 00:00:00) 이후 지난 시간(초)을 반환합니다.테이블이 os.date()에서 반환된 것과 유사하게 형식화되면 대신 해당 시점부터의 초 수를 반환합니다.
반환된 시간은 기기로컬 시간을 사용합니다.대부분의 운영 체제는 온라인 시간 서버에 로컬 시간을 자동으로 동기화하므로 몇 백밀리초 내에 있어야 합니다.그러나 사용자는 쉽게 동기화 행동을 비활성화하고 시스템 시간을 원하는 대로 설정할 수 있습니다; 클라이언트와 서버 간의 동기화된 시간의 경우 Workspace:GetServerTimeNow() 대신 사용하십시오.
이 함수는 새로운 작업에서 피해야 합니다. 대신 지역화된 형식을 지원하는 DateTime를 사용하십시오.
이행테스트와 같이 시간 간격을 정확하게 측정해야 하는 경우 os.clock() 대신 사용하십시오.