기능¶

time.asctime()¶

변환 tuple 또는struct_time시간을 나타내는 반환에 의해gmtime()또는localtime()문자열의 followingform:'Sun Jun 20 23:21:05 1993'. Day 필드는 두 자 longand 이며 day 가 한 자리 인 경우 공백 패딩됩니다(예:'Wed Jun 9 04:26:40 1993').,

t 가 제공되지 않으면localtime()에 의해 반환 된 현재 시간이 사용됩니다. 로케일 정보는asctime()에서 사용하지 않습니다.

참고

같은 이름의 C 함수와 달리asctime()는 atrailing 개행을 추가하지 않습니다.

time.pthread_getcpuclockid(thread_id)¶

반환 clk_id 스레드의 특정한 CPU 시간 시계에 대해 지정된 thread_id.,

사용하는threading.get_ident()또는ident속성threading.Thread개체에 적합한 valuefor thread_id.

경고

전달하는 잘못되거나 만료 thread_id 발생할 수 있습 inundefined 행동 등으로 세분화 잘못입니다.

가용성:Unix(pthread_getcpuclockid(3)forfurther 정보에 대한 맨 페이지 참조).

버전 3.7 의 새로운 기능.

time.clock_getres(clk_id)¶

반환 해상도(정확도)지정된 시계 clk_id., Clk_id 에 대해 허용되는 값 목록은 toClock ID 상수를 참조하십시오.

가용성:유닉스.

버전 3.3 의 새로운 기능.

time.clock_gettime(clk_id)→float¶

반환 시간의 지정 시계 clk_id. Clk_id 에 대해 허용되는 값 목록은 toClock ID 상수를 참조하십시오.

가용성:유닉스.

버전 3.3 의 새로운 기능.

time.clock_gettime_ns(clk_id)→int¶

비슷한clock_gettime()지만 반환 시간으로 나노초입니다.

가용성:유닉스.

버전 3.7 의 새로운 기능.,

time.clock_settime(clk_id,time:float)¶

지정된 클럭 clk_id 의 시간을 설정합니다. 현재CLOCK_REALTIME는 clk_id 에 대해 허용되는 유일한 값입니다.

가용성:유닉스.

버전 3.3 의 새로운 기능.

time.clock_settime_ns(clk_id 시간:int)¶

비슷한clock_settime()하지만 시간을 설정과 함께 나노초입니다.

가용성:유닉스.

버전 3.7 의 새로운 기능.,

time.ctime()¶

변환 시간을 초 단위로 표시되는 이후 시대의 문자열 형태:'Sun Jun 20 23:21:05 1993'대표 현지 시간입니다. 하루 fieldis 두 문자 길이이며 하루가 한 자리 인 경우 공백 패딩됩니다(예:'Wed Jun 9 04:26:40 1993').

time.get_clock_info(이름)¶

에 대한 정보를 얻을 수 지정된 클럭으로 네임스페이스 객체입니다.,지원되는 시계의 이름과 이에 대응하는 기능을 읽는 자신의 valueare:

결과는 다음과 같은 특성을 가지고 있습니다:

  • 조정가능한:True경우 시계 자동으로 변경 될 수 있습니다(예:됨 NTP daemon)또는 수동으로 시스템 관리자, False그렇지 않으면

  • 구현:의 이름을 기본 C 기능을 사용하 getthe 계 값입니다. 가능한 값은 클록 ID 상수를 참조하십시오.,

  • 단순:True경우 시계 수 없습 뒤로 이동,False그렇지 않으면

  • 해결책:의 해상도계(초float)

New in version3.3.

time.gmtime()¶

변환 시간을 초 단위로 표시되는 이후 시기를struct_timeinUTC 에서는 dst 플래그입니다. Secs 가 제공되지 않거나None가 반환 한 현재 시간이time()가 사용됩니다., 분수초는 무시됩니다. struct_time객체에 대한 설명은 위 내용을 참조하십시오. 이 함수의 역수는calendar.timegm()를 참조하십시오.

time.localtime()¶

좋아하는gmtime()그로 변환하여 현지 시간입니다. Secs 가 제공되지 않거나None가 반환 한 현재 시간이time()가 사용됩니다. Dstflag 는 주어진 시간에 dst 가 적용될 때1로 설정됩니다.,

time.mktime(t)¶

이것은localtime()의 역함수입니다. 의 인수는struct_time또는 전체 9-tuple(이후 dst 플래그가 필요한 사-1로 dst 플래그하면 그것이 알려진)를 표현하는 이 시간에서 현지 시간 notUTC. 그것은time()와의 호환성을 위해 부동 소수점 숫자를 반환합니다.,만약 입력 값을 표현할 수 없으로 유효한,시간이 하나OverflowError또는ValueError발생(따라 onwhether 잘못된 값에 의해 적발 Python 또는 기본는 C 라이브러리)입니다.시간을 생성 할 수있는 가장 빠른 날짜는 플랫폼에 따라 다릅니다.

time.monotonic()→float¶

반환 값(소수 초)단조 시계,즉 clockthat 갈 수 없습니다. 시계는 시스템 시계 업데이트의 영향을 받지 않습니다.,반환 된 값의 참조 점은 정의되지 않으므로 연속 호출 결과 간의 차이 만 유효합니다.

버전 3.3 의 새로운 기능.

에서 변경 3.5 버전:이 함수는 지금은 항상 사용할 수 있고 항상 시스템입니다.

time.monotonic_ns()→int¶

비슷한monotonic()지만,반납시간으로 나노초입니다.

버전 3.7 의 새로운 기능.

time.perf_counter()→float¶

반환 값(소수 초)의 성능응,즉, 사용 가능한 가장 높은 해상도를 가진 aclock 은 짧은 기간을 측정합니다. 그것은 수면 중에 경과 한 시간을 포함하며 시스템 전체입니다. 반환 된 값의 referencepoint 는 정의되지 않았으므로 연속 호출 결과의 차이 만 유효합니다.

버전 3.3 의 새로운 기능.

time.perf_counter_ns()→int¶

비슷한perf_counter()지만,반납시간으로 나노초입니다.

버전 3.7 의 새로운 기능.,

time.process_time()→float¶

반환 값(소수 초)의 합의 시스템 userCPU 시간 현재의 과정입니다. 그것은 동안 경과 시간을 포함하지 않습니다수면. 그것은 정의에 의해 프로세스 전반에 걸쳐 있습니다. 그 결과 값의 기준점은 정의되지 않으므로 결과 간의 차이 만 연속 호출이 유효합니다.

버전 3.3 의 새로운 기능.

time.process_time_ns()→int¶

비슷한process_time()지만 반환 시간으로 나노초입니다.,

버전 3.7 의 새로운 기능.

time.sleep(초)¶

중단한 실행 스레드 호출에 대해 주어진 숫자의 초입니다.인수는보다 정확한 잠자기 시간을 나타 내기 위해 부동 소수점 숫자 일 수 있습니다. 실제 서스펜션 시간보다 작을 수 있는 요청했기 때문에 anycaught 신호 종료됩sleep()다음의 실행 thatsignal 의 잡는 루틴입니다. 또한,정지 시간이 더 길 수 있습니다.시스템에서 다른 활동의 스케줄링 때문에 임의의 양으로 요구된다.,

에서 변경 3.5 버전:기능 지금 잔 최소 초인 경우에도 잠 interruptedby 신호는 경우를 제외하고,신호 처리기 예외가 발생합니다(seePEP475 에 대한 이론적 설명).

time.strftime(형식)¶

변환 tuple 또는struct_time시간을 나타내는 반환에 의해gmtime()또는localtime()문자열로 지정한 formatargument. T 가 제공되지 않으면localtime()에 의해 반환 된 현재 시간이 사용됩니다. 형식은 문자열이어야합니다., ValueErrort 의 모든 필드가 허용 범위를 벗어난 경우 israised.

0 은 시간 튜플의 모든 위치에 대한 법적 논증입니다.

다음 지시문은 형식 문자열에 포함될 수 있습니다., 그들은 shownwithout 선택적 필드폭 및 정밀 사양이며,replacedby 표시된 문자strftime()결과:

참고:

  1. 와 함께 사용하는 경우strptime()기능 %p지시어만 affectsthe 출력 시간 운영 분야는 경우에는%I지시어는 구문 분석하는 데 사용되는 시간 운영합니다.,

  2. 범위를 정말061;값60유효 intimestamps 나타내는 도약을 초과 값61은 supportedfor 역사적인 이유입니다.

  3. 와 함께 사용하는 경우strptime()기능,%U%W만 사용 incalculations 때 날이 올해 지정되어 있습니다.

다음은 therfc2822Internet email standard 에 지정된 날짜와 호환되는 날짜의 형식입니다., 1

>>> from time import gmtime, strftime>>> strftime("%a, %d %b %Y %H:%M:%S +0000", gmtime())'Thu, 28 Jun 2001 14:17:15 +0000'

지시어를 추가할 수 있습에서 지원되는 특정 플랫폼,그 개체만 여기에 나열되어 있는 의미에 의해 표준화 ANSI C 하 집합 형식으로 지원되는 코드 플랫폼에 문의하십시오 strftime(3)문서입니다.

어떤 플래폼에서 선택적 필드폭 및 정밀 사양 canimmediately 따라 초기'%'의 지시어는 다음과 같은 순서이다;이것은 또한 휴대용 되지 않습니다입니다. 필드 너비는 일반적으로%j를 제외하고 2 입니다.,

time.strptime(string)¶

문자열을 구문 분석하는 시간에 따라 형식입니다. Return value 는struct_time반환에 의해gmtime()또는localtime().

format 매개 변수는strftime()에서 사용하는 것과 동일한 지시문을 사용합니다. 문자열을 형식으로 구문 분석 할 수 없거나 구문 분석 후 초과 데이터가있는 경우ValueErrorisraised., Moreaccurate 값을 추론 할 수 없을 때 누락 된 데이터를 채우는 데 사용되는 기본값은(1900, 1, 1, 0, 0, 0, 0, 1, -1)입니다.문자열과 형식은 모두 문자열이어야합니다.

예를 들어,

에 대한 지원%Z지시어에 기초한 값에 포함된tzname지 여부daylight사실입니다. 이 때문에 항상 알려진 UTC 및 GMT 를 인식하기위한 플랫폼 특정입니다(비 일광 절약 시간대로 간주됩니다).

설명서에 지정된 지시문 만 지원됩니다., 플랫폼 당strftime()가 구현되기 때문에 때로는 나열된 것보다 더 많은 것을 제공 할 수 있습니다. 그러나strptime()는 모든 플랫폼과 독립적이므로 지원되는 것으로 문서화되지 않은 모든 지시문을 반드시 지원하지는 않습니다.

time.struct_time

유형의 시간 값 순서에 의해 반환되는gmtime(),localtime(),andstrptime(). 그것은 namedtuple 인터페이스를 가진 객체입니다:값은 인덱스와 속성 이름으로 액세스 할 수 있습니다., C 구조와 달리 월 값이 아닌 범위라는 점에 유의하십시오.

에서 전화를mktime(),tm_isdst설정할 수 있습 1daylightsavings 시간에 효과,고 0 때 그것은 아닙니다. -1 의 값은 다음을 나타냅니다.이것은 알려지지 않았으며 일반적으로 올바른 상태가 채워집니다.

경우 튜플을 잘못된 길이가 통과하는 함수struct_time,또는 요소의 잘못된 형식TypeError가 발생합니다.,

time.time()→float¶

반환에서 시간을 초 이후 획기적으로 부동 pointnumber. 에포크 및 처리 날짜의 특정 날짜수초는 플랫폼에 따라 다릅니다.Windows 및 대부분의 Unix 시스템에서 신기원은 1970,00:00:00(UTC)1 월 1 일이며 윤초는 신기원 이후 시간 초로 계산되지 않습니다. 이것은 일반적으로 알려 asUnix 시간입니다.무엇을 찾아 시대는 주어진된 플랫폼에서,보gmtime(0).,

이지만 시간은 항상 반으로 떠 pointnumber,모든 시스템을 제공하는 시간을 가진 더 나은 정밀도보다 1 초입니다.이 기능은 일반적으로 반환을 감소하지 않는 값을 반환 할 수 있습 alower 값보다 이전 호출하면 시스템 클럭 설정되었습 backbetween 두 호출합니다.

번호를 반환에 의해time()으로 변환 될 수 있습니다.더 commontime 형식으로(즉,해,달,날,시간 등)UTC 전달하여 그것을gmtime()기능이나에서 지역 시간을 전달하여 그것을localtime()기능이다., 두 경우 모두struct_time개체가 반환되며,이 개체에서 달력 날짜의 구성 요소가 속성으로 액세스 될 수 있습니다.

time.thread_time()→float¶

반환 값(소수 초)의 합의 시스템 userCPU 재의 시간을 thread. 그것은 동안 경과 시간을 포함하지 않습니다수면. 정의에 따라 스레드 별입니다. 동일한 스레드에서 연속적인 호출의 결과 사이의 차이 만 유효하므로 그 결과 값의 기준점은 정의되지 않습니다.,

가용성:Windows,Linux,Unix 시스템을 지원하는CLOCK_THREAD_CPUTIME_ID.

버전 3.7 의 새로운 기능.

time.thread_time_ns()→int¶

비슷한thread_time()지만 반환 시간으로 나노초입니다.

버전 3.7 의 새로운 기능.

time.time_ns()→int¶

비슷한time()그러나 반환으로 시간 정수 번호의 nanosecondssince epoch.

버전 3.7 의 새로운 기능.,

time.tzset()¶

시간을 재설정 변환 규칙에 의해 사용되는 라이브러리 루틴입니다. EnvironmentvariableTZ이 수행 방법을 지정합니다., 그것은 또한 변수를 설정tzname(에서TZ환경 변수),timezone(비 DSTseconds 의 서쪽 UTC),altzone(DST 초 동안의 서쪽 UTC) 그리고daylight(0 는 경우 이 시간이 없는 일광 절약 시간 규칙,또는 tononzero 이 있는 경우,시간이 과거,현재 또는 미래의 경우 일광 절약 timeapplies).

가용성:유닉스.,

참고.

지만 많은 경우에,변경하는TZ환경 변수 mayaffect 출력의 함수를 다음과 같localtime()호출하지 않고tzset()이 동작을 의존하지 않아야한다.

TZ환경 변수에는 공백이 없어야합니다.,

의 표준 형식TZ환경 변수가(whitespaceadded 명확성을 위해):

std offset , end]]]

는 구성 요소는 다음과 같습니다.

stddst

세 개 이상의 주는 영숫자 약어는 표준 시간대. 이것들은시간으로 전환.tzname

offset

오프셋에는± hh]형식이 있습니다. 이 값은 utc 에 도착할 현지 시간을 나타냅니다., ‘-‘앞에 있으면 프라임 자오선의 동쪽에있는 시간대입니다. 오프셋이 따르지 않으면 여름 시간은 표준 시간보다 1 시간 앞서 있다고 가정합니다.

start, end

는 DST 에서 언제 다시 변경해야 하는지를 나타냅니다. 의 형식을작과 끝날짜가 다음 중 하나이다:

Jn

율리우스 일 n(1<=n<=365). 윤일은 계산되지 않으므로모든 년 2 월 28 일은 59 일이고 3 월 1 일은 60 일입니다.,

n

제로 기반으로 줄리안 일(0<=n<=365). 도약 일이 계산되고그것은 2 월 29 일을 참조 할 수있다.

Mm.n.d

time는 동일한 형식으로offset없다는 점 외에는 최고의 기호(‘-‘또는’+’)은 사용할 수 있습니다. 시간이 주어지지 않으면 기본값은 02:00:00 입니다.

에 많은 유닉스 시스템(함*BSD,Linux,Solaris,다윈),그것은 moreconvenient 시스템을 사용하 zoneinfo(tzfile(5))데이터베이스를 지정 시간대 규칙이 있습니다., 이렇게 하려면 설정TZenvironmentvariable 의 경로 필요한 시간대에 데이터 파일을 기준으로 루트의 시스템’zoneinfo’시간대에 데이터베이스,위치는 일반적으로/usr/share/zoneinfo. 예를 들어,'US/Eastern','Australia/Melbourne','Egypt'또는'Europe/Amsterdam'.나는 이것이 내가 할 수있는 유일한 방법이라고 생각한다.