Mặc dù số học ngày và giờ được hỗ trợ, trọng tâm của việc triển khai là trích xuất thuộc tính hiệu quả để định dạng và thao tác đầu ra
Xem thêm
mô-đunGeneral calendar related functions
mô-đunTime access and conversions
mô-đunConcrete time zones representing the IANA time zone database
Package dateutilThird-party library with expanded time zone and parsing support
Aware and Naive Objects
Date and time objects may be categorized as “aware” or “naive” depending on whether or not they include timezone information
With sufficient knowledge of applicable algorithmic and political time adjustments, such as time zone and daylight saving time information, an aware object can locate itself relative to other aware objects. An aware object represents a specific moment in time that is not open to interpretation.
A naive object does not contain enough information to unambiguously locate itself relative to other date/time objects. Whether a naive object represents Coordinated Universal Time [UTC], local time, or time in some other timezone is purely up to the program, just like it is up to the program whether a particular number represents metres, miles, or mass. Naive objects are easy to understand and to work with, at the cost of ignoring some aspects of reality
For applications requiring aware objects, and objects have an optional time zone information attribute,
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'4, that can be set to an instance of a subclass of the abstract class. These objects capture information about the offset from UTC time, the time zone name, and whether daylight saving time is in effect
Only one concrete class, the class, is supplied by the module. The class can represent simple timezones with fixed offsets from UTC, such as UTC itself or North American EST and EDT timezones. Supporting timezones at deeper levels of detail is up to the application. The rules for time adjustment across the world are more political than rational, change frequently, and there is no standard suitable for every application aside from UTC
Constants
The module exports the following constants
datetime. MINYEARThe smallest year number allowed in a or object. is
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.05datetime. MAXYEAR
The largest year number allowed in a or object. is
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.09datetime. UTC
Alias for the UTC timezone singleton
New in version 3. 11
Available Types
class datetime. dateAn idealized naive date, assuming the current Gregorian calendar always was, and always will be, in effect. Attributes. , , and
class datetime. timeAn idealized time, independent of any particular day, assuming that every day has exactly 24*60*60 seconds. [There is no notion of “leap seconds” here. ] Attributes. , , , , and
class datetime. ngày giờA combination of a date and a time. Attributes. , , , , , , , và
class datetime. timedeltaA duration expressing the difference between two , , or instances to microsecond resolution
class datetime. tzinfoAn abstract base class for time zone information objects. These are used by the and classes to provide a customizable notion of time adjustment [for example, to account for time zone and/or daylight saving time]
class datetime. timezoneA class that implements the abstract base class as a fixed offset from the UTC
Mới trong phiên bản 3. 2
Objects of these types are immutable
Subclass relationships
object timedelta tzinfo timezone time date datetime
Common Properties
The , , , and types share these common features
Objects of these types are immutable
Objects of these types are hashable, meaning that they can be used as dictionary keys
Objects of these types support efficient pickling via the module
Xác định xem một đối tượng là Aware hay Naive
Các đối tượng thuộc loại luôn ngây thơ
Một đối tượng thuộc loại hoặc có thể nhận thức hoặc ngây thơ
Một đối tượng d nhận biết nếu cả hai điều sau đây đều đúng
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
02 không phải là>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
03>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
04 không trở lại>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
03
Mặt khác, d là ngây thơ
Một đối tượng t nhận biết nếu cả hai điều sau đây giữ
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
07 không phải là>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
03>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
09 không trở lại>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
03
Nếu không, t là ngây thơ
Sự khác biệt giữa nhận thức và ngây thơ không áp dụng cho các đối tượng
Các đối tượng
Một đối tượng đạ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
lớp ngày giờ. timedelta[ngày=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à
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]14. Arguments may be integers or floats, and may be positive or negative
Only days, seconds and microseconds are stored internally. Arguments are converted to those units
A millisecond is converted to 1000 microseconds
A minute is converted to 60 seconds
Một giờ được chuyển đổi thành 3600 giây
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
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
15>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
16 [số giây trong một ngày]>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
17
Ví dụ sau đây minh họa cách mọi đối số ngoài ngày, giây và micro giây được “hợp nhất” và chuẩn hóa thành ba thuộc tính kết quả đó
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
Nếu bất kỳ đối số nào là số float và có micro giây phân số, thì micro giây phân số còn lại từ tất cả các đối số sẽ được kết hợp và tổng của chúng được làm tròn đến micro giây gần nhất bằng cách sử dụng bộ ngắt kết nối từ nửa vòng đến chẵn. Nếu không có đối số nào là float, quá trình chuyển đổi và chuẩn hóa là chính xác [không có thông tin nào bị mất]
Nếu giá trị chuẩn hóa của ngày nằm ngoài phạm vi được chỉ định, được tăng lên
Lưu ý rằng việc chuẩn hóa các giá trị âm lúc đầu có thể gây ngạc nhiên. Ví dụ
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
Thuộc tính lớp
đồng bằng thời gian. phútĐối tượng tiêu cực nhất,
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]20đồng bằng thời gian. tối đa
Đối tượng tích cực nhất,
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]22đồng bằng thời gian. độ phân giải
Sự khác biệt nhỏ nhất có thể giữa các đối tượng không bằng nhau,
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]24
Lưu ý rằng, do chuẩn hóa,
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]25 >
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]26.
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]27 không thể biểu diễn như một đối tượng
Thuộc tính phiên bản [chỉ đọc]
Thuộc tính
Giá trị
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]29
Giữa -999999999 và bao gồm cả 999999999
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]30
Bao gồm từ 0 đến 86399
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]31
Bao gồm từ 0 đến 999999
hoạt động được hỗ trợ
Hoạt động
Kết quả
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]32
Tổng của t2 và t3. Sau đó t1-t2 == t3 và t1-t3 == t2 là đúng. [1]
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]33
Sự khác biệt của t2 và t3. Sau đó t1 == t2 - t3 và t2 == t1 + t3 là đúng. [1][6]
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]34
Delta nhân với một số nguyên. Sau đó t1 // i == t2 là đúng, với điều kiện là
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]35
Nói chung, t1 * i == t1 * [i-1] + t1 là đúng. [1]
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]36
Delta nhân với một số float. Kết quả được làm tròn đến bội số gần nhất của timedelta. độ phân giải sử dụng nửa vòng đến chẵn
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]37
Chia [3] tổng thời lượng t2 cho đơn vị khoảng thời gian t3. Trả về một đối tượng
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]39
Delta chia cho float hoặc int. Kết quả được làm tròn đến bội số gần nhất của timedelta. độ phân giải sử dụng nửa vòng đến chẵn
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]40 hoặc
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]41
Sàn được tính và phần còn lại [nếu có] bị vứt đi. Trong trường hợp thứ hai, một số nguyên được trả về. [3]
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]42
Phần còn lại được tính như một đối tượng. [3]
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]44
Tính thương và số dư.
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]45 [3] và
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]46. q là một số nguyên và r là một đối tượng
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]48
Trả về một đối tượng có cùng giá trị. [2]
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]50
tương đương với [-t1. days, -t1. giây, -t1. micro giây] và đến t1* -1. [1][4]
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]52
tương đương với +t khi
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]53, và với -t khi
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]54. [2]
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]55
Trả về một chuỗi ở dạng
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]56, trong đó D là số âm cho số âm của
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]57. [5]
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]58
Trả về một biểu diễn chuỗi của đối tượng dưới dạng lệnh gọi hàm tạo với các giá trị thuộc tính chuẩn
ghi chú
Điều này là chính xác nhưng có thể tràn
Điều này là chính xác và không thể tràn
Chia cho 0 tăng
-timedelta. max không thể biểu diễn dưới dạng đối tượng
Biểu diễn chuỗi của các đối tượng được chuẩn hóa tương tự như biểu diễn bên trong của chúng. Điều này dẫn đến kết quả hơi bất thường đối với timedelta âm. Ví dụ
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:00
Biểu thức
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
63 sẽ luôn bằng biểu thức>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
64 trừ khi t3 bằng với>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
25;
Ngoài các hoạt động được liệt kê ở trên, các đối tượng hỗ trợ một số phép cộng và phép trừ với và đối tượng [xem bên dưới]
Đã thay đổi trong phiên bản 3. 2. Phép chia tầng và phép chia thực sự của một đối tượng cho một đối tượng khác hiện đã được hỗ trợ, cũng như các phép toán còn lại và hàm. Phép chia thực sự và phép nhân của một đối tượng với một đối tượng hiện được hỗ trợ.
So sánh các đối tượng được hỗ trợ, với một số lưu ý
Các phép so sánh
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]75 hoặc
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]76 luôn trả về a , bất kể loại đối tượng được so sánh
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False
Đối với tất cả các phép so sánh khác [chẳng hạn như
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]78 và
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]79], khi một đối tượng được so sánh với một đối tượng thuộc loại khác, sẽ được nâng lên
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
Trong ngữ cảnh Boolean, một đối tượng được coi là đúng khi và chỉ khi nó không bằng
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]83
Phương thức sơ thẩm
đồng bằng thời gian. total_seconds[]Trả về tổng số giây có trong khoảng thời gian. Tương đương với
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]84. Đối với các đơn vị khoảng thời gian không phải là giây, hãy sử dụng biểu mẫu chia trực tiếp [e. g.
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]85]
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ụ về cách sử dụng.
Một ví dụ bổ sung về chuẩn hóa
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.0
Ví dụ về số học
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]
Các đối tượng
Một đối tượng đạ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 được mở rộng vô thời hạ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.
lớp ngày giờ. date[year , month , day]Tất cả các đối số là bắt buộc. Các đối số phải là số nguyên, trong các phạm vi sau
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
90>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
91>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
92
Nếu một đối số bên ngoài các phạm vi được đưa ra, được nâng lên
Các hàm tạo khác, tất cả các phương thức của lớp
phương thức lớp ngày. hôm nay[]Trả về ngày địa phương hiện tại
Điều này tương đương với
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]94phương thức lớp ngày. dấu thời gian từ[dấu thời gian]
Trả về ngày địa phương tương ứng với dấu thời gian POSIX, chẳng hạn như được trả về bởi
Điều này có thể tăng , nếu dấu thời gian nằm ngoài phạm vi giá trị được hỗ trợ bởi hàm
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]97 của nền tảng và khi
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]97 thất bại. Điều này thường bị giới hạn trong các năm từ 1970 đến 2038. Lưu ý rằng trên các hệ thống không phải POSIX bao gồm các giây nhuận trong khái niệm dấu thời gian, các giây nhuận bị bỏ qua bởi
Đã thay đổi trong phiên bản 3. 3. Tăng thay vì nếu dấu thời gian nằm ngoài phạm vi giá trị được hỗ trợ bởi hàm C
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]97 của nền tảng. Tăng thay vì trên
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]97 thất bại. phương thức lớp ngày. từ thứ tự[thứ tự]
Trả về ngày tương ứng với thứ tự Gregorian proleptic, trong đó ngày 1 tháng 1 của năm 1 có thứ tự 1
được nâng lên trừ khi
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]08. Đối với bất kỳ ngày d,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]09phương thức lớp ngày. fromisoformat[date_string]
Trả về một tương ứng với một chuỗi_ngày được cung cấp ở bất kỳ định dạng ISO 8601 hợp lệ nào, ngoại trừ các ngày thứ tự [e. g.
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]11]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
Mới trong phiên bản 3. 7
Đã thay đổi trong phiên bản 3. 11. Trước đây, phương thức này chỉ hỗ trợ định dạng
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]12. phương thức lớp ngày. từ dương lịch[năm , tuần, day]
Trả về một tương ứng với ngày theo lịch ISO được chỉ định theo năm, tuần và ngày. Đây là nghịch đảo của hàm
Mới trong phiên bản 3. 8
Thuộc tính lớp
ngày. phútNgày đại diện sớm nhất,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]15ngày. tối đa
Ngày đại diện mới nhất,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]16ngày. độ phân giải
Sự khác biệt nhỏ nhất có thể giữa các đối tượng ngày không bằng nhau,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]17
Thuộc tính phiên bản [chỉ đọc]
ngày. nămBetween and inclusive
ngày. thángTừ 1 đến 12 bao gồm
ngày. ngàyGiữa 1 và số ngày trong tháng nhất định của năm nhất định
hoạt động được hỗ trợ
Hoạt động
Kết quả
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]20
ngày2 sẽ là
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]21 ngày sau ngày1. [1]
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]22
Tính date2 sao cho
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]23. [2]
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]24
[3]
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]25
date1 được coi là nhỏ hơn date2 khi date1 trước date2 về thời gian. [4]
ghi chú
date2 được di chuyển về phía trước theo thời gian nếu
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
26 hoặc lùi lại nếu>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
27. Sau đó>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
28.>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
29 và>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
30 bị bỏ qua. được nâng lên nếu>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
32 sẽ nhỏ hơn hoặc lớn hơn>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
29 và>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
30 bị bỏ quaĐiều này là chính xác và không thể tràn. múi giờ. giây và timedelta. micro giây là 0 và date2 + timedelta == date1 sau
Nói cách khác,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
25 khi và chỉ khi>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
38. So sánh ngày tăng lên nếu so sánh khác cũng không phải là một đối tượng. Tuy nhiên, thay vào đó,>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
41 được trả về nếu đối tượng so sánh khác có thuộc tính>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
42. Móc này cung cấp cho các loại đối tượng ngày khác cơ hội thực hiện so sánh kiểu hỗn hợp. Nếu không, khi một đối tượng được so sánh với một đối tượng thuộc loại khác, sẽ được nâng lên trừ khi so sánh là>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
75 hoặc>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
76. Các trường hợp sau trả về hoặc , tương ứng
Trong ngữ cảnh Boolean, tất cả các đối tượng được coi là đúng
Phương thức sơ thẩm
ngày. thay thế[năm=chính mình. năm , tháng=mình. tháng , ngày=chính mình. ngày]Trả về một ngày có cùng giá trị, ngoại trừ các tham số được cung cấp giá trị mới theo bất kỳ đối số từ khóa nào được chỉ định
Thí dụ
>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]ngày. thời gian[]
Return a such as returned by
Giờ, phút và giây là 0 và cờ DST là -1
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]52 tương đương với
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]0
trong đó
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]53 là số ngày trong năm hiện tại bắt đầu bằng
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.05 cho ngày 1 tháng 1ngày. bình thường[]
Trả về thứ tự Gregorian proleptic của ngày, trong đó ngày 1 tháng 1 của năm 1 có thứ tự 1. Đối với bất kỳ đối tượng d,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]09ngày. ngày trong tuần[]
Trả về ngày trong tuần dưới dạng số nguyên, trong đó Thứ Hai là 0 và Chủ nhật là 6. Ví dụ,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]57, Thứ Tư. Xem thêmngày. ngày trong tuần[]
Trả về ngày trong tuần dưới dạng số nguyên, trong đó Thứ Hai là 1 và Chủ Nhật là 7. Ví dụ,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]59, Thứ Tư. Xem thêm ,ngày. isocalendar[]
Trả về một đối tượng có ba thành phần.
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]1,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]63 và
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]64
Lịch ISO là một biến thể được sử dụng rộng rãi của lịch Gregorian.
Năm ISO bao gồm 52 hoặc 53 tuần đầy đủ và trong đó một tuần bắt đầu vào Thứ Hai và kết thúc vào Chủ nhật. Tuần đầu tiên của một năm ISO là tuần dương lịch [Gregorian] đầu tiên của một năm có ngày thứ Năm. Đây được gọi là tuần số 1 và năm ISO của ngày thứ Năm đó giống với năm Gregorian của nó
Ví dụ: năm 2004 bắt đầu vào Thứ Năm, vì vậy tuần đầu tiên của năm ISO 2004 bắt đầu vào Thứ Hai, ngày 29 tháng 12 năm 2003 và kết thúc vào Chủ Nhật, ngày 4 tháng 1 năm 2004
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]1
Đã thay đổi trong phiên bản 3. 9. Kết quả đã thay đổi từ một bộ thành một.
ngày. isoformat[]Trả về một chuỗi đại diện cho ngày ở định dạng ISO 8601,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]12
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]2ngày. __str__[]
Đối với một ngày d,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]66 tương đương với
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]67ngày. thời gian[]
Trả về một chuỗi đại diện cho ngày
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]3
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]68 tương đương với
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]4
trên các nền tảng có chức năng C
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]69 gốc [gọi, nhưng không gọi] tuân theo tiêu chuẩn Cngày. thời gian chạy[định dạng]
Trả về một chuỗi đại diện cho ngày, được kiểm soát bởi một chuỗi định dạng rõ ràng. Mã định dạng đề cập đến giờ, phút hoặc giây sẽ thấy 0 giá trị. Để biết danh sách đầy đủ các chỉ thị định dạng, hãy xem
ngày. __format__[định dạng]Giống như. Điều này giúp có thể chỉ định một chuỗi định dạng cho một đối tượng trong và khi sử dụng. For a complete list of formatting directives, see
Ví dụ về cách sử dụng.
Ví dụ về đếm số ngày đến một sự kiện
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]5
Thêm ví dụ về làm việc với
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]6
Các đối tượng
Một đối tượng là một đối tượng duy nhất chứa tất cả thông tin từ một đối tượng và một đối tượng
Giống như một đối tượng, giả sử lịch Gregorian hiện tại được mở rộng theo cả hai hướng;
Hàm tạo
lớp ngày giờ. ngày giờ[năm , tháng, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0]The year, month and day arguments are required. tzinfo may be
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, or an instance of a subclass. The remaining arguments must be integers in the following ranges
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
90,>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
91,>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
92,>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
90,>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
91,>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
92,>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
93,>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
94
Nếu một đối số bên ngoài các phạm vi được đưa ra, được nâng lên
New in version 3. 6. Added the
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]96 argument.
Các hàm tạo khác, tất cả các phương thức của lớp
classmethod datetime. today[]Return the current local datetime, with
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03
Equivalent to
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]7
Xem thêm ,
Phương thức này có chức năng tương đương với , nhưng không có tham số
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0002phương thức lớp ngày giờ. bây giờ[tz=Không]
Trả về ngày và giờ địa phương hiện tại
Nếu đối số tùy chọn tz là
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 hoặc không được chỉ định, thì điều này giống như , nhưng, nếu có thể, cung cấp độ chính xác cao hơn mức có thể nhận được từ việc xem xét dấu thời gian [ví dụ: điều này có thể thực hiện được trên các nền tảng cung cấp hàm C
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0006]
Nếu tz không phải là
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, thì nó phải là một thể hiện của một lớp con và ngày giờ hiện tại được chuyển đổi thành múi giờ của tz
Chức năng này được ưa thích hơn và
phương thức lớp ngày giờ. utcnow[]Trả về ngày và giờ UTC hiện tại, với
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03
Điều này giống như, nhưng trả về ngày và giờ UTC hiện tại, dưới dạng một đối tượng ngây thơ. Có thể nhận được thời gian UTC hiện tại đã biết bằng cách gọi
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0015. Xem thêm
Cảnh báo
Bởi vì các đối tượng
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False7 ngây thơ được nhiều phương thức
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False7 coi là giờ địa phương, nên sử dụng thời gian nhận biết để biểu thị thời gian theo UTC. Như vậy, cách được đề xuất để tạo một đối tượng biểu thị thời gian hiện tại theo UTC là gọi số
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0015phương thức lớp ngày giờ. dấu thời gian từ[dấu thời gian , tz=None]
Trả về ngày và giờ cục bộ tương ứng với dấu thời gian POSIX, chẳng hạn như được trả về bởi. Nếu đối số tùy chọn tz là
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 hoặc không được chỉ định, thì dấu thời gian được chuyển đổi thành ngày giờ địa phương của nền tảng và đối tượng được trả về là ngây thơ
Nếu tz không phải là
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, nó phải là một thể hiện của một lớp con và dấu thời gian được chuyển đổi thành múi giờ của tz
có thể tăng , nếu dấu thời gian nằm ngoài phạm vi giá trị được hỗ trợ bởi các hàm C
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]97 hoặc
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0028 của nền tảng và trên
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]97 hoặc
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0028 không thành công. Điều này thường bị giới hạn trong các năm từ 1970 đến 2038. Lưu ý rằng trên các hệ thống không phải POSIX bao gồm giây nhuận trong khái niệm dấu thời gian, giây nhuận bị bỏ qua bởi , và sau đó có thể có hai dấu thời gian khác nhau một giây tạo ra các đối tượng giống hệt nhau. Phương pháp này được ưa chuộng hơn
Đã thay đổi trong phiên bản 3. 3. Raise instead of if the timestamp is out of the range of values supported by the platform C
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]97 or
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0028 functions. Tăng thay vì khi thất bại
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]97 hoặc
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0028.
Đã thay đổi trong phiên bản 3. 6. có thể trả về các trường hợp được đặt thành 1.
phương thức lớp ngày giờ. utcfromtimestamp[dấu thời gian]Trả lại UTC tương ứng với dấu thời gian POSIX, với
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03. [Đối tượng kết quả là ngây thơ. ]
Điều này có thể tăng , nếu dấu thời gian nằm ngoài phạm vi giá trị được hỗ trợ bởi hàm
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0028 của nền tảng và khi
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0028 thất bại. Điều này thường bị giới hạn trong các năm từ 1970 đến 2038
Để có được một đối tượng nhận thức, hãy gọi
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]8
Trên nền tảng tuân thủ POSIX, nó tương đương với biểu thức sau
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]9
ngoại trừ công thức sau luôn hỗ trợ phạm vi năm đầy đủ. giữa và bao gồm
Cảnh báo
Bởi vì các đối tượng
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False7 ngây thơ được nhiều phương thức
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False7 coi là giờ địa phương, nên sử dụng thời gian nhận biết để biểu thị thời gian theo UTC. Như vậy, cách được đề xuất để tạo một đối tượng đại diện cho một dấu thời gian cụ thể trong UTC là gọi số
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0058
Đã thay đổi trong phiên bản 3. 3. Tăng thay vì nếu dấu thời gian nằm ngoài phạm vi giá trị được hỗ trợ bởi hàm C
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0028 của nền tảng. Tăng thay vì trên
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0028 thất bại. phương thức lớp ngày giờ. từ thứ tự[thứ tự]
Trả về tương ứng với thứ tự Gregorian proleptic, trong đó ngày 1 tháng 1 của năm 1 có thứ tự 1. được nâng lên trừ khi
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0067. Giờ, phút, giây và micro giây của kết quả đều bằng 0 và là
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03phương thức lớp ngày giờ. kết hợp[ngày , thời gian . tzinfo, tzinfo=self.tzinfo]
Trả về một đối tượng mới có các thành phần ngày bằng với đối tượng đã cho và có thành phần thời gian bằng với đối tượng đã cho. Nếu đối số tzinfo được cung cấp, giá trị của nó được sử dụng để đặt thuộc tính của kết quả, nếu không thì thuộc tính của đối số thời gian được sử dụng
Đối với bất kỳ đối tượng d,
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0076. Nếu ngày là một đối tượng, các thành phần và thuộc tính thời gian của nó sẽ bị bỏ qua
Đã thay đổi trong phiên bản 3. 6. Đã thêm đối số tzinfo.
phương thức lớp ngày giờ. fromisoformat[date_string]Trả về một tương ứng với một chuỗi ngày ở bất kỳ định dạng ISO 8601 hợp lệ nào, với các ngoại lệ sau
Độ lệch múi giờ có thể có giây phân số
Dấu phân cách
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:00
80 có thể được thay thế bằng bất kỳ ký tự unicode nàoNgày thứ tự hiện không được hỗ trợ
Giờ và phút phân số không được hỗ trợ
ví dụ
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]0
Mới trong phiên bản 3. 7
Đã thay đổi trong phiên bản 3. 11. Trước đây, phương pháp này chỉ hỗ trợ các định dạng có thể được phát ra bởi hoặc.
phương thức lớp ngày giờ. từ dương lịch[năm , tuần, day]Trả về một tương ứng với ngày theo lịch ISO được chỉ định theo năm, tuần và ngày. Các thành phần không phải ngày tháng của ngày giờ được điền bằng các giá trị mặc định bình thường của chúng. Đây là nghịch đảo của hàm
Mới trong phiên bản 3. 8
classmethod datetime. strptime[date_string , định dạng]Trả về tương ứng với date_string, được phân tích cú pháp theo định dạng
Điều này tương đương với
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]1
được nâng lên nếu không thể phân tích cú pháp chuỗi ngày và định dạng hoặc nếu nó trả về một giá trị không phải là bộ thời gian. Để biết danh sách đầy đủ các chỉ thị định dạng, hãy xem
Thuộc tính lớp
ngày giờ. phútĐại diện sớm nhất ,
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0089ngày giờ. tối đa
Đại diện mới nhất ,
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0091ngày giờ. độ phân giải
Sự khác biệt nhỏ nhất có thể giữa các đối tượng không bằng nhau,
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]24
Thuộc tính phiên bản [chỉ đọc]
ngày giờ. yearBetween and inclusive
datetime. monthTừ 1 đến 12 bao gồm
datetime. dayGiữa 1 và số ngày trong tháng nhất định của năm nhất định
datetime. hourIn
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0096datetime. minute
In
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0097datetime. second
In
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0097datetime. microsecond
In
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0099datetime. tzinfo
The object passed as the tzinfo argument to the constructor, or
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 if none was passeddatetime. fold
In
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False02. Used to disambiguate wall times during a repeated interval. [A repeated interval occurs when clocks are rolled back at the end of daylight saving time or when the UTC offset for the current zone is decreased for political reasons. ] The value 0 [1] represents the earlier [later] of the two moments with the same wall time representation
New in version 3. 6
hoạt động được hỗ trợ
Hoạt động
Kết quả
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False03
[1]
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False04
[2]
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False05
[3]
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False06
Compares to . [4]
datetime2 is a duration of timedelta removed from datetime1, moving forward in time if
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
21 > 0, or backward if>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
21 < 0. The result has the same attribute as the input datetime, and datetime2 - datetime1 == timedelta after. is raised if datetime2. year would be smaller than or larger than . Note that no time zone adjustments are done even if the input is an aware objectComputes the datetime2 such that datetime2 + timedelta == datetime1. As for addition, the result has the same attribute as the input datetime, and no time zone adjustments are done even if the input is aware
Subtraction of a from a is defined only if both operands are naive, or if both are aware. If one is aware and the other is naive, is raised
If both are naive, or both are aware and have the same attribute, the attributes are ignored, and the result is a object t such that
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False
22. No time zone adjustments are done in this caseIf both are aware and have different attributes,
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False
24 acts as if a and b were first converted to naive UTC datetimes first. The result is>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False
25 except that the implementation never overflowsdatetime1 is considered less than datetime2 when datetime1 precedes datetime2 in time
If one comparand is naive and the other is aware, is raised if an order comparison is attempted. For equality comparisons, naive instances are never equal to aware instances
If both comparands are aware, and have the same attribute, the common attribute is ignored and the base datetimes are compared. If both comparands are aware and have different attributes, the comparands are first adjusted by subtracting their UTC offsets [obtained from
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False
30]Changed in version 3. 3. Equality comparisons between aware and naive instances don’t raise .
Note
In order to stop comparison from falling back to the default scheme of comparing object addresses, datetime comparison normally raises if the other comparand isn’t also a object. However,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
41 is returned instead if the other comparand has a>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
42 attribute. This hook gives other kinds of date objects a chance at implementing mixed-type comparison. If not, when a object is compared to an object of a different type, is raised unless the comparison is>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
75 or>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
76. The latter cases return or , respectively
Phương thức sơ thẩm
datetime. date[]Return object with same year, month and day
datetime. time[]Return object with same hour, minute, second, microsecond and fold. is
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03. See also method
Changed in version 3. 6. The fold value is copied to the returned object.
datetime. timetz[]Return object with same hour, minute, second, microsecond, fold, and tzinfo attributes. See also method
Changed in version 3. 6. The fold value is copied to the returned object.
datetime. replace[year=self. year , month=self. month , day=self. day , hour=self. hour , minute=self. minute , second=self. second , microsecond=self. microsecond , tzinfo=self. tzinfo , * , fold=0]Return a datetime with the same attributes, except for those attributes given new values by whichever keyword arguments are specified. Note that
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False52 can be specified to create a naive datetime from an aware datetime with no conversion of date and time data
New in version 3. 6. Added the
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]96 argument. datetime. astimezone[tz=None]
Return a object with new attribute tz, adjusting the date and time data so the result is the same UTC time as self, but in tz’s local time
If provided, tz must be an instance of a subclass, and its and methods must not return
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03. If self is naive, it is presumed to represent time in the system timezone
If called without arguments [or with
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False60] the system local timezone is assumed for the target timezone. The
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False61 attribute of the converted datetime instance will be set to an instance of with the zone name and offset obtained from the OS
If
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False63 is tz,
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False64 is equal to self. no adjustment of date or time data is performed. Else the result is local time in the timezone tz, representing the same UTC time as self. after
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False65,
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False66 will have the same date and time data as
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False67
If you merely want to attach a time zone object tz to a datetime dt without adjustment of date and time data, use
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False68. If you merely want to remove the time zone object from an aware datetime dt without conversion of date and time data, use
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False69
Note that the default method can be overridden in a subclass to affect the result returned by . Ignoring error cases, acts like
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]2
Changed in version 3. 3. tz now can be omitted.
Changed in version 3. 6. The method can now be called on naive instances that are presumed to represent system local time.
datetime. utcoffset[]If is
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, returns
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, else returns
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False78, and raises an exception if the latter doesn’t return
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 or a object with magnitude less than one day
Changed in version 3. 7. The UTC offset is not restricted to a whole number of minutes.
datetime. dst[]Nếu là
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, trả về
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, nếu không thì trả về
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False84 và đưa ra một ngoại lệ nếu cái sau không trả về
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 hoặc một đối tượng có cường độ nhỏ hơn một ngày
Changed in version 3. 7. The DST offset is not restricted to a whole number of minutes.
datetime. tzname[]If is
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, returns
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, else returns
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False90, raises an exception if the latter doesn’t return
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 or a string object,datetime. timetuple[]
Return a such as returned by
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]52 tương đương với
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]3
where
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]53 is the day number within the current year starting with
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.05 for January 1st. The
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False97 flag of the result is set according to the method. is
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 or returns
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03,
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False97 is set to
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'04; else if returns a non-zero value,
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False97 is set to
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.05; else
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False97 is set to
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]14datetime. utctimetuple[]
If instance d is naive, this is the same as
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]52 except that
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False97 is forced to 0 regardless of what
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'13 returns. DST is never in effect for a UTC time
If d is aware, d is normalized to UTC time, by subtracting
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'14, and a for the normalized time is returned.
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False97 is forced to 0. Note that an may be raised if d. year was
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.04 or
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.08 and UTC adjustment spills over a year boundary
Cảnh báo
Because naive
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False7 objects are treated by many
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False7 methods as local times, it is preferred to use aware datetimes to represent times in UTC; as a result, using
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'22 may give misleading results. If you have a naive
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False7 representing UTC, use
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'24 to make it aware, at which point you can use datetime. toordinal[]
Return the proleptic Gregorian ordinal of the date. The same as
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'26datetime. timestamp[]
Return POSIX timestamp corresponding to the instance. The return value is a similar to that returned by
Naive instances are assumed to represent local time and this method relies on the platform C
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'31 function to perform the conversion. Since supports wider range of values than
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'31 on many platforms, this method may raise for times far in the past or far in the future
For aware instances, the return value is computed as
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]4
New in version 3. 3
Changed in version 3. 6. The method uses the attribute to disambiguate the times during a repeated interval.
Note
There is no method to obtain the POSIX timestamp directly from a naive instance representing UTC time. If your application uses this convention and your system timezone is not set to UTC, you can obtain the POSIX timestamp by supplying
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'39
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]5
or by calculating the timestamp directly
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]6datetime. weekday[]
Return the day of the week as an integer, where Monday is 0 and Sunday is 6. The same as
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'40. See also datetime. isoweekday[]
Return the day of the week as an integer, where Monday is 1 and Sunday is 7. The same as
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'42. See also , datetime. isocalendar[]
Return a with three components.
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]1,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]63 and
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]64. The same as
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'48datetime. isoformat[sep='T' , timespec='auto']
Return a string representing the date and time in ISO 8601 format
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
49, if is not 0>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
51, if is 0
If does not return
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, a string is appended, giving the UTC offset
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
55, if is not 0>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
57, if is 0
ví dụ
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]7
The optional argument sep [default
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'59] is a one-character separator, placed between the date and time portions of the result. For example
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]8
The optional argument timespec specifies the number of additional components of the time to include [the default is
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'60]. It can be one of the following
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
60. Same as>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
62 if is 0, same as>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
64 otherwise>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
65. Include the in the two-digit>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
67 format>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
68. Include and in>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
71 format>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
62. Include , , and in>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
76 format>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
77. Include full time, but truncate fractional second part to milliseconds.>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
78 format>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
64. Include full time in>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
80 format
Note
Excluded time components are truncated, not rounded
will be raised on an invalid timespec argument
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]9
New in version 3. 6. Added the timespec argument.
datetime. __str__[]For a instance d,
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]66 is equivalent to
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'84datetime. ctime[]
Return a string representing the date and time
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:000
The output string will not include time zone information, regardless of whether the input is aware or naive
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]68 tương đương với
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]4
trên các nền tảng có chức năng C
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]69 gốc [gọi, nhưng không gọi] tuân theo tiêu chuẩn Cdatetime. strftime[format]
Return a string representing the date and time, controlled by an explicit format string. For a complete list of formatting directives, see
ngày giờ. __format__[format]Giống như. Điều này giúp có thể chỉ định một chuỗi định dạng cho một đối tượng trong và khi sử dụng. For a complete list of formatting directives, see
Ví dụ về cách sử dụng.
Examples of working with objects
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:002
The example below defines a subclass capturing time zone information for Kabul, Afghanistan, which used +4 UTC until 1945 and then +4. 30 UTC thereafter
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:003
Usage of
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'95 from above
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:004
Các đối tượng
A object represents a [local] time of day, independent of any particular day, and subject to adjustment via a object
class datetime. time[hour=0 , minute=0 , second=0 , microsecond=0 , tzinfo=None , * , fold=0]Tất cả các đối số là tùy chọn. tzinfo có thể là
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 hoặc một thể hiện của lớp con. Các đối số còn lại phải là số nguyên trong các phạm vi sau
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
90,>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
91,>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
92,>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
93,>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]
94
Nếu một đối số bên ngoài các phạm vi được đưa ra, được nâng lên. Tất cả mặc định là
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]14 ngoại trừ tzinfo, mặc định là
Thuộc tính lớp
thời gian. phútĐại diện sớm nhất,
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.010thời gian. tối đa
Đại diện mới nhất ,
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.012thời gian. độ phân giải
Sự khác biệt nhỏ nhất có thể giữa các đối tượng không bằng nhau,
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]24, mặc dù lưu ý rằng số học trên các đối tượng không được hỗ trợ
Thuộc tính phiên bản [chỉ đọc]
thời gian. giờIn
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0096thời gian. phút
In
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0097thời gian. giây
In
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0097thời gian. micro giây
In
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:0099thời gian. tzinfo
The object passed as the tzinfo argument to the constructor, or
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 if none was passedthời gian. gấp
In
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False02. Used to disambiguate wall times during a repeated interval. [A repeated interval occurs when clocks are rolled back at the end of daylight saving time or when the UTC offset for the current zone is decreased for political reasons. ] The value 0 [1] represents the earlier [later] of the two moments with the same wall time representation
New in version 3. 6
các đối tượng hỗ trợ so sánh với , trong đó a được coi là nhỏ hơn b khi a đứng trước b về thời gian. Nếu một so sánh là ngây thơ và người kia nhận thức được, sẽ được nâng lên nếu cố gắng so sánh thứ tự. Để so sánh bình đẳng, các trường hợp ngây thơ không bao giờ bằng các trường hợp nhận thức
Nếu cả hai đối tượng so sánh đều nhận biết và có cùng thuộc tính, thuộc tính chung sẽ bị bỏ qua và thời gian cơ sở được so sánh. Nếu cả hai bộ so sánh đều nhận biết và có các thuộc tính khác nhau, thì các bộ so sánh trước tiên được điều chỉnh bằng cách trừ đi độ lệch UTC của chúng [thu được từ
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False30]. Để ngăn các 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 được so sánh với một đối tượng thuộc loại khác, sẽ được nâng lên trừ khi phép so sánh là
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]75 hoặc
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]76. Các trường hợp sau trả về hoặc , tương ứng
Changed in version 3. 3. Equality comparisons between aware and naive instances don’t raise .
Trong ngữ cảnh Boolean, một đối tượng luôn được coi là đúng
Đã thay đổi trong phiên bản 3. 5. Trước Python 3. 5, một đối tượng được coi là sai nếu nó biểu thị nửa đêm theo giờ UTC. Hành vi này được coi là tối nghĩa và dễ bị lỗi và đã bị xóa trong Python 3. 5. Xem bpo-13936 để biết chi tiết đầy đủ.
nhà xây dựng khác
classmethod time. fromisoformat[time_string]Return a corresponding to a time_string in any valid ISO 8601 format, with the following exceptions
Độ lệch múi giờ có thể có giây phân số
The leading
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:00
80, normally required in cases where there may be ambiguity between a date and a time, is not requiredFractional seconds may have any number of digits [anything beyond 6 will be truncated]
Giờ và phút phân số không được hỗ trợ
ví dụ
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:005
Mới trong phiên bản 3. 7
Changed in version 3. 11. Previously, this method only supported formats that could be emitted by .
Phương thức sơ thẩm
time. replace[hour=self. hour , minute=self. minute , second=self. second , microsecond=self. microsecond , tzinfo=self. tzinfo , * , fold=0]Return a with the same value, except for those attributes given new values by whichever keyword arguments are specified. Note that
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False52 can be specified to create a naive from an aware , without conversion of the time data
New in version 3. 6. Added the
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]96 argument. time. isoformat[timespec='auto']
Return a string representing the time in ISO 8601 format, one of
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
80, if is not 0>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
76, if is 0>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.0
53, if does not return>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
03>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.0
56, if is 0 and does not return>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
03
The optional argument timespec specifies the number of additional components of the time to include [the default is
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'60]. It can be one of the following
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
60. Same as>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
62 if is 0, same as>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
64 otherwise>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
65. Include the in the two-digit>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
67 format>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
68. Include and in>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
71 format>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
62. Include , , and in>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
76 format>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
77. Include full time, but truncate fractional second part to milliseconds.>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
78 format>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
64. Include full time in>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
80 format
Note
Excluded time components are truncated, not rounded
will be raised on an invalid timespec argument
Thí dụ
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:006
New in version 3. 6. Added the timespec argument.
time. __str__[]For a time t,
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]55 is equivalent to
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.083time. strftime[format]
Return a string representing the time, controlled by an explicit format string. For a complete list of formatting directives, see
time. __format__[format]Giống như. Điều này giúp có thể chỉ định một chuỗi định dạng cho một đối tượng trong và khi sử dụng. For a complete list of formatting directives, see
time. utcoffset[]If is
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, returns
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, else returns
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.090, and raises an exception if the latter doesn’t return
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 or a object with magnitude less than one day
Changed in version 3. 7. The UTC offset is not restricted to a whole number of minutes.
time. dst[]If is
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, returns
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, else returns
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.096, and raises an exception if the latter doesn’t return
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, or a object with magnitude less than one day
Changed in version 3. 7. The DST offset is not restricted to a whole number of minutes.
time. tzname[]If is
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, returns
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, else returns
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]02, or raises an exception if the latter doesn’t return
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 or a string object
Ví dụ về cách sử dụng.
Examples of working with a object
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:007
Các đối tượng
class datetime. tzinfoThis is an abstract base class, meaning that this class should not be instantiated directly. Define a subclass of to capture information about a particular time zone
An instance of [a concrete subclass of] can be passed to the constructors for and objects. The latter objects view their attributes as being in local time, and the object supports methods revealing offset of local time from UTC, the name of the time zone, and DST offset, all relative to a date or time object passed to them
You need to derive a concrete subclass, and [at least] supply implementations of the standard methods needed by the methods you use. The module provides , a simple concrete subclass of which can represent timezones with fixed offset from UTC such as UTC itself or North American EST and EDT
Special requirement for pickling. A subclass must have an
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]18 method that can be called with no arguments, otherwise it can be pickled but possibly not unpickled again. This is a technical requirement that may be relaxed in the future
A concrete subclass of may need to implement the following methods. Exactly which methods are needed depends on the uses made of aware objects. If in doubt, simply implement all of them
tzinfo. utcoffset[dt]Return offset of local time from UTC, as a object that is positive east of UTC. If local time is west of UTC, this should be negative
This represents the total offset from UTC; for example, if a object represents both time zone and DST adjustments, should return their sum. If the UTC offset isn’t known, return
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03. Else the value returned must be a object strictly between
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]26 and
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]27 [the magnitude of the offset must be less than one day]. Most implementations of will probably look like one of these two
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:008
If does not return
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03, should not return
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 either
Việc thực hiện tăng mặc định
Changed in version 3. 7. The UTC offset is not restricted to a whole number of minutes.
tzinfo. dst[dt]Return the daylight saving time [DST] adjustment, as a object or
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 if DST information isn’t known
Trả lại
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]83 nếu DST không có hiệu lực. If DST is in effect, return the offset as a object [see for details]. Note that DST offset, if applicable, has already been added to the UTC offset returned by , so there’s no need to consult unless you’re interested in obtaining DST info separately. For example, calls its attribute’s method to determine how the
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False97 flag should be set, and calls to account for DST changes when crossing time zones
An instance tz of a subclass that models both standard and daylight times must be consistent in this sense
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]49
must return the same result for every dt with
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]51 For sane subclasses, this expression yields the time zone’s “standard offset”, which should not depend on the date or the time, but only on geographic location. Việc thực hiện ỷ lại vào việc này nhưng không phát hiện được vi phạm; . If a subclass cannot guarantee this, it may be able to override the default implementation of to work correctly with
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False72 regardless
Hầu hết các triển khai có thể sẽ giống như một trong hai
>>> timedelta[hours=-5] datetime.timedelta[days=-1, seconds=68400] >>> print[_] -1 day, 19:00:009
hoặc là
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False0
Việc thực hiện tăng mặc định
Changed in version 3. 7. The DST offset is not restricted to a whole number of minutes.
tzinfo. tzname[dt]Trả về tên múi giờ tương ứng với đối tượng dt, dưới dạng chuỗi. Không có gì về tên chuỗi được xác định bởi mô-đun và không có yêu cầu rằng nó có ý nghĩa cụ thể. Ví dụ: “GMT”, “UTC”, “-500”, “-5. 00”, “EDT”, “US/Eastern”, “America/New York” đều là những câu trả lời hợp lệ. Trả về
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 nếu không biết tên chuỗi. Lưu ý rằng đây chủ yếu là một phương thức chứ không phải là một chuỗi cố định vì một số lớp con sẽ muốn trả về các tên khác nhau tùy thuộc vào giá trị cụ thể của dt được truyền, đặc biệt nếu lớp đó đang tính thời gian ban ngày
Việc thực hiện tăng mặc định
Các phương thức này được gọi bởi một hoặc đối tượng, để đáp lại các phương thức cùng tên của chúng. Một đối tượng chuyển chính nó làm đối số và một đối tượng chuyển
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 làm đối số. Do đó, các phương thức của lớp con nên được chuẩn bị để chấp nhận đối số dt của
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 hoặc của lớp
Khi
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 được thông qua, người thiết kế lớp sẽ quyết định câu trả lời tốt nhất. Ví dụ: trả về
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03 là phù hợp nếu lớp muốn nói rằng các đối tượng thời gian không tham gia vào các giao thức. Có thể hữu ích hơn khi
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]78 trả về phần bù UTC tiêu chuẩn, vì không có quy ước nào khác để khám phá phần bù tiêu chuẩn
Khi một đối tượng được truyền để phản hồi lại một phương thức, thì
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]81 chính là đối tượng như self. các phương thức có thể dựa vào điều này, trừ khi mã người dùng gọi trực tiếp các phương thức. Mục đích là các phương thức diễn giải dt theo giờ địa phương và không cần lo lắng về các đối tượng trong các múi giờ khác
Có một phương thức nữa mà một lớp con có thể muốn ghi đè
tzinfo. từutc[dt]Điều này được gọi từ việc thực hiện mặc định. Khi được gọi từ đó,
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]81 là chính nó và dữ liệu ngày và giờ của dt sẽ được xem là thể hiện thời gian UTC. Mục đích của là điều chỉnh dữ liệu ngày và giờ, trả về một ngày giờ tương đương theo giờ địa phương của chính bạn
Hầu hết các lớp con sẽ có thể kế thừa việc triển khai mặc định mà không gặp sự cố. Nó đủ mạnh để xử lý các múi giờ có độ lệch cố định và các múi giờ chiếm cả thời gian tiêu chuẩn và thời gian ban ngày và cả thời gian sau ngay cả khi thời gian chuyển đổi DST khác nhau trong các năm khác nhau. Một ví dụ về múi giờ mà việc triển khai mặc định có thể không xử lý chính xác trong mọi trường hợp là trường hợp mà độ lệch tiêu chuẩn [từ UTC] phụ thuộc vào ngày và giờ cụ thể đã trôi qua, điều này có thể xảy ra vì lý do chính trị. Việc triển khai mặc định của
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False72 và có thể không tạo ra kết quả bạn muốn nếu kết quả là một trong những giờ diễn ra vào thời điểm giá trị bù tiêu chuẩn thay đổi
Bỏ qua mã cho các trường hợp lỗi, việc triển khai mặc định hoạt động như
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False1
Trong tệp
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]95 sau đây có một số ví dụ về các lớp
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False2
Lưu ý rằng có những sự tinh tế không thể tránh khỏi hai lần mỗi năm trong một phân lớp chiếm cả thời gian tiêu chuẩn và thời gian ban ngày, tại các điểm chuyển tiếp DST. Để cụ thể, hãy xem xét Miền Đông Hoa Kỳ [UTC -0500], nơi EDT bắt đầu sau 1 phút. 59 [EST] vào Chủ nhật thứ hai của tháng 3 và kết thúc vào phút sau 1. 59 [EDT] on the first Sunday in November
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False3
Khi DST bắt đầu [dòng “bắt đầu”], đồng hồ treo tường địa phương nhảy từ 1. 59 đến 3. 00. Một bức tường thời gian của mẫu 2. MM không thực sự có ý nghĩa vào ngày đó, vì vậy
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]98 sẽ không mang lại kết quả với
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]99 vào ngày DST bắt đầu. Ví dụ: tại chuyển tiếp mùa xuân năm 2016, chúng tôi nhận được
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False4
Khi DST kết thúc [dòng “kết thúc”], có khả năng xảy ra sự cố tồi tệ hơn. có một giờ không thể đánh vần rõ ràng theo giờ địa phương. giờ cuối cùng của thời gian ban ngày. Ở phương Đông, đó là thời gian của mẫu 5. MM UTC vào ngày thời gian ban ngày kết thúc. Đồng hồ treo tường địa phương nhảy từ 1. 59 [thời gian ban ngày] trở lại 1. 00 [giờ chuẩn] lại. Giờ địa phương của mẫu 1. MM không rõ ràng.
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False72 bắt chước hành vi của đồng hồ địa phương bằng cách ánh xạ hai giờ UTC liền kề vào cùng một giờ địa phương sau đó. Trong ví dụ phương Đông, thời gian UTC có dạng 5. MM và 6. MM cả ánh xạ tới 1. MM khi được chuyển đổi sang phương Đông, nhưng các lần trước thuộc tính được đặt thành 0 và các lần sau thuộc tính được đặt thành 1. Ví dụ: tại Fall back transition năm 2016, chúng tôi nhận được
>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False5
Lưu ý rằng các trường hợp chỉ khác nhau về giá trị của thuộc tính được coi là bằng nhau khi so sánh
Các ứng dụng không thể chịu được sự mơ hồ về thời gian nên kiểm tra rõ ràng giá trị của thuộc tính hoặc tránh sử dụng các lớp con kết hợp;
Xem thêm
Cơ sở dữ liệu múi giờ IANAMô-đun có một lớp cơ bản [để xử lý các giá trị bù trừ cố định tùy ý từ UTC] và thuộc tính của nó [một thể hiện múi giờ UTC]
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'1 mang cơ sở dữ liệu múi giờ IANA [còn được gọi là cơ sở dữ liệu Olson] cho Python và việc sử dụng cơ sở dữ liệu này được khuyến nghị
Cơ sở dữ liệu múi giờ [thường được gọi là tz, tzdata hoặc zoneinfo] chứa mã và dữ liệu biểu thị lịch sử giờ địa phương cho nhiều vị trí đại diện trên toàn cầu. Nó được cập nhật định kỳ để phản ánh những thay đổi do các cơ quan chính trị thực hiện đối với ranh giới múi giờ, độ lệch UTC và quy tắc tiết kiệm ánh sáng ban ngày
Các đối tượng
Lớp này là một lớp con của , mỗi phiên bản đại diện cho một múi giờ được xác định bởi một phần bù cố định từ UTC
Các đối tượng của lớp này không thể được sử dụng để biểu thị thông tin múi giờ ở những vị trí sử dụng các độ lệch khác nhau trong các ngày khác nhau trong năm hoặc khi các thay đổi lịch sử đã được thực hiện đối với thời gian dân sự
lớp ngày giờ. múi giờ[độ lệch , tên=None]Đối số offset phải được chỉ định làm đối tượng biểu thị sự khác biệt giữa giờ địa phương và UTC. Nó phải hoàn toàn nằm trong khoảng từ
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]26 đến
>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]27, nếu không sẽ được nâng lên
Đối số tên là tùy chọn. Nếu được chỉ định, nó phải là một chuỗi sẽ được sử dụng làm giá trị được trả về bởi phương thức
Mới trong phiên bản 3. 2
Changed in version 3. 7. The UTC offset is not restricted to a whole number of minutes.
múi giờ. utcoffset[dt]Trả về giá trị cố định được chỉ định khi phiên bản được tạo
Đối số dt bị bỏ qua. Giá trị trả về là một ví dụ bằng với sự khác biệt giữa giờ địa phương và UTC
Changed in version 3. 7. The UTC offset is not restricted to a whole number of minutes.
múi giờ. tzname[dt]Trả về giá trị cố định được chỉ định khi phiên bản được tạo
Nếu tên không được cung cấp trong hàm tạo, tên được trả về bởi
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]24 được tạo từ giá trị của
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]25 như sau. Nếu độ lệch là
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]83, tên là “UTC”, nếu không, nó là một chuỗi ở định dạng
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]27, trong đó ± là dấu của
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]25, HH và MM lần lượt là hai chữ số của
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]29 và
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]30
Đã thay đổi trong phiên bản 3. 6. Tên được tạo từ
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]31 bây giờ là
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]32 đơn giản, không phải là
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]33. múi giờ. dst[dt]
Luôn trả về
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]03múi giờ. từutc[dt]
Trả lại
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]35. The dt argument must be an aware instance, with
>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'4 set to
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]38
Thuộc tính lớp
múi giờ. utcMúi giờ UTC,
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]39
>>> from datetime import date
>>> date.fromisoformat['2019-12-04']
datetime.date[2019, 12, 4]
>>> date.fromisoformat['20191204']
datetime.date[2019, 12, 4]
>>> date.fromisoformat['2021-W01-1']
datetime.date[2021, 1, 4]
40 và >>> from datetime import date
>>> date.fromisoformat['2019-12-04']
datetime.date[2019, 12, 4]
>>> date.fromisoformat['20191204']
datetime.date[2019, 12, 4]
>>> date.fromisoformat['2021-W01-1']
datetime.date[2021, 1, 4]
41 Hành vi
, , và các đối tượng đều hỗ trợ phương thức
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]45, để tạo một chuỗi biểu thị thời gian dưới sự kiểm soát của một chuỗi định dạng rõ ràng
Ngược lại, phương thức lớp tạo một đối tượng từ một chuỗi biểu thị ngày giờ và một chuỗi định dạng tương ứng
Bảng dưới đây cung cấp so sánh cấp cao giữa
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]40 so với
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]41
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]50
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]51
Cách sử dụng
Chuyển đổi đối tượng thành một chuỗi theo một định dạng nhất định
Phân tích cú pháp một chuỗi thành một đối tượng có định dạng tương ứng
Loại phương pháp
phương thức sơ thẩm
phương pháp lớp
Phương pháp của
;
Chữ ký
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]45
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]58
Mã định dạng >>> from datetime import date
>>> date.fromisoformat['2019-12-04']
datetime.date[2019, 12, 4]
>>> date.fromisoformat['20191204']
datetime.date[2019, 12, 4]
>>> date.fromisoformat['2021-W01-1']
datetime.date[2021, 1, 4]
40 và >>> from datetime import date
>>> date.fromisoformat['2019-12-04']
datetime.date[2019, 12, 4]
>>> date.fromisoformat['20191204']
datetime.date[2019, 12, 4]
>>> date.fromisoformat['2021-W01-1']
datetime.date[2021, 1, 4]
41
Sau đây là danh sách tất cả các mã định dạng mà tiêu chuẩn C 1989 yêu cầu và chúng hoạt động trên tất cả các nền tảng có triển khai C tiêu chuẩn
chỉ thị
Nghĩa
Thí dụ
ghi chú
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]61
Ngày trong tuần là tên viết tắt của ngôn ngữ
CN, Mon, …, Sat [en_US];
So, Mo, …, Sa [de_DE]
[1]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]62
Ngày trong tuần là tên đầy đủ của ngôn ngữ
Chủ Nhật, Thứ Hai, …, Thứ Bảy [en_US];
Sonntag, Montag, …, Samstag [de_DE]
[1]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]63
Ngày trong tuần dưới dạng số thập phân, trong đó 0 là Chủ nhật và 6 là Thứ bảy
0, 1, …, 6
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]64
Ngày trong tháng dưới dạng số thập phân không đệm
01, 02, …, 31
[9]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]65
Tháng là tên viết tắt của ngôn ngữ
Tháng 1, Tháng 2, …, Tháng 12 [en_US];
Tháng 1, Tháng 2, …, Dez [de_DE]
[1]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]66
Tháng là tên đầy đủ của ngôn ngữ
Tháng Giêng, Tháng Hai, …, Tháng Mười Hai [en_US];
Januar, Februar, …, Tháng mười hai [de_DE]
[1]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]67
Tháng dưới dạng số thập phân không đệm
01, 02, …, 12
[9]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]68
Năm không có thế kỷ dưới dạng số thập phân không đệm
00, 01, …, 99
[9]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]69
Năm với thế kỷ dưới dạng số thập phân
0001, 0002, …, 2013, 2014, …, 9998, 9999
[2]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]70
Giờ [đồng hồ 24 giờ] dưới dạng số thập phân không đệm
00, 01, …, 23
[9]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]71
Giờ [đồng hồ 12 giờ] dưới dạng số thập phân không đệm
01, 02, …, 12
[9]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]72
Ngôn ngữ tương đương với AM hoặc PM
AM, PM [en_US];
sáng, chiều [de_DE]
[1], [3]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]73
Phút dưới dạng số thập phân không đệm
00, 01, …, 59
[9]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]74
Thứ hai dưới dạng số thập phân không đệm
00, 01, …, 59
[4], [9]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]75
Micro giây dưới dạng số thập phân, được đệm bằng 0 thành 6 chữ số
000000, 000001, …, 999999
[5]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]76
Phần bù UTC ở dạng
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]77 [chuỗi trống nếu đối tượng là ngây thơ]
[trống], +0000, -0400, +1030, +063415, -030712. 345216
[6]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]78
Tên múi giờ [chuỗi trống nếu đối tượng ngây thơ]
[trống], UTC, GMT
[6]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]79
Ngày trong năm dưới dạng số thập phân không đệm
001, 002, …, 366
[9]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]80
Số tuần của năm [Chủ nhật là ngày đầu tiên của tuần] dưới dạng số thập phân không đệm. Tất cả các ngày trong một năm mới trước Chủ nhật đầu tiên được coi là trong tuần 0
00, 01, …, 53
[7], [9]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]81
Số tuần của năm [Thứ Hai là ngày đầu tiên của tuần] dưới dạng số thập phân không đệm. Tất cả các ngày trong năm mới trước ngày thứ Hai đầu tiên được coi là trong tuần 0
00, 01, …, 53
[7], [9]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]82
Đại diện ngày và giờ thích hợp của ngôn ngữ
Thứ ba 16 tháng 8 21. 30. 00 1988 [vi_Hoa Kỳ];
Di 16 Thg8 21. 30. 00 1988 [de_DE]
[1]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]83
Đại diện ngày thích hợp của địa phương
16/08/88 [Không có];
16/08/1988 [en_US];
16. 08. 1988 [de_DE]
[1]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]84
Đại diện thời gian thích hợp của địa phương
21. 30. 00 [vi_US];
21. 30. 00 [de_DE]
[1]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]85
Một ký tự
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]86 theo nghĩa đen
%
Một số chỉ thị bổ sung không bắt buộc theo tiêu chuẩn C89 được bao gồm để thuận tiện. Tất cả các tham số này đều tương ứng với các giá trị ngày theo tiêu chuẩn ISO 8601
chỉ thị
Nghĩa
Thí dụ
ghi chú
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]87
Năm ISO 8601 với thế kỷ đại diện cho năm chứa phần lớn tuần ISO [
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]88]
0001, 0002, …, 2013, 2014, …, 9998, 9999
[số 8]
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]89
ISO 8601 ngày trong tuần dưới dạng số thập phân trong đó 1 là Thứ Hai
1, 2, …, 7
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]88
ISO 8601 tuần dưới dạng số thập phân với Thứ Hai là ngày đầu tuần. Tuần 01 là tuần có ngày 04/01
01, 02, …, 53
[8], [9]
Những thứ này có thể không khả dụng trên tất cả các nền tảng khi được sử dụng với phương pháp
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]40. Chỉ thị năm và tuần ISO 8601 không thể hoán đổi cho nhau với chỉ thị số năm và tuần ở trên. Calling
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]41 with incomplete or ambiguous ISO 8601 directives will raise a
Bộ mã định dạng đầy đủ được hỗ trợ khác nhau giữa các nền tảng, bởi vì Python gọi hàm
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]40 của thư viện C và các biến thể nền tảng là phổ biến. To see the full set of format codes supported on your platform, consult the strftime[3] documentation. There are also differences between platforms in handling of unsupported format specifiers
New in version 3. 6.
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]87,
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]89 and
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]88 were added.
Technical Detail
Broadly speaking,
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]98 acts like the module’s
>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]00 although not all objects support a
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]42 method
For the class method, the default value is
>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]03. any components not specified in the format string will be pulled from the default value.
Using
>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]04 is equivalent to
>>> from datetime import timedelta >>> d = timedelta[microseconds=-1] >>> [d.days, d.seconds, d.microseconds] [-1, 86399, 999999]1
except when the format includes sub-second components or timezone offset information, which are supported in
>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]05 but are discarded by
>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]06
For objects, the format codes for year, month, and day should not be used, as objects have no such values. If they’re used anyway,
>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]09 is substituted for the year, and
>>> # Components of another_year add up to exactly 365 days >>> from datetime import timedelta >>> year = timedelta[days=365] >>> another_year = timedelta[weeks=40, days=84, hours=23, .. minutes=50, seconds=600] >>> year == another_year True >>> year.total_seconds[] 31536000.05 for the month and day
For objects, the format codes for hours, minutes, seconds, and microseconds should not be used, as objects have no such values. If they’re used anyway,
>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]14 is substituted for them
For the same reason, handling of format strings containing Unicode code points that can’t be represented in the charset of the current locale is also platform-dependent. On some platforms such code points are preserved intact in the output, while on others
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]50 may raise or return an empty string instead
ghi chú
Because the format depends on the current locale, care should be taken when making assumptions about the output value. Field orderings will vary [for example, “month/day/year” versus “day/month/year”], and the output may contain Unicode characters encoded using the locale’s default encoding [for example, if the current locale is
>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
16, the default encoding could be any one of>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
17,>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
18, or>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
19; use to determine the current locale’s encoding]The
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
41 method can parse years in the full [1, 9999] range, but years < 1000 must be zero-filled to 4-digit widthChanged in version 3. 2. In previous versions,
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
40 method was restricted to years >= 1900.Changed in version 3. 3. In version 3. 2,
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
40 method was restricted to years >= 1000.When used with the
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
41 method, the>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
72 directive only affects the output hour field if the>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
71 directive is used to parse the hourUnlike the module, the module does not support leap seconds
When used with the
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
41 method, the>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
75 directive accepts from one to six digits and zero pads on the right.>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
75 is an extension to the set of format characters in the C standard [but implemented separately in datetime objects, and therefore always available]For a naive object, the
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
76 and>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
78 format codes are replaced by empty stringsFor an aware object
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
76>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False
57 is transformed into a string of the form>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
77, where>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
67 is a 2-digit string giving the number of UTC offset hours,>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
38 is a 2-digit string giving the number of UTC offset minutes,>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
39 is a 2-digit string giving the number of UTC offset seconds and>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
40 is a 6-digit string giving the number of UTC offset microseconds. The>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
40 part is omitted when the offset is a whole number of seconds and both the>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
40 and the>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
39 part is omitted when the offset is a whole number of minutes. Ví dụ: nếu>>> from datetime import timedelta >>> delta1 = timedelta[seconds=57] >>> delta2 = timedelta[hours=25, seconds=2] >>> delta2 != delta1 True >>> delta2 == 5 False
57 trả về>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
45, thì>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
76 được thay thế bằng chuỗi>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
47Changed in version 3. 7. The UTC offset is not restricted to a whole number of minutes.
Changed in version 3. 7. When the
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
76 directive is provided to the>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
41 method, the UTC offsets can have a colon as a separator between hours, minutes and seconds. For example,>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
50 will be parsed as an offset of one hour. In addition, providing>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
51 is identical to>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
52.>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
78In
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
40,>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
78 is replaced by an empty string if>>> from datetime import timedelta >>> year = timedelta[days=365] >>> ten_years = 10 * year >>> ten_years datetime.timedelta[days=3650] >>> ten_years.days // 365 10 >>> nine_years = ten_years - year >>> nine_years datetime.timedelta[days=3285] >>> three_years = nine_years // 3 >>> three_years, three_years.days // 365 [datetime.timedelta[days=1095], 3]
65 returns>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
03; otherwise>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
78 is replaced by the returned value, which must be a string>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
41 only accepts certain values for>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
78any value in
>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
61 for your machine’s localethe hard-coded values
>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
62 and>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
63
So someone living in Japan may have
>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
64,>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
62, and>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
63 as valid values, but probably not>>> from datetime import date >>> d = date[2002, 12, 31] >>> d.replace[day=26] datetime.date[2002, 12, 26]
67. It will raise>>> from datetime import timedelta >>> delta = timedelta[ .. days=50, .. seconds=27, .. microseconds=10, .. milliseconds=29000, .. minutes=5, .. hours=8, .. weeks=2 .. ] >>> # Only days, seconds, and microseconds remain >>> delta datetime.timedelta[days=64, seconds=29156, microseconds=10]
93 for invalid valuesChanged in version 3. 2. Khi chỉ thị
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
76 được cung cấp cho phương thức>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
41, một đối tượng nhận biết sẽ được tạo ra.>>> delta2 > delta1 True >>> delta2 > 5 Traceback [most recent call last]: File "", line 1, in TypeError: '>' not supported between instances of 'datetime.timedelta' and 'int'
4 của kết quả sẽ được đặt thành một thể hiện.Khi được sử dụng với phương pháp
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
41,>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
80 và>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
81 chỉ được sử dụng trong các phép tính khi ngày trong tuần và năm dương lịch [>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
69] được chỉ địnhTương tự như
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
80 và>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
81,>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
88 chỉ được sử dụng trong tính toán khi ngày trong tuần và năm ISO [>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
87] được chỉ định trong chuỗi định dạng>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
41. Cũng lưu ý rằng>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
87 và>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
69 không thể hoán đổi cho nhauWhen used with the
>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
41 method, the leading zero is optional for formats>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
64,>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
67,>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
70,>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
71,>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
73,>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
74,>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
79,>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
80,>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
81, and>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
88. Định dạng>>> from datetime import date >>> date.fromisoformat['2019-12-04'] datetime.date[2019, 12, 4] >>> date.fromisoformat['20191204'] datetime.date[2019, 12, 4] >>> date.fromisoformat['2021-W01-1'] datetime.date[2021, 1, 4]
68 không yêu cầu số 0 đứng đầu
chú thích
Nghĩa là, nếu chúng ta bỏ qua các tác động của Thuyết tương đối
Đ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. Xem sách để biết các thuật toán chuyển đổi giữa các thứ tự Gregorian proleptic và nhiều hệ thống lịch khác