# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001 Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# python-doc bot, 2025

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.14\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-09-14 20:17+0000\n"

"PO-Revision-Date: 2025-09-16 00:01+0000\n"

"Last-Translator: python-doc bot, 2025\n"

"Language-Team: German (https://app.transifex.com/python-doc/teams/5390/de/)\n"

"Language: de\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=2; plural=(n != 1);\n"

#: ../../library/datetime.rst:2

msgid ":mod:`!datetime` --- Basic date and time types"

msgstr ""

#: ../../library/datetime.rst:7

msgid "**Source code:** :source:`Lib/datetime.py`"

msgstr ""

#: ../../library/datetime.rst:11

msgid ""

"The :mod:`!datetime` module supplies classes for manipulating dates and "

"times."

msgstr ""

#: ../../library/datetime.rst:13

msgid ""

"While date and time arithmetic is supported, the focus of the implementation "

"is on efficient attribute extraction for output formatting and manipulation."

msgstr ""

#: ../../library/datetime.rst:18

msgid "Skip to :ref:`the format codes <format-codes>`."

msgstr ""

#: ../../library/datetime.rst:22

msgid "Module :mod:`calendar`"

msgstr ""

#: ../../library/datetime.rst:23

msgid "General calendar related functions."

msgstr ""

#: ../../library/datetime.rst:25

msgid "Module :mod:`time`"

msgstr ""

#: ../../library/datetime.rst:26

msgid "Time access and conversions."

msgstr ""

#: ../../library/datetime.rst:28

msgid "Module :mod:`zoneinfo`"

msgstr ""

#: ../../library/datetime.rst:29

msgid "Concrete time zones representing the IANA time zone database."

msgstr ""

#: ../../library/datetime.rst:31

msgid "Package `dateutil <https://dateutil.readthedocs.io/en/stable/>`_"

msgstr ""

#: ../../library/datetime.rst:32

msgid "Third-party library with expanded time zone and parsing support."

msgstr ""

#: ../../library/datetime.rst:34

msgid "Package :pypi:`DateType`"

msgstr ""

#: ../../library/datetime.rst:35

msgid ""

"Third-party library that introduces distinct static types to for example, "

"allow :term:`static type checkers <static type checker>` to differentiate "

"between naive and aware datetimes."

msgstr ""

#: ../../library/datetime.rst:43

msgid "Aware and naive objects"

msgstr ""

#: ../../library/datetime.rst:45

msgid ""

"Date and time objects may be categorized as \"aware\" or \"naive\" depending "

"on whether or not they include time zone information."

msgstr ""

#: ../../library/datetime.rst:48

msgid ""

"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. [#]_"

msgstr ""

#: ../../library/datetime.rst:54

msgid ""

"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 time zone 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."

msgstr ""

#: ../../library/datetime.rst:61

msgid ""

"For applications requiring aware objects, :class:`.datetime` and :class:`."

"time` objects have an optional time zone information attribute, :attr:`!"

"tzinfo`, that can be set to an instance of a subclass of the abstract :class:"

"`!tzinfo` class. These :class:`tzinfo` objects capture information about the "

"offset from UTC time, the time zone name, and whether daylight saving time "

"is in effect."

msgstr ""

#: ../../library/datetime.rst:67

msgid ""

"Only one concrete :class:`tzinfo` class, the :class:`timezone` class, is "

"supplied by the :mod:`!datetime` module. The :class:`!timezone` class can "

"represent simple time zones with fixed offsets from UTC, such as UTC itself "

"or North American EST and EDT time zones. Supporting time zones 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."

msgstr ""

#: ../../library/datetime.rst:77

msgid "Constants"

msgstr ""

#: ../../library/datetime.rst:79

msgid "The :mod:`!datetime` module exports the following constants:"

msgstr ""

#: ../../library/datetime.rst:83

msgid ""

"The smallest year number allowed in a :class:`date` or :class:`.datetime` "

"object. :const:`MINYEAR` is 1."

msgstr ""

#: ../../library/datetime.rst:89

msgid ""

"The largest year number allowed in a :class:`date` or :class:`.datetime` "

"object. :const:`MAXYEAR` is 9999."

msgstr ""

#: ../../library/datetime.rst:95

msgid "Alias for the UTC time zone singleton :attr:`datetime.timezone.utc`."

msgstr ""

#: ../../library/datetime.rst:101

msgid "Available types"

msgstr ""

#: ../../library/datetime.rst:106

msgid ""

"An idealized naive date, assuming the current Gregorian calendar always was, "

"and always will be, in effect. Attributes: :attr:`year`, :attr:`month`, and :"

"attr:`day`."

msgstr ""

#: ../../library/datetime.rst:114

msgid ""

"An 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: :attr:`hour`, :attr:`minute`, :attr:`second`, :"

"attr:`microsecond`, and :attr:`.tzinfo`."

msgstr ""

#: ../../library/datetime.rst:123

msgid ""

"A combination of a date and a time. Attributes: :attr:`year`, :attr:"

"`month`, :attr:`day`, :attr:`hour`, :attr:`minute`, :attr:`second`, :attr:"

"`microsecond`, and :attr:`.tzinfo`."

msgstr ""

#: ../../library/datetime.rst:131

msgid ""

"A duration expressing the difference between two :class:`.datetime` or :"

"class:`date` instances to microsecond resolution."

msgstr ""

#: ../../library/datetime.rst:138

msgid ""

"An abstract base class for time zone information objects. These are used by "

"the :class:`.datetime` and :class:`.time` classes to provide a customizable "

"notion of time adjustment (for example, to account for time zone and/or "

"daylight saving time)."

msgstr ""

#: ../../library/datetime.rst:147

msgid ""

"A class that implements the :class:`tzinfo` abstract base class as a fixed "

"offset from the UTC."

msgstr ""

#: ../../library/datetime.rst:153 ../../library/datetime.rst:170

msgid "Objects of these types are immutable."

msgstr ""

#: ../../library/datetime.rst:155

msgid "Subclass relationships:"

msgstr ""

#: ../../library/datetime.rst:157

msgid ""

"timedelta, tzinfo, time, and date inherit from object; timezone inherits\n"

"from tzinfo; and datetime inherits from date."

msgstr ""

#: ../../library/datetime.rst:165

msgid "Common properties"

msgstr ""

#: ../../library/datetime.rst:167

msgid ""

"The :class:`date`, :class:`.datetime`, :class:`.time`, and :class:`timezone` "

"types share these common features:"

msgstr ""

#: ../../library/datetime.rst:171

msgid ""

"Objects of these types are :term:`hashable`, meaning that they can be used "

"as dictionary keys."

msgstr ""

#: ../../library/datetime.rst:173

msgid ""

"Objects of these types support efficient pickling via the :mod:`pickle` "

"module."

msgstr ""

#: ../../library/datetime.rst:177

msgid "Determining if an object is aware or naive"

msgstr ""

#: ../../library/datetime.rst:179

msgid "Objects of the :class:`date` type are always naive."

msgstr ""

#: ../../library/datetime.rst:181

msgid ""

"An object of type :class:`.time` or :class:`.datetime` may be aware or naive."

msgstr ""

#: ../../library/datetime.rst:183

msgid ""

"A :class:`.datetime` object ``d`` is aware if both of the following hold:"

msgstr ""

#: ../../library/datetime.rst:185

msgid "``d.tzinfo`` is not ``None``"

msgstr ""

#: ../../library/datetime.rst:186

msgid "``d.tzinfo.utcoffset(d)`` does not return ``None``"

msgstr ""

#: ../../library/datetime.rst:188

msgid "Otherwise, ``d`` is naive."

msgstr ""

#: ../../library/datetime.rst:190

msgid "A :class:`.time` object ``t`` is aware if both of the following hold:"

msgstr ""

#: ../../library/datetime.rst:192

msgid "``t.tzinfo`` is not ``None``"

msgstr ""

#: ../../library/datetime.rst:193

msgid "``t.tzinfo.utcoffset(None)`` does not return ``None``."

msgstr ""

#: ../../library/datetime.rst:195

msgid "Otherwise, ``t`` is naive."

msgstr ""

#: ../../library/datetime.rst:197

msgid ""

"The distinction between aware and naive doesn't apply to :class:`timedelta` "

"objects."

msgstr ""

#: ../../library/datetime.rst:204

msgid ":class:`!timedelta` objects"

msgstr ""

#: ../../library/datetime.rst:206

msgid ""

"A :class:`timedelta` object represents a duration, the difference between "

"two :class:`.datetime` or :class:`date` instances."

msgstr ""

#: ../../library/datetime.rst:211

msgid ""

"All arguments are optional and default to 0. Arguments may be integers or "

"floats, and may be positive or negative."

msgstr ""

#: ../../library/datetime.rst:214

msgid ""

"Only *days*, *seconds* and *microseconds* are stored internally. Arguments "

"are converted to those units:"

msgstr ""

#: ../../library/datetime.rst:217

msgid "A millisecond is converted to 1000 microseconds."

msgstr ""

#: ../../library/datetime.rst:218

msgid "A minute is converted to 60 seconds."

msgstr ""

#: ../../library/datetime.rst:219

msgid "An hour is converted to 3600 seconds."

msgstr ""

#: ../../library/datetime.rst:220

msgid "A week is converted to 7 days."

msgstr ""

#: ../../library/datetime.rst:222

msgid ""

"and days, seconds and microseconds are then normalized so that the "

"representation is unique, with"

msgstr ""

#: ../../library/datetime.rst:225

msgid "``0 <= microseconds < 1000000``"

msgstr ""

#: ../../library/datetime.rst:226

msgid "``0 <= seconds < 3600*24`` (the number of seconds in one day)"

msgstr ""

#: ../../library/datetime.rst:227

msgid "``-999999999 <= days <= 999999999``"

msgstr ""

#: ../../library/datetime.rst:229

msgid ""

"The following example illustrates how any arguments besides *days*, "

"*seconds* and *microseconds* are \"merged\" and normalized into those three "

"resulting attributes::"

msgstr ""

#: ../../library/datetime.rst:233

msgid ""

">>> import datetime as dt\n"

">>> delta = dt.timedelta(\n"

"... days=50,\n"

"... seconds=27,\n"

"... microseconds=10,\n"

"... milliseconds=29000,\n"

"... minutes=5,\n"

"... hours=8,\n"

"... weeks=2\n"

"... )\n"

">>> # Only days, seconds, and microseconds remain\n"

">>> delta\n"

"datetime.timedelta(days=64, seconds=29156, microseconds=10)"

msgstr ""

#: ../../library/datetime.rst:248

msgid ""

"``import datetime as dt`` instead of ``import datetime`` or ``from datetime "

"import datetime`` to avoid confusion between the module and the class. See "

"`How I Import Python’s datetime Module <https://adamj.eu/tech/2019/09/12/how-"

"i-import-pythons-datetime-module/>`__."

msgstr ""

#: ../../library/datetime.rst:253

msgid ""

"If any argument is a float and there are fractional microseconds, the "

"fractional microseconds left over from all arguments are combined and their "

"sum is rounded to the nearest microsecond using round-half-to-even "

"tiebreaker. If no argument is a float, the conversion and normalization "

"processes are exact (no information is lost)."

msgstr ""

#: ../../library/datetime.rst:260

msgid ""

"If the normalized value of days lies outside the indicated range, :exc:"

"`OverflowError` is raised."

msgstr ""

#: ../../library/datetime.rst:263

msgid ""

"Note that normalization of negative values may be surprising at first. For "

"example::"

msgstr ""

#: ../../library/datetime.rst:266

msgid ""

">>> import datetime as dt\n"

">>> d = dt.timedelta(microseconds=-1)\n"

">>> (d.days, d.seconds, d.microseconds)\n"

"(-1, 86399, 999999)"

msgstr ""

#: ../../library/datetime.rst:271

msgid ""

"Since the string representation of :class:`!timedelta` objects can be "

"confusing, use the following recipe to produce a more readable format:"

msgstr ""

#: ../../library/datetime.rst:274

msgid ""

">>> def pretty_timedelta(td):\n"

"... if td.days >= 0:\n"

"... return str(td)\n"

"... return f'-({-td!s})'\n"

"...\n"

">>> d = timedelta(hours=-1)\n"

">>> str(d) # not human-friendly\n"

"'-1 day, 23:00:00'\n"

">>> pretty_timedelta(d)\n"

"'-(1:00:00)'"

msgstr ""

#: ../../library/datetime.rst:288 ../../library/datetime.rst:628

#: ../../library/datetime.rst:1201 ../../library/datetime.rst:1850

#: ../../library/datetime.rst:2486

msgid "Class attributes:"

msgstr ""

#: ../../library/datetime.rst:292

msgid "The most negative :class:`timedelta` object, ``timedelta(-999999999)``."

msgstr ""

#: ../../library/datetime.rst:297

msgid ""

"The most positive :class:`timedelta` object, ``timedelta(days=999999999, "

"hours=23, minutes=59, seconds=59, microseconds=999999)``."

msgstr ""

#: ../../library/datetime.rst:303

msgid ""

"The smallest possible difference between non-equal :class:`timedelta` "

"objects, ``timedelta(microseconds=1)``."

msgstr ""

#: ../../library/datetime.rst:307

msgid ""

"Note that, because of normalization, ``timedelta.max`` is greater than ``-"

"timedelta.min``. ``-timedelta.max`` is not representable as a :class:"

"`timedelta` object."

msgstr ""

#: ../../library/datetime.rst:311 ../../library/datetime.rst:646

#: ../../library/datetime.rst:1221 ../../library/datetime.rst:1870

msgid "Instance attributes (read-only):"

msgstr ""

#: ../../library/datetime.rst:315

msgid "Between -999,999,999 and 999,999,999 inclusive."

msgstr ""

#: ../../library/datetime.rst:320

msgid "Between 0 and 86,399 inclusive."

msgstr ""

#: ../../library/datetime.rst:324

msgid ""

"It is a somewhat common bug for code to unintentionally use this attribute "

"when it is actually intended to get a :meth:`~timedelta.total_seconds` value "

"instead:"

msgstr ""

#: ../../library/datetime.rst:328

msgid ""

">>> import datetime as dt\n"

">>> duration = dt.timedelta(seconds=11235813)\n"

">>> duration.days, duration.seconds\n"

"(130, 3813)\n"

">>> duration.total_seconds()\n"

"11235813.0"

msgstr ""

#: ../../library/datetime.rst:340

msgid "Between 0 and 999,999 inclusive."

msgstr ""

#: ../../library/datetime.rst:343 ../../library/datetime.rst:663

#: ../../library/datetime.rst:1275

msgid "Supported operations:"

msgstr ""

#: ../../library/datetime.rst:346 ../../library/datetime.rst:666

#: ../../library/datetime.rst:1278

msgid "Operation"

msgstr ""

#: ../../library/datetime.rst:346 ../../library/datetime.rst:666

#: ../../library/datetime.rst:1278

msgid "Result"

msgstr ""

#: ../../library/datetime.rst:348

msgid "``t1 = t2 + t3``"

msgstr ""

#: ../../library/datetime.rst:348

msgid ""

"Sum of ``t2`` and ``t3``. Afterwards ``t1 - t2 == t3`` and ``t1 - t3 == t2`` "

"are true. (1)"

msgstr ""

#: ../../library/datetime.rst:352

msgid "``t1 = t2 - t3``"

msgstr ""

#: ../../library/datetime.rst:352

msgid ""

"Difference of ``t2`` and ``t3``. Afterwards ``t1 == t2 - t3`` and ``t2 == "

"t1 + t3`` are true. (1)(6)"

msgstr ""

#: ../../library/datetime.rst:356

msgid "``t1 = t2 * i or t1 = i * t2``"

msgstr ""

#: ../../library/datetime.rst:356

msgid ""

"Delta multiplied by an integer. Afterwards ``t1 // i == t2`` is true, "

"provided ``i != 0``."

msgstr ""

#: ../../library/datetime.rst:360

msgid "In general, ``t1 * i == t1 * (i-1) + t1`` is true. (1)"

msgstr ""

#: ../../library/datetime.rst:363

msgid "``t1 = t2 * f or t1 = f * t2``"

msgstr ""

#: ../../library/datetime.rst:363

msgid ""

"Delta multiplied by a float. The result is rounded to the nearest multiple "

"of timedelta.resolution using round-half-to-even."

msgstr ""

#: ../../library/datetime.rst:367

msgid "``f = t2 / t3``"

msgstr ""

#: ../../library/datetime.rst:367

msgid ""

"Division (3) of overall duration ``t2`` by interval unit ``t3``. Returns a :"

"class:`float` object."

msgstr ""

#: ../../library/datetime.rst:371

msgid "``t1 = t2 / f or t1 = t2 / i``"

msgstr ""

#: ../../library/datetime.rst:371

msgid ""

"Delta divided by a float or an int. The result is rounded to the nearest "

"multiple of timedelta.resolution using round-half-to-even."

msgstr ""

#: ../../library/datetime.rst:375

msgid "``t1 = t2 // i`` or ``t1 = t2 // t3``"

msgstr ""

#: ../../library/datetime.rst:375

msgid ""

"The floor is computed and the remainder (if any) is thrown away. In the "

"second case, an integer is returned. (3)"

msgstr ""

#: ../../library/datetime.rst:379

msgid "``t1 = t2 % t3``"

msgstr ""

#: ../../library/datetime.rst:379

msgid "The remainder is computed as a :class:`timedelta` object. (3)"

msgstr ""

#: ../../library/datetime.rst:382

msgid "``q, r = divmod(t1, t2)``"

msgstr ""

#: ../../library/datetime.rst:382

msgid ""

"Computes the quotient and the remainder: ``q = t1 // t2`` (3) and ``r = t1 % "

"t2``. ``q`` is an integer and ``r`` is a :class:`timedelta` object."

msgstr ""

#: ../../library/datetime.rst:387

msgid "``+t1``"

msgstr ""

#: ../../library/datetime.rst:387

msgid "Returns a :class:`timedelta` object with the same value. (2)"

msgstr ""

#: ../../library/datetime.rst:390

msgid "``-t1``"

msgstr ""

#: ../../library/datetime.rst:390

msgid ""

"Equivalent to ``timedelta(-t1.days, -t1.seconds, -t1.microseconds)``, and to "

"``t1 * -1``. (1)(4)"

msgstr ""

#: ../../library/datetime.rst:394

msgid "``abs(t)``"

msgstr ""

#: ../../library/datetime.rst:394

msgid ""

"Equivalent to ``+t`` when ``t.days >= 0``, and to ``-t`` when ``t.days < "

"0``. (2)"

msgstr ""

#: ../../library/datetime.rst:397

msgid "``str(t)``"

msgstr ""

#: ../../library/datetime.rst:397

msgid ""

"Returns a string in the form ``[D day[s], ][H]H:MM:SS[.UUUUUU]``, where D is "

"negative for negative ``t``. (5)"

msgstr ""

#: ../../library/datetime.rst:401

msgid "``repr(t)``"

msgstr ""

#: ../../library/datetime.rst:401

msgid ""

"Returns a string representation of the :class:`timedelta` object as a "

"constructor call with canonical attribute values."

msgstr ""

#: ../../library/datetime.rst:406 ../../library/datetime.rst:685

#: ../../library/datetime.rst:2796

msgid "Notes:"

msgstr ""

#: ../../library/datetime.rst:409

msgid "This is exact but may overflow."

msgstr ""

#: ../../library/datetime.rst:412

msgid "This is exact and cannot overflow."

msgstr ""

#: ../../library/datetime.rst:415

msgid "Division by zero raises :exc:`ZeroDivisionError`."

msgstr ""

#: ../../library/datetime.rst:418

msgid "``-timedelta.max`` is not representable as a :class:`timedelta` object."

msgstr ""

#: ../../library/datetime.rst:421

msgid ""

"String representations of :class:`timedelta` objects are normalized "

"similarly to their internal representation. This leads to somewhat unusual "

"results for negative timedeltas. For example::"

msgstr ""

#: ../../library/datetime.rst:425

msgid ""

">>> timedelta(hours=-5)\n"

"datetime.timedelta(days=-1, seconds=68400)\n"

">>> print(_)\n"

"-1 day, 19:00:00"

msgstr ""

#: ../../library/datetime.rst:431

msgid ""

"The expression ``t2 - t3`` will always be equal to the expression ``t2 + (-"

"t3)`` except when t3 is equal to ``timedelta.max``; in that case the former "

"will produce a result while the latter will overflow."

msgstr ""

#: ../../library/datetime.rst:435

msgid ""

"In addition to the operations listed above, :class:`timedelta` objects "

"support certain additions and subtractions with :class:`date` and :class:`."

"datetime` objects (see below)."

msgstr ""

#: ../../library/datetime.rst:439

msgid ""

"Floor division and true division of a :class:`timedelta` object by another :"

"class:`!timedelta` object are now supported, as are remainder operations and "

"the :func:`divmod` function. True division and multiplication of a :class:`!"

"timedelta` object by a :class:`float` object are now supported."

msgstr ""

#: ../../library/datetime.rst:445

msgid ":class:`timedelta` objects support equality and order comparisons."

msgstr ""

#: ../../library/datetime.rst:447

msgid ""

"In Boolean contexts, a :class:`timedelta` object is considered to be true if "

"and only if it isn't equal to ``timedelta(0)``."

msgstr ""

#: ../../library/datetime.rst:450 ../../library/datetime.rst:727

#: ../../library/datetime.rst:1366 ../../library/datetime.rst:1995

msgid "Instance methods:"

msgstr ""

#: ../../library/datetime.rst:454

msgid ""

"Return the total number of seconds contained in the duration. Equivalent to "

"``td / timedelta(seconds=1)``. For interval units other than seconds, use "

"the division form directly (for example, ``td / timedelta(microseconds=1)``)."

msgstr ""

#: ../../library/datetime.rst:458

msgid ""

"Note that for very large time intervals (greater than 270 years on most "

"platforms) this method will lose microsecond accuracy."

msgstr ""

#: ../../library/datetime.rst:465

msgid "Examples of usage: :class:`!timedelta`"

msgstr ""

#: ../../library/datetime.rst:467

msgid "An additional example of normalization::"

msgstr ""

#: ../../library/datetime.rst:469

msgid ""

">>> # Components of another_year add up to exactly 365 days\n"

">>> import datetime as dt\n"

">>> year = dt.timedelta(days=365)\n"

">>> another_year = dt.timedelta(weeks=40, days=84, hours=23,\n"

"... minutes=50, seconds=600)\n"

">>> year == another_year\n"

"True\n"

">>> year.total_seconds()\n"

"31536000.0"

msgstr ""

#: ../../library/datetime.rst:479

msgid "Examples of :class:`timedelta` arithmetic::"

msgstr ""

#: ../../library/datetime.rst:481

msgid ""

">>> import datetime as dt\n"

">>> year = dt.timedelta(days=365)\n"

">>> ten_years = 10 * year\n"

">>> ten_years\n"

"datetime.timedelta(days=3650)\n"

">>> ten_years.days // 365\n"

"10\n"

">>> nine_years = ten_years - year\n"

">>> nine_years\n"

"datetime.timedelta(days=3285)\n"

">>> three_years = nine_years // 3\n"

">>> three_years, three_years.days // 365\n"

"(datetime.timedelta(days=1095), 3)"

msgstr ""

#: ../../library/datetime.rst:499

msgid ":class:`!date` objects"

msgstr ""

#: ../../library/datetime.rst:501

msgid ""

"A :class:`date` object represents a date (year, month and day) in an "

"idealized calendar, the current Gregorian calendar indefinitely extended in "

"both directions."

msgstr ""

#: ../../library/datetime.rst:505

msgid ""

"January 1 of year 1 is called day number 1, January 2 of year 1 is called "

"day number 2, and so on. [#]_"

msgstr ""

#: ../../library/datetime.rst:510

msgid ""

"All arguments are required. Arguments must be integers, in the following "

"ranges:"

msgstr ""

#: ../../library/datetime.rst:513

msgid "``MINYEAR <= year <= MAXYEAR``"

msgstr ""

#: ../../library/datetime.rst:514

msgid "``1 <= month <= 12``"

msgstr ""

#: ../../library/datetime.rst:515

msgid "``1 <= day <= number of days in the given month and year``"

msgstr ""

#: ../../library/datetime.rst:517 ../../library/datetime.rst:948

msgid ""

"If an argument outside those ranges is given, :exc:`ValueError` is raised."

msgstr ""

#: ../../library/datetime.rst:520 ../../library/datetime.rst:954

msgid "Other constructors, all class methods:"

msgstr ""

#: ../../library/datetime.rst:524

msgid "Return the current local date."

msgstr ""

#: ../../library/datetime.rst:526

msgid "This is equivalent to ``date.fromtimestamp(time.time())``."

msgstr ""

#: ../../library/datetime.rst:531

msgid ""

"Return the local date corresponding to the POSIX *timestamp*, such as is "

"returned by :func:`time.time`."

msgstr ""

#: ../../library/datetime.rst:534

msgid ""

"This may raise :exc:`OverflowError`, if the timestamp is out of the range of "

"values supported by the platform C :c:func:`localtime` function, and :exc:"

"`OSError` on :c:func:`localtime` failure. It's common for this to be "

"restricted to years from 1970 through 2038. Note that on non-POSIX systems "

"that include leap seconds in their notion of a timestamp, leap seconds are "

"ignored by :meth:`fromtimestamp`."

msgstr ""

#: ../../library/datetime.rst:541

msgid ""

"Raise :exc:`OverflowError` instead of :exc:`ValueError` if the timestamp is "

"out of the range of values supported by the platform C :c:func:`localtime` "

"function. Raise :exc:`OSError` instead of :exc:`ValueError` on :c:func:"

"`localtime` failure."

msgstr ""

#: ../../library/datetime.rst:547 ../../library/datetime.rst:1042

#: ../../library/datetime.rst:1082

msgid "Accepts any real number as *timestamp*, not only integer or float."

msgstr ""

#: ../../library/datetime.rst:553

msgid ""

"Return the date corresponding to the proleptic Gregorian *ordinal*, where "

"January 1 of year 1 has ordinal 1."

msgstr ""

#: ../../library/datetime.rst:556

msgid ""

":exc:`ValueError` is raised unless ``1 <= ordinal <= date.max.toordinal()``. "

"For any date ``d``, ``date.fromordinal(d.toordinal()) == d``."

msgstr ""

#: ../../library/datetime.rst:563

msgid ""

"Return a :class:`date` corresponding to a *date_string* given in any valid "

"ISO 8601 format, with the following exceptions:"

msgstr ""

#: ../../library/datetime.rst:566 ../../library/datetime.rst:1123

msgid ""

"Reduced precision dates are not currently supported (``YYYY-MM``, ``YYYY``)."

msgstr ""

#: ../../library/datetime.rst:568 ../../library/datetime.rst:1125

msgid ""

"Extended date representations are not currently supported (``±YYYYYY-MM-"

"DD``)."

msgstr ""

#: ../../library/datetime.rst:570 ../../library/datetime.rst:1127

msgid "Ordinal dates are not currently supported (``YYYY-OOO``)."

msgstr ""

#: ../../library/datetime.rst:572 ../../library/datetime.rst:1129

#: ../../library/datetime.rst:1604

msgid "Examples::"

msgstr ""

#: ../../library/datetime.rst:574

msgid ""

">>> import datetime as dt\n"

">>> dt.date.fromisoformat('2019-12-04')\n"

"datetime.date(2019, 12, 4)\n"

">>> dt.date.fromisoformat('20191204')\n"

"datetime.date(2019, 12, 4)\n"

">>> dt.date.fromisoformat('2021-W01-1')\n"

"datetime.date(2021, 1, 4)"

msgstr ""

#: ../../library/datetime.rst:583

msgid "Previously, this method only supported the format ``YYYY-MM-DD``."

msgstr ""

#: ../../library/datetime.rst:589

msgid ""

"Return a :class:`date` corresponding to the ISO calendar date specified by "

"*year*, *week* and *day*. This is the inverse of the function :meth:`date."

"isocalendar`."

msgstr ""

#: ../../library/datetime.rst:597

msgid ""

"Return a :class:`.date` corresponding to *date_string*, parsed according to "

"*format*. This is equivalent to::"

msgstr ""

#: ../../library/datetime.rst:600

msgid "date(*(time.strptime(date_string, format)[0:3]))"

msgstr ""

#: ../../library/datetime.rst:602

msgid ""

":exc:`ValueError` is raised if the date_string and format can't be parsed "

"by :func:`time.strptime` or if it returns a value which isn't a time tuple. "

"See also :ref:`strftime-strptime-behavior` and :meth:`date.fromisoformat`."

msgstr ""

#: ../../library/datetime.rst:609 ../../library/datetime.rst:1184

msgid ""

"If *format* specifies a day of month (``%d``) without a year, :exc:"

"`ValueError` is raised. This is to avoid a quadrennial leap year bug in "

"code seeking to parse only a month and day as the default year used in "

"absence of one in the format is not a leap year. The workaround is to always "

"include a year in your *format*. If parsing *date_string* values that do "

"not have a year, explicitly add a year that is a leap year before parsing:"

msgstr ""

#: ../../library/datetime.rst:617

msgid ""

">>> import datetime as dt\n"

">>> date_string = \"02/29\"\n"

">>> when = dt.date.strptime(f\"{date_string};1984\", \"%m/%d;%Y\") # Avoids "

"leap year bug.\n"

">>> when.strftime(\"%B %d\")\n"

"'February 29'"

msgstr ""

#: ../../library/datetime.rst:632

msgid "The earliest representable date, ``date(MINYEAR, 1, 1)``."

msgstr ""

#: ../../library/datetime.rst:637

msgid "The latest representable date, ``date(MAXYEAR, 12, 31)``."

msgstr ""

#: ../../library/datetime.rst:642

msgid ""

"The smallest possible difference between non-equal date objects, "

"``timedelta(days=1)``."

msgstr ""

#: ../../library/datetime.rst:650 ../../library/datetime.rst:1225

msgid "Between :const:`MINYEAR` and :const:`MAXYEAR` inclusive."

msgstr ""

#: ../../library/datetime.rst:655 ../../library/datetime.rst:1230

msgid "Between 1 and 12 inclusive."

msgstr ""

#: ../../library/datetime.rst:660 ../../library/datetime.rst:1235

msgid "Between 1 and the number of days in the given month of the given year."

msgstr ""

#: ../../library/datetime.rst:668

msgid "``date2 = date1 + timedelta``"

msgstr ""

#: ../../library/datetime.rst:668

msgid "``date2`` will be ``timedelta.days`` days after ``date1``. (1)"

msgstr ""

#: ../../library/datetime.rst:671

msgid "``date2 = date1 - timedelta``"

msgstr ""

#: ../../library/datetime.rst:671

msgid "Computes ``date2`` such that ``date2 + timedelta == date1``. (2)"