Một đối tượng nhận biết có đủ kiến thức về các điều chỉnh thời gian chính trị và thuật toán hiện hành, chẳng hạn như múi giờ và thông tin về thời gian tiết kiệm ánh sáng ban ngày, để định vị chính nó so với các đối tượng nhận biết khác. Một đối tượng nhận thức được sử dụng để biểu thị một thời điểm cụ thể không thể giải thích được [1]
Một đối tượng ngây thơ không chứa đủ thông tin để định vị chính nó một cách rõ ràng so với các đối tượng ngày/giờ khác. Việc một đối tượng ngây thơ đại diện cho Giờ phối hợp quốc tế [UTC], giờ địa phương hay thời gian ở một số múi giờ khác hoàn toàn phụ thuộc vào chương trình, giống như việc một số cụ thể đại diện cho mét, dặm hay khối lượng hay không là tùy thuộc vào chương trình. Các đối tượng ngây thơ dễ hiểu và dễ làm việc với cái giá phải trả là bỏ qua một số khía cạnh của thực tế
Đối với các ứng dụng yêu cầu đối tượng nhận biết, ngày giờ và thời gian . Các đối tượng tzinfo, that can be set to an instance of a subclass of the abstract tzinfo class. These tzinfo này nắm bắt thông tin về độ lệch so với thời gian UTC, tên múi giờ và liệu Giờ tiết kiệm ánh sáng ban ngày có hiệu lực hay không. Lưu ý rằng chỉ có một lớp tzinfo cụ thể, lớp múi giờ , được cung cấp . Lớp datetime module. The múi giờ có thể biểu thị các múi giờ đơn giản với độ lệch cố định từ UTC, chẳng hạn như chính UTC hoặc các múi giờ EST và EDT của Bắc Mỹ. Hỗ trợ các múi giờ ở mức độ chi tiết sâu hơn tùy thuộc vào ứng dụng. Các quy tắc điều chỉnh thời gian trên toàn thế giới mang tính chính trị hơn là hợp lý, thay đổi thường xuyên và không có tiêu chuẩn nào phù hợp cho mọi ứng dụng ngoài UTC.
Mô-đun datetime xuất các hằng số sau.
ngày giờ. THÁNG NĂM¶Số năm nhỏ nhất được phép trong ngày hoặc ngày giờ object. MƯU NĂM là 1 .
ngày giờ. TỐI ĐA NĂM¶Số năm lớn nhất được phép trong ngày hoặc ngày giờ object. TỐI ĐA NĂM là 9999 .
Xem thêm
Mô-đun lịch Các chức năng chung liên quan đến lịch. Mô-đun thời gian Thời gian truy cập và chuyển đổi.8. 1. 1. Các loại có sẵn¶
ngày giờ học. ngày thángMột ngày ngây thơ được lý tưởng hóa, giả sử lịch Gregorian hiện tại luôn như vậy và sẽ luôn như vậy, có hiệu lực. Thuộc tính. năm , tháng và . .
ngày giờ học. thời gianThời gian lý tưởng hóa, không phụ thuộc vào bất kỳ ngày cụ thể nào, giả sử rằng mỗi ngày có chính xác 24*60*60 giây [không có khái niệm "giây nhuận" ở đây]. Thuộc tính. giờ , phút , giây . , microsecond, and tzinfo.
ngày giờ học. ngày giờKết hợp ngày và giờ. Thuộc tính. năm , tháng , ngày . , hour, minute, second, microsecond, and tzinfo.
ngày giờ học. múi giờThời lượng thể hiện sự khác biệt giữa hai ngày , thời gian, or datetime instances to microsecond resolution.
ngày giờ học. tzinfo¶Một lớp cơ sở trừu tượng cho các đối tượng thông tin múi giờ. Chúng được sử dụng bởi các lớp datetime và time để cung cấp một khái niệm có thể tùy chỉnh .
ngày giờ học. Múi giờ¶Một lớp triển khai tzinfo lớp cơ sở trừu tượng dưới dạng phần bù cố định từ UTC.
Mới trong phiên bản 3. 2
Các đối tượng của các loại này là bất biến
Objects of the date type are always naive.
An object of type time or datetime may be naive or aware. A datetime object d is aware if d. tzinfo không phải là Không có và d. tzinfo. utcoffset[d] không trả về Không có . Nếu d. tzinfo is None , or if d. tzinfo không phải là Không có mà là d. tzinfo. utcoffset[d] trả về Không có , d là ngây thơ. Một thời gian đối tượng t biết nếu t. tzinfo không phải là Không có và t. tzinfo. utcoffset[None] không trả về Không . Nếu không, t là ngây thơ.
The distinction between naive and aware doesn’t apply to timedelta objects.
quan hệ phân lớp
object timedelta tzinfo timezone time date datetime
8. 1. 2. timedelta Đối tượng¶
A timedelta đại diện cho một khoảng thời gian, sự khác biệt giữa hai ngày hoặc thời gian.
ngày giờ học. timedelta[days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0]¶Tất cả các đối số là tùy chọn và mặc định là 0 . Các đối số có thể là số nguyên hoặc số float và có thể dương hoặc âm.
Chỉ ngày, giây và micro giây được lưu trữ nội bộ. Các đối số được chuyển đổi thành các đơn vị đó
- Một phần nghìn giây được chuyển đổi thành 1000 micro giây
- Một phút được chuyển thành 60 giây
- An hour is converted to 3600 seconds
- Một tuần được chuyển đổi thành 7 ngày
và ngày, giây và micro giây sau đó được chuẩn hóa để biểu diễn là duy nhất, với
- 0 > [d.days, d.seconds, d.microseconds]
[-1, 86399, 999999]
Thuộc tính lớp là
múi giờ. tối thiểu¶Đối tượng timedelta tiêu cực nhất, timedelta[-999999999].
Đối tượng timedelta tích cực nhất, timedelta[days=999999999, hours=23, minutes=59, seconds=59, microseconds=999999].
múi giờ. nghị quyết¶The smallest possible difference between non-equal timedelta objects, timedelta[microseconds=1] .
Lưu ý rằng, do chuẩn hóa, timedelta. tối đa > -timedelta. phút . -timedelta. max is not representable as a timedelta object.
Thuộc tính phiên bản [chỉ đọc]
AttributeValue days Between -999999999 and 999999999 inclusive seconds Between 0 and 86399 inclusive microseconds Between 0 and 999999 inclusivehoạt động được hỗ trợ
Kết quả hoạt động t1 = t2 + t3Sum of t2 and t3. Afterwards t1-t2 == t3 and t1-t3 == t2 are true. [1]t1 = t2 - t3 Difference of t2 and t3. Afterwards t1 == t2 - t3 and t2 == t1 + t3 are true. [1] t1 = t2 * i or t1 = i * t2 Delta multiplied by an integer. Sau đó t1 // i == t2 là đúng, miễn là i . = 0 . Nói chung, t1 * i == t1 * [i-1] + t1 là đúng. [1] t1 = t2 * f or t1 = f * t2 Delta multiplied by a float. Kết quả được làm tròn đến bội số gần nhất của timedelta. resolution using round-half-to-even. f = t2 / t3 . Trả về một đối tượng Division [3] of t2 by t3. Returns a float . t1 = t2 / f . The result is rounded to the nearest multiple of timedelta. độ phân giải sử dụng nửa vòng đến chẵn. or t1 = t2 / iDelta divided by a float or an int. The result is rounded to the nearest multiple of timedelta.resolution using round-half-to-even.t1 = t2 // . Trong trường hợp thứ hai, một số nguyên được trả về. [3] or t1 = t2 // t3The floor is computed and the remainder [if any] is thrown away. In the second case, an integer is returned. [3]t1 = t2 % t3The remainder is computed as a timedelta object. [3]q, r = divmod[t1, t2] Computes the quotient and the remainder. q = t1 // . q là một số nguyên và r là một [3] and r = t1 % t2. q is an integer and r is a timedelta đối tượng. +t1 Trả về đối tượng timedelta có cùng giá trị. [2] -t1 tương đương với timedelta [-t1. ngày, -t1. giây, -t1. micro giây] và đến t1* -1. [1][4] abs[t] tương đương với +t khi t. ngày >= 0 và đến -t khi t. ngày >> timedelta[hours=-5] datetime.timedelta[-1, 68400] >>> print[_] -1 day, 19:00:00
In addition to the operations listed above timedelta objects support certain additions and subtractions with date and datetime objects [see below].
Đã thay đổi trong phiên bản 3. 2. Phân chia tầng và phân chia thực sự của một timedelta cho đối tượng timedelta khác . Bây giờ phép chia và phép nhân thực sự của một đối tượng khác . Bây giờ phép chia và phép nhân thực sự của một đối tượng khác . Bây giờ phép chia và phép nhân thực sự của một đối tượng khác . Bây giờ phép chia và phép nhân thực sự của một đối tượng khác . Bây giờ phép chia và phép nhân thực sự của một đối tượng khác . Bây giờ phép chia và phép nhân thực sự của một đối tượng khác . Bây giờ phép chia và phép nhân thực sự của một đối tượng khác . Bây giờ phép chia và phép nhân thực sự của một đối tượng khác . Bây giờ phép chia và phép nhân thực sự của một đối tượng khác . Bây giờ phép chia và phép nhân thực sự của một đối tượng khác . Bây giờ phép chia và phép nhân thực sự của một đối tượng object are now supported, as are remainder operations and the divmod[] function. True division and multiplication of a timedelta với một đối tượng float .
So sánh các đối tượng timedelta được hỗ trợ với timedelta . Để ngăn so sánh kiểu hỗn hợp quay trở lại so sánh mặc định theo địa chỉ đối tượng, khi một đối tượng timedelta được so sánh với một đối tượng thuộc loại khác . = TypeError is raised unless the comparison is == or != . The latter cases return False or True , respectively.
timedelta có thể băm [có thể sử dụng làm khóa từ điển], hỗ trợ chọn hiệu quả và trong ngữ cảnh Boolean, a timedelta object is considered to be true if and only if it isn’t equal to timedelta[0].
Phương thức sơ thẩm
timedelta. tổng_giây[]¶Trả về tổng số giây có trong khoảng thời gian. Tương đương với td / timedelta[giây=1] .
Lưu ý rằng trong khoảng thời gian rất lớn [hơn 270 năm trên hầu hết các nền tảng], phương pháp này sẽ mất độ chính xác micro giây
Mới trong phiên bản 3. 2
Ví dụ sử dụng
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] # adds up to 365 days >>> year.total_seconds[] 31536000.0 >>> year == another_year True >>> ten_years = 10 * year >>> ten_years, ten_years.days // 365 [datetime.timedelta[3650], 10] >>> nine_years = ten_years - year >>> nine_years, nine_years.days // 365 [datetime.timedelta[3285], 9] >>> three_years = nine_years // 3; >>> three_years, three_years.days // 365 [datetime.timedelta[1095], 3] >>> abs[three_years - ten_years] == 2 * three_years + year True
8. 1. 3. ngày Đối tượng¶
A date đại diện cho một ngày [năm, tháng và ngày] trong lịch lý tưởng hóa, lịch Gregorian hiện tại kéo dài vô tận theo cả hai hướng. Ngày 1 tháng 1 của năm 1 được gọi là ngày 1, ngày 2 tháng 1 của năm 1 được gọi là ngày 2, v.v. Điều này phù hợp với định nghĩa của lịch “proleptic Gregorian” trong cuốn sách Tính toán Lịch của Dershowitz và Reingold, trong đó nó là lịch cơ sở cho tất cả các phép tính. See the book for algorithms for converting between proleptic Gregorian ordinals and many other calendar systems.
ngày giờ học. ngày [năm, tháng, ngày]¶Tất cả các đối số là bắt buộc. Các đối số có thể là số nguyên, trong các phạm vi sau
- MINYEAR > from datetime import date
>>> today = date.today[]
>>> today
datetime.date[2007, 12, 5]
>>> today == date.fromtimestamp[time.time[]]
True
>>> my_birthday = date[today.year, 6, 24]
>>> if my_birthday >> my_birthday
datetime.date[2008, 6, 24]
>>> time_to_birthday = abs[my_birthday - today]
>>> time_to_birthday.days
202
Example of working with date .
>>> from datetime import date >>> d = date.fromordinal[730920] # 730920th day after 1. 1. 0001 >>> d datetime.date[2002, 3, 11] >>> t = d.timetuple[] >>> for i in t: .. print[i] 2002 # year 3 # month 11 # day 0 0 0 0 # weekday [0 = Monday] 70 # 70th day in the year -1 >>> ic = d.isocalendar[] >>> for i in ic: .. print[i] 2002 # ISO year 11 # ISO week number 1 # ISO day number [ 1 = Monday ] >>> d.isoformat[] '2002-03-11' >>> d.strftime["%d/%m/%y"] '11/03/02' >>> d.strftime["%A %d. %B %Y"] 'Monday 11. March 2002' >>> 'The {1} is {0:%d}, the {2} is {0:%B}.'.format[d, "day", "month"] 'The day is 11, the month is March.'
8. 1. 4. datetime Objects¶
A datetime object is a single object containing all the information from a date object and a time object. Like a date object, datetime assumes the current Gregorian calendar extended in both directions; like a time object, datetime assumes there are exactly 3600*24 seconds in every day.
Constructor
class datetime. datetime[year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None]¶The year, month and day arguments are required. tzinfo may be None , or an instance of a tzinfo subclass. The remaining arguments may be integers, in the following ranges.
- MINYEAR
- MINYEAR