Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
Whenever
Whenever

Background

  • The fundamentals of time
    • Exact time vs local time
    • Timezones
    • Ambiguity
    • Arithmetic
  • The pitfalls of datetime
    • One type for everything
    • Operators ignore DST
    • Inconsistent role of “naive”
    • Ambiguity passes silently
    • Equality edge cases
    • timezone isn’t enough
    • Implicit system time zone
    • datetime inherits from date
    • timedelta.seconds footgun
  • Why not pendulum?

Overview

  • Guide
    • Choosing the right type
    • Comparison and equality
    • Converting between types
    • Ambiguity in timezones
    • Arithmetic
    • Working with deltas
    • Rounding
    • Formatting and parsing
    • Standard library conversions
    • Partial types
    • The system timezone
    • Testing
    • Handling warnings
  • Examples
  • Design philosophy
  • FAQ

API Reference

  • ISO 8601
  • Pattern format
  • Main types
    • Instant
    • ZonedDateTime
    • OffsetDateTime
    • PlainDateTime
  • Partial types
    • Date
    • Time
    • YearMonth
    • MonthDay
  • Delta types
    • TimeDelta
    • ItemizedDelta
    • ItemizedDateDelta
  • Miscellaneous
    • Other types
    • Exceptions and warnings
    • Deprecated components

Development

  • Changelog
  • Contributing
  • Github repository
Back to top
Copyright ©
Made with Sphinx and @pradyunsg's Furo